.TH "DOVEADM-ALTMOVE" "1" "May 2026" "e5ac02a" "Dovecot"
.SH "نام (NAME)"
\fBdoveadm-altmove\fR \- انتقال ایمیل‌های منطبق به فضای ذخیره‌سازی جایگزین (فقط dbox)
.SH "خلاصه دستور (SYNOPSIS)"
.P
\fBdoveadm\fR \[lB]\fIGLOBAL OPTIONS\fR\[rB] \fBaltmove\fR \[lB]\fB-r\fR\[rB] \[lB]\fB-S\fR \fIsocket_path\fR\[rB] \fB-A\fR \fIsearch_query\fR
.P
\fBdoveadm\fR \[lB]\fIGLOBAL OPTIONS\fR\[rB] \fBaltmove\fR \[lB]\fB-r\fR\[rB] \[lB]\fB-S\fR \fIsocket_path\fR\[rB] \fB-F\fR \fIfile search_query\fR
.P
\fBdoveadm\fR \[lB]\fIGLOBAL OPTIONS\fR\[rB] \fBaltmove\fR \[lB]\fB-r\fR\[rB] \[lB]\fB-S\fR \fIsocket_path\fR\[rB] \fB--no-userdb-lookup\fR \fIsearch_query\fR
.P
\fBdoveadm\fR \[lB]\fIGLOBAL OPTIONS\fR\[rB] \fBaltmove\fR \[lB]\fB-r\fR\[rB] \[lB]\fB-S\fR \fIsocket_path\fR\[rB] \fB-u\fR \fIuser search_query\fR
.SH "توضیحات (DESCRIPTION)"
.P
این دستور را می‌توان همراه با فضاهای ذخیره‌سازی sdbox یا mdbox استفاده کرد تا در صورتی که \fImail_alt_path\fR برای مکان ایمیل‌ها مشخص شده باشد، ایمیل‌ها به مسیر ذخیره‌سازی جایگزین منتقل شوند.
.P
در حالت نخست، doveadm(1) دستور \fBaltmove\fR را برای همهٔ کاربران اجرا خواهد کرد.
.P
در حالت دوم، دستور برای همهٔ کاربران فهرست‌شده در \fIfile\fR داده‌شده انجام خواهد شد.
.P
در حالت سوم، دستور برای کاربری که در متغیر محیطی \fIUSER\fR مشخص شده است اجرا می‌شود.
.P
در حالت آخر، تنها ایمیل‌های منطبق متعلق به کاربر یا کاربران (\fIuser\fR) داده‌شده به فضای ذخیره‌سازی جایگزین منتقل خواهند شد.
.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

.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
هنگامی که از ماژول userdb مبتنی بر SQL استفاده می‌شود، اطمینان حاصل کنید که تنظیم \fBuserdb_sql_iterate_query\fR با ساختار پایگاه‌دادهٔ شما مطابقت داشته باشد.
.P
هنگام استفاده از ماژول userdb مبتنی بر LDAP، اطمینان حاصل کنید که تنظیم \fBuserdb_fields\fR و تنظیم \fBuserdb_ldap_iterate_fields\fR با طرحوارهٔ 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-r\fR
.RS 0
.RS 4
.P
هنگامی که گزینهٔ \fB-r\fR داده شود، این \fIدستور\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
\fIsearch_query\fR
.RS 0
.RS 4
.P
پیام‌های منطبق با این عبارت جستجو به فضای ذخیره‌سازی جایگزین منتقل خواهند شد. برای جزئیات doveadm-search-query(7) را ببینید.
.RE 0

.RE 0

.SH "فایل‌ها (FILES)"
.P
\fI/etc/dovecot/conf.d/10-mail.conf\fR
.RS 0
.RS 4
.P
مکان‌های صندوق پستی و فضاهای نام (namespaces).
.RE 0

.RE 0

.SH "مثال (EXAMPLE)"
.P
این مثال ایمیل‌های دیده‌شده با قدمت بیش از یک هفته را به فضای ذخیره‌سازی جایگزین زیر مسیر /nfsmount منتقل می‌کند:
.P
.RS 2
.nf
mail_driver = mdbox
mail_path = ~/mdbox
mail_alt_path = /nfsmount/%{home}/mdbox
.fi
.RE
.P
.RS 2
.nf
doveadm altmove -u johnd@example.com seen savedbefore 1w<
.fi
.RE
.SH "گزارش باگ‌ها (REPORTING 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)