نام (NAME)

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

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

doveadm [GLOBAL OPTIONS] import [-S socket_path] [-U source_user] [-s] -A source_mail_driver:source_mail_path

doveadm [GLOBAL OPTIONS] import [-S socket_path] [-U source_user] [-s] -F file source_mail_driver:source_mail_path

doveadm [GLOBAL OPTIONS] import [-S socket_path] [-U source_user] [-s] -u user source_mail_driver:source_mail_path

توضیحات (DESCRIPTION)

از این دستور می‌توان برای درون‌ریزی ایمیل‌ها از یک فضای ذخیره‌سازی دیگر که توسط source_mail_driver، source_mail_path و سایر تنظیمات مشخص‌شده از طریق پارامترهای -p تعیین می‌شود، به یک یا چند صندوق پستی کاربر استفاده کرد. تمام صندوق‌های پستی تحت صندوق پستی داده‌شدهٔ dest_parent، یا در صورت خالی بودن dest_parent ("") در سطح ریشه درون‌ریزی می‌شوند. از search_query می‌توان برای محدود کردن این‌که کدام صندوق‌های پستی یا پیام‌ها درون‌ریزی شوند استفاده کرد. به‌طور پیش‌فرض درون‌ریزی در بستر کاربر مقصد انجام می‌شود؛ می‌توانید برای تغییر این حالت از -U استفاده کنید.

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

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

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

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

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

-D

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

-O

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

-k

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

-v

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

-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 می‌تواند چندین بار مشخص شود.

گزینه‌ها (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 با اسکیمای 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) را از طریق سوکت داده‌شده اجرا کند.

-p setting=value

تنظیم پیکربندی setting را برای فضای ذخیره‌سازی مبدأ بازنویسی می‌کند.

-s

هنگامی که گزینهٔ -s وجود داشته باشد، صندوق پستی dest_parent و تمام صندوق‌های پستی جدید ذیل آن به اشتراک گذاشته (subscribe) خواهند شد.

-U username

هنگامی که گزینهٔ -U وجود داشته باشد، صندوق مبدأ با نام کاربری داده‌شده باز می‌شود.

-u user/mask

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

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

dest_parent

نام صندوق پستی مقصد، که ایمیل‌ها باید تحت آن درون‌ریزی شوند. در صورتی که صندوق پستی dest_parent وجود نداشته باشد، doveadm(1) آن را ایجاد خواهد کرد.

search_query

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

source_mail_driver:source_mail_path

این آرگومان تنظیمات mail_driver و mail_path را برای مکان مبدأ مشخص می‌کند. از پارامتر -p می‌توان به‌صورت اختیاری برای مشخص کردن تنظیمات اضافی استفاده کرد. برای مثال: maildir:/backup/20101126/jane.doe/Maildir یا -p mail_alt_path=/nfsmount/john.doe/mdbox mdbox:/srv/mail/john.doe/mdbox

مثال‌ها (EXAMPLES)

این مثال تمام ایمیل‌ها را از یک نسخهٔ پشتیبان تحت صندوق پستی backup-20101026 درون‌ریزی می‌کند:

doveadm import -u jane.doe@example.org \
  mdbox:/backup/20101026/jane.doe/mdbox backup-20101026 all

مثالی دیگر که تنها پیام‌های فرستاده‌شده از طرف ⟨foo@example.org⟩ را از INBOX نسخهٔ پشتیبان mdbox به INBOX کاربر jane درون‌ریزی می‌کند:

doveadm import -u jane.doe@example.org \
  mdbox:~/mdbox-backup "" mailbox INBOX from foo@example.org

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

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

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

doveadm(1), doveadm-search-query(7)