نام (NAME)

doveadm-fts - دستکاری نمایهٔ جستجوی تمام‌متن (FTS)

خلاصه دستور (SYNOPSIS)

doveadm [GLOBAL OPTIONS] fts command [OPTIONS] [ARGUMENTS]

توضیحات (DESCRIPTION)

از COMMANDS در doveadm fts می‌توان برای دستکاری نمایهٔ جستجوی تمام‌متن (FTS) استفاده کرد.

گزینه‌های سراسری (GLOBAL OPTIONS)

گزینه‌های سراسری doveadm(1):

-D

حالت پرگویی (verbosity) و پیام‌های اشکال‌زدایی را فعال می‌کند.

-O

هیچ فایل پیکربندی را نمی‌خواند، فقط از مقادیر پیش‌فرض استفاده می‌کند. تنظیم dovecot_storage_version به‌طور پیش‌فرض برابر با آخرین نسخه است، اما با -o می‌توان آن را بازنویسی کرد.

-k

تمام محیط را برای doveadm حفظ می‌کند، نه فقط تنظیم import_environment را.

-v

پرگویی را به همراه شمارندهٔ پیشرفت فعال می‌کند.

-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 را چندین بار مشخص کرد.

این دستور به‌طور پیش‌فرض از قالب‌بندی‌کنندهٔ خروجی flow (بدون پیشوند key=) استفاده می‌کند.

گزینه‌ها (OPTIONS)

-A

اگر گزینهٔ -A داده شده باشد، دستور برای تمام کاربران اجرا خواهد شد. استفاده از این گزینه همراه با کاربران سیستمی از userdb { driver = passwd } توصیه نمی‌شود، زیرا شامل کاربرانی با UID کمتر از مقدار پیکربندی‌شده در تنظیم first_valid_uid نیز می‌شود.

هنگامی که ماژول SQL userdb استفاده می‌شود، مطمئن شوید که تنظیم userdb_sql_iterate_query با طرح‌بندی پایگاه‌دادهٔ شما همخوانی دارد.

هنگام استفاده از ماژول LDAP userdb، مطمئن شوید که تنظیم userdb_fields و تنظیم userdb_ldap_iterate_fields با طرحوارهٔ (schema) LDAP شما تطابق دارند. در غیر این صورت doveadm(1) قادر نخواهد بود روی تمام کاربران پیمایش کند.

-F file

دستور را برای تمام کاربران موجود در file اجرا می‌کند. این مشابه گزینهٔ -A است، اما به‌جای دریافت فهرست کاربران از userdb، آن‌ها از file داده‌شده خوانده می‌شوند. file در هر سطر شامل یک نام کاربری است.

--no-userdb-lookup

جستجوی userdb را انجام نمی‌دهد. از متغیر محیطی USER برای مشخص کردن نام کاربری استفاده می‌کند.

-S socket_path

آرگومان این گزینه یک مسیر مطلق به یک سوکت محلی دامنهٔ یونیکس (UNIX domain socket)، یا یک نام میزبان و درگاه (hostname:port) به منظور اتصال به یک میزبان راه‌دور از طریق سوکت TCP است.

این به مدیر سیستم امکان می‌دهد دستورهای پستی doveadm(1) را از طریق سوکت داده‌شده اجرا کند.

-u user/mask

دستور را فقط برای user داده‌شده اجرا می‌کند. همچنین امکان استفاده از نویسه‌های عام '*' و '?' وجود دارد (برای نمونه -u *@example.org).

آرگومان‌ها (ARGUMENTS)

namespace

نام یک فضای نام (namespace)، مثلاً نام فضای نام اشتراکی. اگر هیچ فضای نامی داده نشود، از فضای نام خصوصی کاربر استفاده خواهد شد.

دستورها (COMMANDS)

fts optimize

doveadm [GLOBAL OPTIONS] fts optimize [-u user | -A | -F file | --no-userdb-lookup] [-S socket_path] [namespace]

نمایهٔ جستجوی تمام‌متن را بهینه‌سازی می‌کند. این کار به‌طور خودکار توسط موتورهای جستجوی تمام‌متن نیز انجام می‌شود، اما این دستور انجام آن را اجبار می‌کند.

fts rescan

doveadm [GLOBAL OPTIONS] fts rescan [-u user | -A | -F file | --no-userdb-lookup] [-S socket_path] [namespace]

