.TH "DOVEADM-FTS" "1" "May 2026" "e5ac02a" "Dovecot"
.SH "نام (NAME)"
\fBdoveadm-fts\fR \- دستکاری نمایهٔ جستجوی تمام‌متن (FTS)
.SH "خلاصه دستور (SYNOPSIS)"
.P
\fBdoveadm\fR \[lB]\fIGLOBAL OPTIONS\fR\[rB] \fBfts\fR \fIcommand\fR \[lB]\fIOPTIONS\fR\[rB] \[lB]\fIARGUMENTS\fR\[rB]
.SH "توضیحات (DESCRIPTION)"
.P
از \fICOMMANDS\fR در doveadm fts می‌توان برای دستکاری نمایهٔ جستجوی تمام‌متن (FTS) استفاده کرد.
.SH "گزینه‌های سراسری (GLOBAL OPTIONS)"
.P
\fIگزینه‌های\fR سراسری doveadm(1):
.P
\fB-D\fR
.RS 0
.RS 4
.P
حالت پرگویی (\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
پرگویی را به همراه شمارندهٔ پیشرفت فعال می‌کند.
.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
این دستور به‌طور پیش‌فرض از قالب‌بندی‌کنندهٔ خروجی \fBflow\fR (بدون پیشوند \fIkey\fR=) استفاده می‌کند.
.SH "گزینه‌ها (OPTIONS)"
.P
\fB-A\fR
.RS 0
.RS 4
.P
اگر گزینهٔ \fB-A\fR داده شده باشد، \fIدستور\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
\fIدستور\fR را برای تمام کاربران موجود در \fIfile\fR اجرا می‌کند. این مشابه گزینهٔ \fB-A\fR است، اما به‌جای دریافت فهرست کاربران از userdb، آن‌ها از \fIfile\fR داده‌شده خوانده می‌شوند. \fIfile\fR در هر سطر شامل یک نام کاربری است.
.RE 0

.RE 0

.P
\fB--no-userdb-lookup\fR
.RS 0
.RS 4
.P
جستجوی userdb را انجام نمی‌دهد. از متغیر محیطی \fBUSER\fR برای مشخص کردن نام کاربری استفاده می‌کند.
.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
\fIدستور\fR را فقط برای \fIuser\fR داده‌شده اجرا می‌کند. همچنین امکان استفاده از نویسه‌های عام '\fB*\fR' و '\fB?\fR' وجود دارد (برای نمونه \-u *@example.org).
.RE 0

.RE 0

.SH "آرگومان‌ها (ARGUMENTS)"
.P
\fInamespace\fR
.RS 0
.RS 4
.P
نام یک فضای نام (namespace)، مثلاً نام فضای نام اشتراکی. اگر هیچ فضای نامی داده نشود، از فضای نام خصوصی کاربر استفاده خواهد شد.
.RE 0

.RE 0

.SH "دستورها (COMMANDS)"
.SS "fts optimize"
.P
\fBdoveadm\fR \[lB]\fIGLOBAL OPTIONS\fR\[rB] fts optimize \[lB]\fB-u\fR \fIuser\fR | \fB-A\fR | \fB-F\fR \fIfile\fR | \fB--no-userdb-lookup\fR\[rB] \[lB]\fB-S\fR \fIsocket_path\fR\[rB] \[lB]\fInamespace\fR\[rB]
.P
نمایهٔ جستجوی تمام‌متن را بهینه‌سازی می‌کند. این کار به‌طور خودکار توسط موتورهای جستجوی تمام‌متن نیز انجام می‌شود، اما این دستور انجام آن را اجبار می‌کند.
.SS "fts rescan"
.P
\fBdoveadm\fR \[lB]\fIGLOBAL OPTIONS\fR\[rB] fts rescan \[lB]\fB-u\fR \fIuser\fR | \fB-A\fR | \fB-F\fR \fIfile\fR | \fB--no-userdb-lookup\fR\[rB] \[lB]\fB-S\fR \fIsocket_path\fR\[rB] \[lB]\fInamespace\fR\[rB]
.P
بررسی می‌کند چه نامه‌هایی در نمایهٔ جستجوی تمام‌متن وجود دارند و آن‌ها را با آنچه واقعاً در صندوق‌های پستی موجود است مقایسه می‌کند. این کار نامه‌هایی را که پیش‌تر پاکسازی (expunge) شده‌اند از نمایه حذف کرده و اطمینان حاصل می‌کند که \fBdoveadm index\fR بعدی تمام نامه‌های جاافتاده را (در صورت وجود) نمایه کند. توجه داشته باشید که در حال حاضر بیشتر درایورهای FTS این قابلیت را به درستی پیاده‌سازی نکرده‌اند، بلکه در عوض تمام نمایه‌های FTS را حذف می‌کنند. این مورد ممکن است در نسخه‌های آینده تغییر کند.
.SS "fts flatcurve check"
.P
\fBdoveadm\fR \[lB]\fIGLOBAL OPTIONS\fR\[rB] fts flatcurve check \[lB]\fB-u\fR \fIuser\fR | \fB-A\fR | \fB-F\fR \fIfile\fR | \fB--no-userdb-lookup\fR\[rB] \[lB]\fB-S\fR \fIsocket_path\fR\[rB] \[lB]\fImailbox\fR ...\[rB]
.P
یک بررسی ساده روی پایگاه‌های دادهٔ Dovecot Xapian انجام می‌دهد و برای رفع خطاهای اولیّه تلاش می‌کند (این همان بررسی‌ای است که توسط دستور xapian-check با گزینهٔ خط فرمان \fB-F\fR انجام می‌شود).
.P
\fImailbox\fR فهرستی از صندوق‌های پستی برای پردازش است. استفاده از نویسه‌های عام (* و ?) در این مقدار ممکن است.
.P
به ازای هر صندوق پستی دارای داده‌های FTS، فیلدهای کلید/مقدار زیر را خروجی می‌دهد:
.TS
tab(@) allbox;
cb cb
l l .
کلید@مقدار
mailbox@نام صندوق پستی که برای انسان خوانا است. (کلید پنهان است)
guid@شناسهٔ یکتای همگانی (GUID) صندوق پستی.
errors@تعداد خطاهای گزارش‌شده توسط کتابخانهٔ Xapian.
shards@تعداد بخش‌های (shards) نمایهٔ پردازش‌شده.
.TE
.SS "fts flatcurve remove"
.P
\fBdoveadm\fR \[lB]\fIGLOBAL OPTIONS\fR\[rB] fts flatcurve remove \[lB]\fB-u\fR \fIuser\fR | \fB-A\fR | \fB-F\fR \fIfile\fR | \fB--no-userdb-lookup\fR\[rB] \[lB]\fB-S\fR \fIsocket_path\fR\[rB] \[lB]\fImailbox\fR ...\[rB]
.P
تمام داده‌های FTS را برای یک صندوق پستی حذف می‌کند.
.P
\fImailbox\fR فهرستی از صندوق‌های پستی برای پردازش است. استفاده از نویسه‌های عام (* و ?) در این مقدار ممکن است.
.P
به ازای هر صندوق پستی حذف‌شده، فیلدهای کلید/مقدار زیر را خروجی می‌دهد:
.TS
tab(@) allbox;
cb cb
l l .
کلید@مقدار
mailbox@نام صندوق پستی که برای انسان خوانا است. (کلید پنهان است)
guid@شناسهٔ یکتای همگانی (GUID) صندوق پستی.
.TE
.SS "fts flatcurve rotate"
.P
\fBdoveadm\fR \[lB]\fIGLOBAL OPTIONS\fR\[rB] fts flatcurve rotate \[lB]\fB-u\fR \fIuser\fR | \fB-A\fR | \fB-F\fR \fIfile\fR | \fB--no-userdb-lookup\fR\[rB] \[lB]\fB-S\fR \fIsocket_path\fR\[rB] \[lB]\fImailbox\fR ...\[rB]
.P
چرخش نمایه را برای یک صندوق پستی آغاز می‌کند.
.P
\fImailbox\fR فهرستی از صندوق‌های پستی برای پردازش است. استفاده از نویسه‌های عام (* و ?) در این مقدار ممکن است.
.P
به ازای هر صندوق پستی چرخیده‌شده، فیلدهای کلید/مقدار زیر را خروجی می‌دهد:
.TS
tab(@) allbox;
cb cb
l l .
کلید@مقدار
mailbox@نام صندوق پستی که برای انسان خوانا است. (کلید پنهان است)
guid@شناسهٔ یکتای همگانی (GUID) صندوق پستی.
.TE
.SS "fts flatcurve stats"
.P
\fBdoveadm\fR \[lB]\fIGLOBAL OPTIONS\fR\[rB] fts flatcurve stats \[lB]\fB-u\fR \fIuser\fR | \fB-A\fR | \fB-F\fR \fIfile\fR | \fB--no-userdb-lookup\fR\[rB] \[lB]\fB-S\fR \fIsocket_path\fR\[rB] \[lB]\fImailbox\fR ...\[rB]
.P
داده‌های FTS را برای یک صندوق پستی بازمی‌گرداند.
.P
\fImailbox\fR فهرستی از صندوق‌های پستی برای پردازش است. استفاده از نویسه‌های عام (* و ?) در این مقدار ممکن است.
.P
به ازای هر صندوق پستی دارای داده‌های FTS، فیلدهای کلید/مقدار زیر را خروجی می‌دهد:
.TS
tab(@) allbox;
cb cb
l l .
کلید@مقدار
mailbox@نام صندوق پستی که برای انسان خوانا است. (کلید پنهان است)
guid@شناسهٔ یکتای همگانی (GUID) صندوق پستی.
last_uid@آخرین UID نمایه‌شده در صندوق پستی.
messages@تعداد پیام‌های نمایه‌شده در صندوق پستی.
shards@تعداد بخش‌های (shards) نمایه.
version@نسخهٔ داده‌های FTS (درونیِ Dovecot).
.TE
.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), doveadm-search-query(7)
.P
منابع تکمیلی:
.RS 0
.IP \(bu 4
مستندات افزونهٔ fts
.RE 0