.TH "DOVEADM-INDEXER" "1" "May 2026" "e5ac02a" "Dovecot"
.SH "نام (NAME)"
doveadm-indexer \- دستورات مربوط به مدیریت پردازش نمایه‌ساز (indexer)
.SH "خلاصه دستور (SYNOPSIS)"
.P
\fBdoveadm\fR \[lB]\fIگزینه‌های سراسری\fR\[rB] \fBindexer\fR \fIدستور\fR \[lB]\fIگزینه‌ها\fR\[rB] \[lB]\fIآرگومان‌ها\fR\[rB]
.SH "توضیحات (DESCRIPTION)"
.P
دستور \fBdoveadm indexer\fR می‌تواند برای مدیریت پردازش نمایه‌ساز (indexer) استفاده شود.
.SH "گزینه‌های سراسری (GLOBAL OPTIONS)"
.P
\fIگزینه‌های\fR سراسری doveadm(1):
.P
\fB-D\fR
.RS 0
.RS 4
.P
پیام‌های باجزئیات (\fIverbosity\fR) و اشکال‌زدایی (debug) را فعال می‌کند.
.RE 0

.RE 0

.P
\fB-O\fR
.RS 0
.RS 4
.P
هیچ فایل پیکربندی‌ای را نمی‌خواند، فقط از مقادیر پیش‌فرض استفاده می‌کند. مقدار تنظیم \fBdovecot_storage_version\fR به‌طور پیش‌فرض آخرین نسخه است، اما می‌توان آن را با \fB-o\fR بازنویسی (override) کرد.
.RE 0

.RE 0

.P
\fB-k\fR
.RS 0
.RS 4
.P
تمام متغیرهای محیطی را برای doveadm حفظ می‌کند، نه فقط تنظیم \fBimport_environment\fR را.
.RE 0

.RE 0

.P
\fB-v\fR
.RS 0
.RS 4
.P
حالت پرحرفی (verbosity)، شامل شمارنده پیشرفت را فعال می‌کند.
.RE 0

.RE 0

.P
\fB-i\fR \fIinstance-name\fR
.RS 0
.RS 4
.P
در صورت استفاده از چند نمونه Dovecot، فایل پیکربندی را بر اساس این نام نمونه انتخاب می‌کند.
.P
برای اطلاعات بیشتر تنظیم \fBinstance_name\fR را ببینید.
.RE 0

.RE 0

.P
\fB-c\fR \fIconfig-file\fR
.RS 0
.RS 4
.P
پیکربندی را از \fIconfig-file\fR داده‌شده می‌خواند. به‌طور پیش‌فرض ابتدا سوکت پیکربندی را می‌خواند و سپس به \fI/etc/dovecot/dovecot.conf\fR بازمی‌گردد. همچنین می‌توانید این را به سوکت پیکربندی نمونه‌ای که نسخه سازگار را اجرا می‌کند هدایت کنید.
.RE 0

.RE 0

.P
\fB-o\fR \fIsetting\fR\fB=\fR\fIvalue\fR
.RS 0
.RS 4
.P
تنظیم پیکربندی \fIsetting\fR را از \fI/etc/dovecot/dovecot.conf\fR و از userdb با مقدار داده‌شده \fIvalue\fR بازنویسی می‌کند. برای بازنویسی چندین تنظیم، گزینه \fB-o\fR می‌تواند چندین بار مشخص شود.
.RE 0

.RE 0

.P
\fB-f\fR \fIformatter\fR
.RS 0
.RS 4
.P
قالب‌بند (\fIformatter\fR) را برای قالب‌بندی خروجی مشخص می‌کند. قالب‌بندهای پشتیبانی‌شده عبارتند از:
.P
\fBflow\fR
.RS 4
.P
هر خط را با جفت‌های \fIkey\fR\fB=\fR\fIvalue\fR چاپ می‌کند.
.RE 0

.P
\fBjson\fR
.RS 4
.P
یک آرایه JSON از اشیاء JSON چاپ می‌کند.
.RE 0