بررسی می‌کند چه نامه‌هایی در نمایهٔ جستجوی تمام‌متن وجود دارند و آن‌ها را با آنچه واقعاً در صندوق‌های پستی موجود است مقایسه می‌کند. این کار نامه‌هایی را که پیش‌تر پاکسازی (expunge) شده‌اند از نمایه حذف کرده و اطمینان حاصل می‌کند که doveadm index بعدی تمام نامه‌های جاافتاده را (در صورت وجود) نمایه کند. توجه داشته باشید که در حال حاضر بیشتر درایورهای FTS این قابلیت را به درستی پیاده‌سازی نکرده‌اند، بلکه در عوض تمام نمایه‌های FTS را حذف می‌کنند. این مورد ممکن است در نسخه‌های آینده تغییر کند.

fts flatcurve check

doveadm [GLOBAL OPTIONS] fts flatcurve check [-u user | -A | -F file | --no-userdb-lookup] [-S socket_path] [mailbox ...]

یک بررسی ساده روی پایگاه‌های دادهٔ Dovecot Xapian انجام می‌دهد و برای رفع خطاهای اولیّه تلاش می‌کند (این همان بررسی‌ای است که توسط دستور xapian-check با گزینهٔ خط فرمان -F انجام می‌شود).

mailbox فهرستی از صندوق‌های پستی برای پردازش است. استفاده از نویسه‌های عام (* و ?) در این مقدار ممکن است.

به ازای هر صندوق پستی دارای داده‌های FTS، فیلدهای کلید/مقدار زیر را خروجی می‌دهد:

کلید	مقدار
mailbox	نام صندوق پستی که برای انسان خوانا است. (کلید پنهان است)
guid	شناسهٔ یکتای همگانی (GUID) صندوق پستی.
errors	تعداد خطاهای گزارش‌شده توسط کتابخانهٔ Xapian.
shards	تعداد بخش‌های (shards) نمایهٔ پردازش‌شده.

fts flatcurve remove

doveadm [GLOBAL OPTIONS] fts flatcurve remove [-u user | -A | -F file | --no-userdb-lookup] [-S socket_path] [mailbox ...]

تمام داده‌های FTS را برای یک صندوق پستی حذف می‌کند.

mailbox فهرستی از صندوق‌های پستی برای پردازش است. استفاده از نویسه‌های عام (* و ?) در این مقدار ممکن است.

به ازای هر صندوق پستی حذف‌شده، فیلدهای کلید/مقدار زیر را خروجی می‌دهد:

کلید	مقدار
mailbox	نام صندوق پستی که برای انسان خوانا است. (کلید پنهان است)
guid	شناسهٔ یکتای همگانی (GUID) صندوق پستی.

fts flatcurve rotate

doveadm [GLOBAL OPTIONS] fts flatcurve rotate [-u user | -A | -F file | --no-userdb-lookup] [-S socket_path] [mailbox ...]

چرخش نمایه را برای یک صندوق پستی آغاز می‌کند.

mailbox فهرستی از صندوق‌های پستی برای پردازش است. استفاده از نویسه‌های عام (* و ?) در این مقدار ممکن است.

به ازای هر صندوق پستی چرخیده‌شده، فیلدهای کلید/مقدار زیر را خروجی می‌دهد:

کلید	مقدار
mailbox	نام صندوق پستی که برای انسان خوانا است. (کلید پنهان است)
guid	شناسهٔ یکتای همگانی (GUID) صندوق پستی.

fts flatcurve stats

doveadm [GLOBAL OPTIONS] fts flatcurve stats [-u user | -A | -F file | --no-userdb-lookup] [-S socket_path] [mailbox ...]

داده‌های FTS را برای یک صندوق پستی بازمی‌گرداند.

mailbox فهرستی از صندوق‌های پستی برای پردازش است. استفاده از نویسه‌های عام (* و ?) در این مقدار ممکن است.

به ازای هر صندوق پستی دارای داده‌های FTS، فیلدهای کلید/مقدار زیر را خروجی می‌دهد:

کلید	مقدار
mailbox	نام صندوق پستی که برای انسان خوانا است. (کلید پنهان است)
guid	شناسهٔ یکتای همگانی (GUID) صندوق پستی.
last_uid	آخرین UID نمایه‌شده در صندوق پستی.
messages	تعداد پیام‌های نمایه‌شده در صندوق پستی.
shards	تعداد بخش‌های (shards) نمایه.
version	نسخهٔ داده‌های FTS (درونیِ Dovecot).

گزارش باگ‌ها (BUGS)

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

همچنین ببینید (SEE ALSO)

doveadm(1), doveadm-search-query(7)

منابع تکمیلی:

•: مستندات افزونهٔ fts