DOVEADM-INDEXER(1)                  Dovecot                 DOVEADM-INDEXER(1)

نام (NAME)
       doveadm-indexer - دستورات مربوط به مدیریت پردازش نمایه‌ساز (indexer)

خلاصه دستور (SYNOPSIS)
       doveadm [گزینه‌های سراسری] indexer دستور [گزینه‌ها] [آرگومان‌ها]

توضیحات (DESCRIPTION)
       دستور doveadm indexer می‌تواند برای مدیریت پردازش نمایه‌ساز (indexer)
       استفاده شود.

گزینه‌های سراسری (GLOBAL OPTIONS)
       گزینه‌های سراسری doveadm(1):

       -D

           پیام‌های باجزئیات (verbosity) و اشکال‌زدایی (debug) را فعال می‌کند.



       -O

           هیچ فایل پیکربندی‌ای را نمی‌خواند، فقط از مقادیر پیش‌فرض استفاده
           می‌کند. مقدار تنظیم dovecot_storage_version به‌طور پیش‌فرض آخرین نسخه
           است، اما می‌توان آن را با -o بازنویسی (override) کرد.



       -k

           تمام متغیرهای محیطی را برای doveadm حفظ می‌کند، نه فقط تنظیم
           import_environment را.



       -v

           حالت پرحرفی (verbosity)، شامل شمارنده پیشرفت را فعال می‌کند.



       -i instance-name

           در صورت استفاده از چند نمونه Dovecot، فایل پیکربندی را بر اساس این
           نام نمونه انتخاب می‌کند.

           برای اطلاعات بیشتر تنظیم instance_name را ببینید.



       -c config-file

           پیکربندی را از config-file داده‌شده می‌خواند. به‌طور پیش‌فرض ابتدا سوکت
           پیکربندی را می‌خواند و سپس به /etc/dovecot/dovecot.conf بازمی‌گردد.
           همچنین می‌توانید این را به سوکت پیکربندی نمونه‌ای که نسخه سازگار را
           اجرا می‌کند هدایت کنید.



       -o setting=value

           تنظیم پیکربندی setting را از /etc/dovecot/dovecot.conf و از userdb
           با مقدار داده‌شده value بازنویسی می‌کند. برای بازنویسی چندین تنظیم،
           گزینه -o می‌تواند چندین بار مشخص شود.



       -f formatter

           قالب‌بند (formatter) را برای قالب‌بندی خروجی مشخص می‌کند. قالب‌بندهای
           پشتیبانی‌شده عبارتند از:

           flow

               هر خط را با جفت‌های key=value چاپ می‌کند.


       json

           یک آرایه JSON از اشیاء JSON چاپ می‌کند.


       pager

           هر جفت key: value را در خط خودش چاپ می‌کند و رکوردها را با نویسه
           فرم‌فید (^L) جدا می‌سازد.


       tab

           یک هدر جدول و به دنبال آن خطوط مقادیر جدا شده با تب (tab-separated)
           چاپ می‌کند.


       table

           یک هدر جدول و به دنبال آن خطوط مقادیر تراز شده را چاپ می‌کند.




دستورات (COMMANDS)
   indexer add
       doveadm [گزینه‌های سراسری] indexer add [-h] [-n max_recent] user mailbox

       درخواست نمایه‌سازی برای user و mailbox داده‌شده را به صف نمایه‌ساز اضافه
       می‌کند. این دستور همانند دستور doveadm index -q عمل می‌کند.

       -h

           درخواست نمایه‌سازی را به ابتدای صف (head) اضافه می‌کند. به‌طور پیش‌فرض
           درخواست به انتهای صف (tail) اضافه می‌شود.



       -n max_recent

           یک مقدار عددی صحیح که حداکثر تعداد پیام‌های \Recent در صندوق‌های پستی
           را مشخص می‌کند. اگر صندوق پستی شامل پیام‌های بیشتری از max_recent با
           پرچم \Recent تنظیم‌شده باشد، صندوق پستی نمایه نخواهد شد. این گزینه
           ممکن است برای جلوگیری از نمایه‌سازی غیرضروری صندوق‌های پستی بزرگی که
           هرگز باز نمی‌شوند مفید باشد.



   indexer remove
       doveadm [گزینه‌های سراسری] indexer remove user_mask [mailbox_mask]

       تمام درخواست‌های نمایه‌ساز مطابق با user_mask (و mailbox_mask) را حذف
       می‌کند. استفاده از نویسه‌های عمومی (wildcard) امکان‌پذیر است. درخواست‌هایی
       که در حال حاضر توسط indexer-worker پردازش می‌شوند فهرست نمی‌شوند؛ به جای
       آن برای اخراج آن‌ها از doveadm kick استفاده کنید.

   indexer list
       doveadm [گزینه‌های سراسری] indexer list user_mask

       تمام درخواست‌های نمایه‌سازی در صف مطابق با user_mask را فهرست می‌کند.
       امکان استفاده از نویسه‌های عمومی (wildcard) وجود دارد. درخواست‌هایی که در
       حال حاضر توسط indexer-worker پردازش می‌شوند فهرست نمی‌شوند؛ به جای آن
       برای مشاهده آن‌ها از doveadm who استفاده کنید.

گزارش باگ‌ها (REPORTING BUGS)
       گزارش باگ‌ها، از جمله خروجی doveconf -n را به فهرست پستی Dovecot به
       نشانی ⟨dovecot@dovecot.org⟩ ارسال کنید. اطلاعات بیشتر درباره گزارش
       باگ‌ها در نشانی زیر در دسترس است: ⟨https://dovecot.org/bugreport.html⟩

همچنین ببینید (SEE ALSO)
       doveadm(1)

e5ac02a                            May 2026                 DOVEADM-INDEXER(1)