.TH "DOVEADM-INDEX" "1" "May 2026" "e5ac02a" "Dovecot"
.SH "نام (NAME)"
\fBdoveadm\-index\fR \- نمایه‌سازی صندوق‌های پستی
.SH "خلاصه دستور (SYNOPSIS)"
.P
\fBdoveadm\fR \[lB]\fIGLOBAL OPTIONS\fR\[rB] \fBindex\fR \[lB]\fB-S\fR \fIsocket_path\fR\[rB] \fB-A\fR \[lB]\fB-q\fR\[rB] \[lB]\fB-n\fR \fImax_recent\fR\[rB] \fImailbox\fR
.P
\fBdoveadm\fR \[lB]\fIGLOBAL OPTIONS\fR\[rB] \fBindex\fR \[lB]\fB-S\fR \fIsocket_path\fR\[rB] \fB-F\fR \fIfile\fR \[lB]\fB-q\fR\[rB] \[lB]\fB-n\fR \fImax_recent\fR\[rB] \fImailbox\fR
.P
\fBdoveadm\fR \[lB]\fIGLOBAL OPTIONS\fR\[rB] \fBindex\fR \[lB]\fB-S\fR \fIsocket_path\fR\[rB] \fB--no-userdb-lookup\fR \[lB]\fB-q\fR\[rB] \[lB]\fB-n\fR \fImax_recent\fR\[rB] \fImailbox\fR
.P
\fBdoveadm\fR \[lB]\fIGLOBAL OPTIONS\fR\[rB] \fBindex\fR \[lB]\fB-S\fR \fIsocket_path\fR\[rB] \fB-u\fR \fIuser\fR \[lB]\fB-q\fR\[rB] \[lB]\fB-n\fR \fImax_recent\fR\[rB] \fImailbox\fR
.SH "توضیحات (DESCRIPTION)"
.P
پیام‌های نمایه‌نشده در یک صندوق پستی را به فایل index/cache اضافه می‌کند. اگر جستجوی تمام‌متن (full text search) فعال باشد، پیام‌های نمایه‌نشده را به پایگاه داده fts نیز اضافه می‌کند.
.P
کَش کردن تنها فیلدهایی را اضافه می‌کند که قبلاً در تصمیمات کَش (caching decisions) صندوق پستی لحاظ شده بودند، بنابراین برای صندوق‌های پستی‌ای که کلاینت کاربر هنوز به آن‌ها دسترسی پیدا نکرده است، اقدام مفیدی انجام نخواهد داد. می‌توانید از دستور \fBdoveadm dump\fR برای نمایش تصمیمات کَش فعلی یک صندوق پستی مشخص استفاده کنید.
.P
پیام‌ها را می‌توان با استفاده از تنظیم زیر نیز به‌صورت خودکار به نمایهٔ جستجوی تمام‌متن اضافه کرد:
.P
.RS 2
.nf
fts_autoindex = yes
.fi
.RE
.SH "گزینه‌های عمومی (GLOBAL OPTIONS)"
.P
گزینه‌های عمومی doveadm(1):
.P
\fB-D\fR
.RS 0
.RS 4
.P
پیام‌های اشکال‌زدایی (debug) و پرگویی (\fIverbosity\fR) را فعال می‌کند.
.RE 0

.RE 0

.P
\fB-O\fR
.RS 0
.RS 4
.P
هیچ فایل پیکربندی‌ای را نمی‌خواند و صرفاً از مقادیر پیش‌فرض استفاده می‌کند. تنظیم \fBdovecot_storage_version\fR به‌طور پیش‌فرض روی جدیدترین نسخه قرار دارد، اما می‌توان آن را با \fB-o\fR بازنویسی کرد.
.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
در صورت استفاده از چندین نمونه (instance) از 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