.P
\fBpager\fR
.RS 4
.P
هر جفت \fIkey\fR: \fIvalue\fR را در خط خودش چاپ می‌کند و رکوردها را با نویسه فرم‌فید (\fB^L\fR) جدا می‌سازد.
.RE 0

.P
\fBtab\fR
.RS 4
.P
یک هدر جدول و به دنبال آن خطوط مقادیر جدا شده با تب (tab-separated) چاپ می‌کند.
.RE 0

.P
\fBtable\fR
.RS 4
.P
یک هدر جدول و به دنبال آن خطوط مقادیر تراز شده را چاپ می‌کند.
.RE 0

.RE 0

.RE 0

.SH "دستورات (COMMANDS)"
.SS "indexer add"
.P
\fBdoveadm\fR \[lB]\fIگزینه‌های سراسری\fR\[rB] indexer add \[lB]\fB-h\fR\[rB] \[lB]\fB-n\fR \fImax_recent\fR\[rB] \fIuser\fR \fImailbox\fR
.P
درخواست نمایه‌سازی برای \fIuser\fR و \fImailbox\fR داده‌شده را به صف نمایه‌ساز اضافه می‌کند. این دستور همانند دستور \fBdoveadm index -q\fR عمل می‌کند.
.P
\fB-h\fR
.RS 0
.RS 4
.P
درخواست نمایه‌سازی را به ابتدای صف (head) اضافه می‌کند. به‌طور پیش‌فرض درخواست به انتهای صف (tail) اضافه می‌شود.
.RE 0

.RE 0

.P
\fB-n\fR \fImax_recent\fR
.RS 0
.RS 4
.P
یک مقدار عددی صحیح که حداکثر تعداد پیام‌های \[rs]Recent در صندوق‌های پستی را مشخص می‌کند. اگر صندوق پستی شامل پیام‌های بیشتری از \fImax_recent\fR با پرچم \[rs]Recent تنظیم‌شده باشد، صندوق پستی نمایه نخواهد شد. این گزینه ممکن است برای جلوگیری از نمایه‌سازی غیرضروری صندوق‌های پستی بزرگی که هرگز باز نمی‌شوند مفید باشد.
.RE 0

.RE 0

.SS "indexer remove"
.P
\fBdoveadm\fR \[lB]\fIگزینه‌های سراسری\fR\[rB] indexer remove \fIuser_mask\fR \[lB]\fImailbox_mask\fR\[rB]
.P
تمام درخواست‌های نمایه‌ساز مطابق با \fIuser_mask\fR (و \fImailbox_mask\fR) را حذف می‌کند. استفاده از نویسه‌های عمومی (wildcard) امکان‌پذیر است. درخواست‌هایی که در حال حاضر توسط indexer-worker پردازش می‌شوند فهرست نمی‌شوند؛ به جای آن برای اخراج آن‌ها از \fBdoveadm kick\fR استفاده کنید.
.SS "indexer list"
.P
\fBdoveadm\fR \[lB]\fIگزینه‌های سراسری\fR\[rB] indexer list \fIuser_mask\fR
.P
تمام درخواست‌های نمایه‌سازی در صف مطابق با \fIuser_mask\fR را فهرست می‌کند. امکان استفاده از نویسه‌های عمومی (wildcard) وجود دارد. درخواست‌هایی که در حال حاضر توسط indexer-worker پردازش می‌شوند فهرست نمی‌شوند؛ به جای آن برای مشاهده آن‌ها از \fBdoveadm who\fR استفاده کنید.
.SH "گزارش باگ‌ها (REPORTING BUGS)"
.P
گزارش باگ‌ها، از جمله خروجی \fIdoveconf -n\fR را به فهرست پستی Dovecot به نشانی \fI\(ladovecot@dovecot.org\(ra\fR ارسال کنید. اطلاعات بیشتر درباره گزارش باگ‌ها در نشانی زیر در دسترس است: \fI\(lahttps://dovecot.org/bugreport.html\(ra\fR
.SH "همچنین ببینید (SEE ALSO)"
.P
doveadm(1)