نام (NAME)

doveadm-altmove - انتقال ایمیل‌های منطبق به فضای ذخیره‌سازی جایگزین (فقط dbox)

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

doveadm [GLOBAL OPTIONS] altmove [-r] [-S socket_path] -A search_query

doveadm [GLOBAL OPTIONS] altmove [-r] [-S socket_path] -F file search_query

doveadm [GLOBAL OPTIONS] altmove [-r] [-S socket_path] --no-userdb-lookup search_query

doveadm [GLOBAL OPTIONS] altmove [-r] [-S socket_path] -u user search_query

توضیحات (DESCRIPTION)

این دستور را می‌توان همراه با فضاهای ذخیره‌سازی sdbox یا mdbox استفاده کرد تا در صورتی که mail_alt_path برای مکان ایمیل‌ها مشخص شده باشد، ایمیل‌ها به مسیر ذخیره‌سازی جایگزین منتقل شوند.

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

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

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

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

گزینه‌های عمومی (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 را چندین بار مشخص کرد.

گزینه‌ها (OPTIONS)

-A

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

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

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

-F file

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

--no-userdb-lookup

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

-r

هنگامی که گزینهٔ -r داده شود، این دستور برعکس عمل می‌کند. ایمیل‌ها از فضای ذخیره‌سازی جایگزین به مکان پیش‌فرض ایمیل بازگردانده می‌شوند.

-S socket_path

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

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

-u user/mask

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

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

search_query

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

فایل‌ها (FILES)

/etc/dovecot/conf.d/10-mail.conf

مکان‌های صندوق پستی و فضاهای نام (namespaces).

مثال (EXAMPLE)

این مثال ایمیل‌های دیده‌شده با قدمت بیش از یک هفته را به فضای ذخیره‌سازی جایگزین زیر مسیر /nfsmount منتقل می‌کند:

mail_driver = mdbox
mail_path = ~/mdbox
mail_alt_path = /nfsmount/%{home}/mdbox

doveadm altmove -u johnd@example.com seen savedbefore 1w<

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

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

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

doveadm(1)