.SH "گزینه‌ها (OPTIONS)"
.P
\fB-A\fR
.RS 0
.RS 4
.P
اگر گزینهٔ \fB-A\fR مشخص شود، دستور (\fIcommand\fR) برای همه کاربران اجرا خواهد شد. استفاده از این گزینه همراه با کاربران سیستمیِ \fBuserdb { driver = passwd }\fR توصیه نمی‌شود، زیرا شامل کاربرانی با UID کمتر از مقدار پیکربندی‌شده در تنظیم \fBfirst_valid_uid\fR نیز می‌شود.
.P
هنگامی که از ماژول SQL userdb استفاده می‌شود، اطمینان حاصل کنید که تنظیم \fBuserdb_sql_iterate_query\fR با طرح پایگاه داده شما مطابقت دارد.
.P
هنگام استفاده از ماژول LDAP userdb، اطمینان حاصل کنید که تنظیمات \fBuserdb_fields\fR و \fBuserdb_ldap_iterate_fields\fR با طرحوارهٔ (schema) LDAP شما مطابقت دارند؛ در غیر این صورت doveadm(1) قادر به پیمایش روی تمام کاربران نخواهد بود.
.RE 0

.RE 0

.P
\fB-F\fR \fIfile\fR
.RS 0
.RS 4
.P
دستور (\fIcommand\fR) را برای تمام کاربران موجود در \fIfile\fR اجرا می‌کند. این گزینه مشابه گزینهٔ \fB-A\fR است، اما به‌جای دریافت فهرست کاربران از userdb، آن‌ها از \fIfile\fR داده‌شده خوانده می‌شوند. \fIfile\fR در هر سطر شامل یک نام کاربری است.
.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

.P
\fB--no-userdb-lookup\fR
.RS 0
.RS 4
.P
جستجو در userdb را انجام نمی‌دهد. از متغیر محیطی \fBUSER\fR برای مشخص کردن نام کاربری استفاده می‌کند.
.RE 0

.RE 0

.P
\fB-q\fR
.RS 0
.RS 4
.P
نمایه‌سازی را برای اجرا توسط فرایند indexer در صف قرار می‌دهد. بدون -q، نمایه‌سازی مستقیماً توسط فرایند doveadm(1) انجام می‌شود. برخی راه‌اندازها (drivers) توانایی مدیریت به‌روزرسانی هم‌زمان نمایه‌ها توسط چندین فرایند را ندارند، بنابراین معمولاً باید از -q در محیط‌های عملیاتی استفاده شود.
.RE 0

.RE 0

.P
\fB-S\fR \fIsocket_path\fR
.RS 0
.RS 4
.P
آرگومان این گزینه یا یک مسیر مطلق به یک سوکت محلی دامنه یونیکس (UNIX domain socket) است، یا یک نام میزبان و درگاه (\fIhostname\fR:\fIport\fR) برای اتصال به یک میزبان دوردست از طریق سوکت TCP.
.P
این گزینه به مدیر سیستم اجازه می‌دهد دستورات ایمیل doveadm(1) را از طریق سوکت داده‌شده اجرا کند.
.RE 0

.RE 0

.P
\fB-u\fR \fIuser/mask\fR
.RS 0
.RS 4
.P
دستور (\fIcommand\fR) را تنها برای \fIuser\fR داده‌شده اجرا می‌کند. همچنین امکان استفاده از نویسه‌های عام (wildcards) '\fB*\fR' و '\fB?\fR' نیز وجود دارد (مانند ‎-u *@example.org).
.RE 0

.RE 0

.SH "آرگومان‌ها (ARGUMENTS)"
.P
\fImailbox\fR
.RS 0
.RS 4
.P
نام صندوق پستی برای نمایه‌سازی.
.RE 0

.RE 0

.SH "مثال‌ها (EXAMPLES)"
.P
نمایه‌سازی INBOX متعلق به bob:
.P
.RS 2
.nf
doveadm index -u bob INBOX
.fi
.RE
.SH "گزارش باگ‌ها (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)