نام (NAME)

doveadm-rebuild - دستورهای مربوط به بازسازی جنبه‌های مختلف ایمیل‌های منطبق با پرس‌وجوی جستجوی داده‌شده

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

doveadm [GLOBAL OPTIONS] [-f formatter] rebuild <command> [-S socket_path] -A search_query

doveadm [GLOBAL OPTIONS] [-f formatter] rebuild <command> [-S socket_path] -F file search_query

doveadm [GLOBAL OPTIONS] [-f formatter] rebuild <command> [-S socket_path] --no-userdb-lookup search_query

doveadm [GLOBAL OPTIONS] [-f formatter] rebuild <command> [-S socket_path] -u user search_query

توضیحات (DESCRIPTION)

دستور rebuild attachments برای بازسازی وضعیت وجود پیوست‌ها استفاده می‌شود. doveadm(1) شناسهٔ uid پیام را برای هر مورد منطبق چاپ خواهد کرد.

هنگام استفاده با گزینه‌های -A یا -u wildcard، doveadm(1) فیلدهای username و uid را برای هر پیام منطبق چاپ خواهد کرد.

در حالت اول، doveadm(1) اقدام rebuild را برای همه کاربران اجرا خواهد کرد.

در حالت دوم، این دستور برای همه کاربران فهرست‌شده در file داده‌شده اجرا خواهد شد.

در حالت سوم، این دستور برای کاربری که نام او در متغیر محیطی USER قرار دارد اجرا خواهد شد.

در حالت آخر، تنها ایمیل‌های منطبق مربوط به user (کاربر یا کاربران) داده‌شده بازسازی خواهند شد.

گزینه‌های عمومی (GLOBAL OPTIONS)

گزینه‌های عمومی doveadm(1):

-D

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

-O

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

-k

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

-v

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

-i instance-name

در صورت استفاده از چندین نمونه (instance) از 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) را چاپ می‌کند.

table

یک سربرگ جدول و به‌دنبال آن خطوط مقادیر تراز‌شده را چاپ می‌کند.

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

گزینه‌ها (OPTIONS)

-A

اگر گزینهٔ -A مشخص شود، دستور (command) برای همه کاربران انجام خواهد شد. استفاده از این گزینه همراه با کاربران سیستمیِ 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

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

--no-userdb-lookup

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

-S socket_path

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

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

-u user/mask

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

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

search_query

نشانگر پیوست را برای پیام‌های منطبق با این پرس‌وجوی جستجو بازنشانی می‌کند. برای جزئیات به doveadm-search-query(7) مراجعه کنید.

مثال (EXAMPLE)

بازسازی وضعیت پیوست‌های کاربر bob:

doveadm rebuild attachments -u bob ALL

1
2
3

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

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

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

doveadm(1)