| DOVEADM-SAVE(1) | Dovecot | DOVEADM-SAVE(1) |
نام (NAME)
doveadm-save - ذخیره کردن ایمیل در صندوق پستی یک کاربر
خلاصه دستور (SYNOPSIS)
doveadm
doveadm
doveadm
doveadm
توضیحات (DESCRIPTION)
دستور doveadm save میتواند برای ذخیره کردن پیامها استفاده شود. این قابلیت برای اسکریپتها و اشکالزدایی مفید است. فیلتر Sieve برای پیامهای ذخیرهشده فراخوانی نمیشود، اما محدودیت سهمیه (quota) اعمال میگردد.
گزینههای عمومی (GLOBAL OPTIONS)
گزینههای عمومی doveadm(1):
-D
پیامهای اشکالزدایی (debug) و پرگویی (verbosity) را فعال میکند.
-O
هیچ فایل پیکربندیای را نمیخواند و صرفاً از مقادیر پیشفرض استفاده میکند. تنظیم dovecot_storage_version بهطور پیشفرض روی جدیدترین نسخه قرار دارد، اما میتوان آن را با -o بازنویسی کرد.
-k
تمام محیط را برای doveadm حفظ میکند، نه فقط تنظیم import_environment را.
-v
پرگویی (verbosity)، از جمله شمارندهٔ پیشرفت را فعال میکند.
-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 با طرحوارهٔ (schema) 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) را از طریق سوکت دادهشده اجرا کند.
-u user/mask
دستور (command) را تنها برای user دادهشده اجرا میکند. همچنین امکان استفاده از نویسههای عام (wildcards) '*' و '?' وجود دارد (مانند -u *@example.org).
-m mailbox
ایمیل را به جای INBOX در صندوق پستی مشخصشده ذخیره میکند.
-U uid
در صورت امکان، ایمیل را با استفاده از UID دادهشده ذخیره میکند.
-g guid
ایمیل را با استفاده از GUID دادهشده ذخیره میکند.
-r received-date
ایمیل را با استفاده از برچسب زمان دریافت (received-date) دادهشده ذخیره میکند. این مقدار در قالب «برچسب زمان خوانا برای انسان» (human timestamp) است که در doveadm-search-query(7) شرح داده شده است.
آرگومانها (ARGUMENTS)
mail-file
دادههای پیام برای ذخیرهسازی.
- اگر mail-file برابر با - باشد، پیام از ورودی استاندارد (stdin) خوانده میشود (پیشفرض).
- در غیر این صورت، mail-file به عنوان مسیر یک فایل تفسیر میشود.
مثالها (EXAMPLES)
echo "hello, world" | doveadm save -u testuser@testdomain
گزارش باگها (BUGS)
گزارش باگها، شامل خروجی doveconf -n را به فهرست پستی Dovecot به نشانی ⟨dovecot@dovecot.org⟩ ارسال کنید. اطلاعات درباره نحوه گزارش باگها در این نشانی در دسترس است: ⟨https://dovecot.org/bugreport.html⟩
همچنین ببینید (SEE ALSO)
doveadm(1)
| May 2026 | e5ac02a |