.TH "DOVEADM-IMPORT" "1" "May 2026" "e5ac02a" "Dovecot"
.SH "نام (NAME)"
doveadm-import \- درون‌ریزی پیام‌های منطبق با پرسمان جستجوی داده‌شده
.SH "خلاصه دستور (SYNOPSIS)"
.P
\fBdoveadm\fR \[lB]\fIGLOBAL OPTIONS\fR\[rB] \fBimport\fR \[lB]\fB-S\fR \fIsocket_path\fR\[rB] \[lB]\fB-U\fR \fIsource_user\fR\[rB] \[lB]\fB-s\fR\[rB] \fB-A\fR \fIsource_mail_driver\fR:\fIsource_mail_path\fR
.P
\fBdoveadm\fR \[lB]\fIGLOBAL OPTIONS\fR\[rB] \fBimport\fR \[lB]\fB-S\fR \fIsocket_path\fR\[rB] \[lB]\fB-U\fR \fIsource_user\fR\[rB] \[lB]\fB-s\fR\[rB] \fB-F\fR \fIfile\fR \fIsource_mail_driver\fR:\fIsource_mail_path\fR
.P
\fBdoveadm\fR \[lB]\fIGLOBAL OPTIONS\fR\[rB] \fBimport\fR \[lB]\fB-S\fR \fIsocket_path\fR\[rB] \[lB]\fB-U\fR \fIsource_user\fR\[rB] \[lB]\fB-s\fR\[rB] \fB-u\fR \fIuser\fR \fIsource_mail_driver\fR:\fIsource_mail_path\fR
.SH "توضیحات (DESCRIPTION)"
.P
از این دستور می‌توان برای درون‌ریزی ایمیل‌ها از یک فضای ذخیره‌سازی دیگر که توسط \fIsource_mail_driver\fR، \fIsource_mail_path\fR و سایر تنظیمات مشخص‌شده از طریق پارامترهای \fB-p\fR تعیین می‌شود، به یک یا چند صندوق پستی کاربر استفاده کرد. تمام صندوق‌های پستی تحت صندوق پستی داده‌شدهٔ \fIdest_parent\fR، یا در صورت خالی بودن \fIdest_parent\fR ("") در سطح ریشه درون‌ریزی می‌شوند. از \fIsearch_query\fR می‌توان برای محدود کردن این‌که کدام صندوق‌های پستی یا پیام‌ها درون‌ریزی شوند استفاده کرد. به‌طور پیش‌فرض درون‌ریزی در بستر کاربر مقصد انجام می‌شود؛ می‌توانید برای تغییر این حالت از \fB-U\fR استفاده کنید.
.P
در حالت نخست، ایمیل‌ها برای تمام کاربران درون‌ریزی خواهند شد.
.P
در حالت دوم، ایمیل‌ها برای تمام کاربران فهرست‌شده در \fIfile\fR داده‌شده درون‌ریزی خواهند شد.
.P
در حالت آخر، ایمیل‌ها تنها برای \fIuser\fR (کاربر یا کاربران) داده‌شده درون‌ریزی خواهند شد.
.SH "گزینه‌های عمومی (GLOBAL OPTIONS)"
.P
گزینه‌های عمومی 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
در صورت استفاده از چند نمونهٔ (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 با اسکیمای 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-p\fR \fIsetting\fR\fB=\fR\fIvalue\fR
.RS 0
.RS 4
.P
تنظیم پیکربندی \fIsetting\fR را برای فضای ذخیره‌سازی مبدأ بازنویسی می‌کند.
.RE 0

.RE 0

.P
\fB-s\fR
.RS 0
.RS 4
.P
هنگامی که گزینهٔ \fB-s\fR وجود داشته باشد، صندوق پستی \fIdest_parent\fR و تمام صندوق‌های پستی جدید ذیل آن به اشتراک گذاشته (subscribe) خواهند شد.
.RE 0

.RE 0

.P
\fB-U username\fR
.RS 0
.RS 4
.P
هنگامی که گزینهٔ \fB-U\fR وجود داشته باشد، صندوق مبدأ با نام کاربری داده‌شده باز می‌شود.
.RE 0

.RE 0

.P
\fB-u\fR \fIuser/mask\fR
.RS 0
.RS 4
.P
دستور \fIcommand\fR را تنها برای \fIuser\fR داده‌شده اجرا می‌کند. همچنین امکان استفاده از نویسه‌های عمومی '\fB*\fR' و '\fB?\fR' وجود دارد (مانند ‎-u *@example.org).
.RE 0

.RE 0

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

.RE 0

.P
\fIsearch_query\fR
.RS 0
.RS 4
.P
پیام‌های منطبق با این پرسمان جستجو را کپی می‌کند. برای جزئیات بیشتر doveadm-search-query(7) را ببینید.
.RE 0

.RE 0

.P
\fIsource_mail_driver\fR:\fIsource_mail_path\fR
.RS 0
.RS 4
.P
این آرگومان تنظیمات \fImail_driver\fR و \fImail_path\fR را برای مکان مبدأ مشخص می‌کند. از پارامتر \fB-p\fR می‌توان به‌صورت اختیاری برای مشخص کردن تنظیمات اضافی استفاده کرد. برای مثال: \fBmaildir:/backup/20101126/jane.doe/Maildir\fR یا \fB-p mail_alt_path=/nfsmount/john.doe/mdbox mdbox:/srv/mail/john.doe/mdbox\fR
.RE 0

.RE 0

.SH "مثال‌ها (EXAMPLES)"
.P
این مثال تمام ایمیل‌ها را از یک نسخهٔ پشتیبان تحت صندوق پستی \fIbackup-20101026\fR درون‌ریزی می‌کند:
.P
.RS 2
.nf
doveadm import -u jane.doe@example.org \[rs]
  mdbox:/backup/20101026/jane.doe/mdbox backup-20101026 all
.fi
.RE
.P
مثالی دیگر که تنها پیام‌های فرستاده‌شده از طرف \fI\(lafoo@example.org\(ra\fR را از INBOX نسخهٔ پشتیبان mdbox به INBOX کاربر jane درون‌ریزی می‌کند:
.P
.RS 2
.nf
doveadm import -u jane.doe@example.org \[rs]
  mdbox:~/mdbox-backup "" mailbox INBOX from foo@example.org
.fi
.RE
.SH "گزارش باگ‌ها (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), doveadm-search-query(7)