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 به عنوان مسیر یک فایل تفسیر
                   می‌شود.




مثال (EXAMPLE)
         echo "hello, world" | doveadm save -u testuser@testdomain

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

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

e5ac02a                            May 2026                    DOVEADM-SAVE(1)