| 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)
| May 2026 | e5ac02a |