.TH "DOVEADM-COPY" "1" "May 2026" "e5ac02a" "Dovecot"
.SH "نام (NAME)"
doveadm\-copy \- کپی کردن پیام‌های منطبق با پرس‌وجوی جستجوی داده‌شده به صندوق پستی دیگر
.SH "خلاصه دستور (SYNOPSIS)"
.P
\fBdoveadm\fR \[lB]\fIGLOBAL OPTIONS\fR\[rB] \fBmove\fR \[lB]\fB-S\fR \fIsocket_path\fR\[rB] \fB-A\fR \fBdestination\fR \[lB]\fBuser\fR \fIsource_user\fR\[rB] \fIsearch_query\fR
.P
\fBdoveadm\fR \[lB]\fIGLOBAL OPTIONS\fR\[rB] \fBmove\fR \[lB]\fB-S\fR \fIsocket_path\fR\[rB] \fB-F\fR \fIfile\fR \fBdestination\fR \[lB]\fBuser\fR \fIsource_user\fR\[rB] \fIsearch_query\fR
.P
\fBdoveadm\fR \[lB]\fIGLOBAL OPTIONS\fR\[rB] \fBmove\fR \[lB]\fB-S\fR \fIsocket_path\fR\[rB] \fB--no-userdb-lookup\fR \fBdestination\fR \[lB]\fBuser\fR \fIsource_user\fR\[rB] \fIsearch_query\fR
.P
\fBdoveadm\fR \[lB]\fIGLOBAL OPTIONS\fR\[rB] \fBmove\fR \[lB]\fB-S\fR \fIsocket_path\fR\[rB] \fB-u\fR \fIuser\fR \fBdestination\fR \[lB]\fBuser\fR \fIsource_user\fR\[rB] \fIsearch_query\fR
.P
\fBdoveadm\fR \[lB]\fIGLOBAL OPTIONS\fR\[rB] \fBcopy\fR \[lB]\fB-S\fR \fIsocket_path\fR\[rB] \fB-A\fR \fBdestination\fR \[lB]\fBuser\fR \fIsource_user\fR\[rB] \fIsearch_query\fR
.P
\fBdoveadm\fR \[lB]\fIGLOBAL OPTIONS\fR\[rB] \fBcopy\fR \[lB]\fB-S\fR \fIsocket_path\fR\[rB] \fB-F\fR \fIfile\fR \fBdestination\fR \[lB]\fBuser\fR \fIsource_user\fR\[rB] \fIsearch_query\fR
.P
\fBdoveadm\fR \[lB]\fIGLOBAL OPTIONS\fR\[rB] \fBcopy\fR \[lB]\fB-S\fR \fIsocket_path\fR\[rB] \fB--no-userdb-lookup\fR \fBdestination\fR \[lB]\fBuser\fR \fIsource_user\fR\[rB] \fIsearch_query\fR
.P
\fBdoveadm\fR \[lB]\fIGLOBAL OPTIONS\fR\[rB] \fBcopy\fR \[lB]\fB-S\fR \fIsocket_path\fR\[rB] \fB-u\fR \fIuser\fR \fBdestination\fR \[lB]\fBuser\fR \fIsource_user\fR\[rB] \fIsearch_query\fR
.SH "توضیحات (DESCRIPTION)"
.P
دستور \fBdoveadm move\fR می‌تواند برای انتقال ایمیل‌ها بین صندوق‌های پستی برای یک یا چند کاربر استفاده شود. از \fIsearch_query\fR برای محدود کردن پیام‌هایی که به صندوق پستی \fIdestination\fR منتقل می‌شوند استفاده می‌گردد.
.P
دستور \fBdoveadm copy\fR رفتاری مشابه \fBdoveadm move\fR دارد، با این تفاوت که پیام‌های کپی‌شده پس از کپی شدن، پاکسازی (expunge) نخواهند شد.
.P
در حالت نخست، doveadm(1) بر روی تمام کاربرانی که در \fIuser_db\fRهای پیکربندی‌شده یافت شوند پیمایش کرده و پیام‌های هر کاربر را که با \fIsearch_query\fR داده‌شده مطابقت دارند، به صندوق پستی \fIdestination\fR آن کاربر منتقل یا کپی می‌کند.
.P
در حالت دوم، doveadm(1) بر روی تمام کاربرانی که در \fIfile\fR داده‌شده یافت شوند پیمایش کرده و پیام‌های هر کاربر را که با \fIsearch_query\fR داده‌شده مطابقت دارند، به صندوق پستی \fIdestination\fR آن کاربر منتقل یا کپی می‌کند.
.P
در حالت سوم، پیام‌های منطبق تنها برای \fIuser\fR (کاربر یا کاربران) داده‌شده منتقل یا کپی خواهند شد.
.SH "گزینه‌های عمومی (GLOBAL OPTIONS)"
.P
گزینه‌های عمومی doveadm(1):
.P
\fB-D\fR
.RS 0
.RS 4
.P
پیام‌های اشکال‌زدایی (debug) و پرگویی (\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
پرگویی (verbosity)، از جمله شمارندهٔ پیشرفت را فعال می‌کند.
.RE 0

.RE 0

.P
\fB-i\fR \fIinstance-name\fR
.RS 0
.RS 4
.P
در صورت استفاده از چندین نمونه (instance) از 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 مشخص شود، دستور (\fIcommand\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
دستور (\fIcommand\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
دستور (\fIcommand\fR) را تنها برای \fIuser\fR داده‌شده اجرا می‌کند. همچنین امکان استفاده از نویسه‌های عام (wildcards) '\fB*\fR' و '\fB?\fR' وجود دارد (مانند -u *@example.org).
.RE 0

.RE 0

.SH "آرگومان‌ها (ARGUMENTS)"
.P
\fIdestination\fR
.RS 0
.RS 4
.P
نام صندوق پستی مقصد که ایمیل‌ها باید به آن انتقال یافته یا کپی شوند. صندوق پستی \fIdestination\fR باید وجود داشته باشد، در غیر این صورت این دستور با شکست مواجه خواهد شد.
.RE 0

.RE 0

.P
\fIsearch_query\fR
.RS 0
.RS 4
.P
پیام‌های منطبق با پرس‌وجوی جستجوی داده‌شده را انتقال می‌دهد یا کپی می‌کند. برای جزئیات به doveadm-search-query(7) مراجعه کنید.
.P
برای دستور \fImove\fR، پارامتر \fBmailbox\fR الزامی است.
.P
برای دستور \fImove\fR، یک محدودکنندهٔ بازهٔ پیام الزامی است. به عبارت دیگر، شما باید حداقل یک پارامتر پرس‌وجو داشته باشید که بازهٔ پیام را محدود کند. اگر همهٔ پیام‌ها مورد نیاز باشند، می‌توان از پارامتر پرس‌وجوی "all" استفاده کرد.
.RE 0

.RE 0

.P
\fBuser\fR \fIsource_user\fR
.RS 0
.RS 4
.P
کلیدواژهٔ \fBuser\fR به همراه یک نام کاربری معتبر. هنگامی که این آرگومان وجود داشته باشد، doveadm(1) عبارت \fIsearch_query\fR را بر روی مکان ایمیل \fIsource_user\fR اعمال خواهد کرد.
.P
\fBمحدودیت:\fR در حال حاضر کاربرانی که توسط \fB-u\fR \fIuser\fR و \fBuser\fR \fIsource_user\fR مشخص می‌شوند، باید UID و GID سیستمی یکسانی داشته باشند.
.RE 0

.RE 0

.SH "مثال (EXAMPLE)"
.P
انتقال پیام‌های jane که در سپتامبر ۲۰۱۱ دریافت شده‌اند، از INBOX به بایگانی او:
.P
.RS 2
.nf
doveadm move -u jane Archive/2011/09 mailbox INBOX BEFORE \[rs]
  2011-10-01 SINCE 01-Sep-2011
.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)