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

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

doveadm [گزینه‌های سراسری] indexer دستور [گزینه‌ها] [آرگومان‌ها]

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

گزینه‌های سراسری 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

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

doveadm [گزینه‌های سراسری] indexer add [-h] [-n max_recent] user mailbox

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

-h

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

-n max_recent

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

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

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

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

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

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

doveadm(1)

May 2026 e5ac02a