DOVECOT-LDA(1)                      Dovecot                     DOVECOT-LDA(1)

نام (NAME)
       dovecot-lda - عامل محلی تحویل ایمیل Dovecot

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

توضیحات (DESCRIPTION)
       دستور dovecot-lda یک عامل محلی تحویل ایمیل (Local Mail Delivery Agent)
       است که ایمیل را از یک MTA دریافت کرده و ضمن به‌روز نگه داشتن فایل‌های
       نمایه‌سازی Dovecot، آن را به صندوق پستی کاربر تحویل می‌دهد.

       ویژگی‌های اصلی dovecot-lda عبارتند از:

       •   نمایه‌سازی صندوق پستی هنگام تحویل ایمیل، که باعث دسترسی سریع‌تر به
           صندوق پستی در آینده می‌شود

       •   اعمال سهمیه (quota) توسط افزونهٔ quota

       •   پشتیبانی از زبان Sieve توسط افزونهٔ Pigeonhole sieve


گزینه‌ها (OPTIONS)
       گزینه‌های پذیرفته‌شده توسط dovecot-lda:

       -a address

           نشانی مقصد (مانند user+ext@domain). در صورت مشخص نشدن، پیش‌فرض بر
           اساس تنظیم lda_original_recipient_header تعیین می‌شود.



       -c config_file

           مسیر فایل پیکربندی جایگزین.



       -d username

           نام کاربری (username) مقصد. در صورت ارائه، اطلاعات کاربر از userdb
           جستجو می‌شود. معمولاً برای کاربران مجازی استفاده می‌شود، اما الزامی
           برای کاربران سیستمی نیست.



       -e

           اگر ایمیل رد شود، دلیل رد شدن را در خروجی خطای استاندارد (stderr)
           می‌نویسد و با وضعیت ۷۷ (EX_NOPERM) خارج می‌شود. پیش‌فرض این است که
           ایمیل رد شدن توسط خود برنامه ارسال شود.



       -f envelope_sender

           نشانی فرستندهٔ پاکت (envelope sender). اگر مشخص نشود و داده‌های پیام
           با یک سطر معتبر به سبک mbox یعنی "From " آغاز شود، نشانی از آن
           گرفته می‌شود.



       -k

           در هنگام راه‌اندازی، تمام متغیرهای محیط را پاک نمی‌کند.



       -m mailbox

           صندوق پستی مقصد (پیش‌فرض INBOX است). اگر صندوق پستی وجود نداشته
           باشد، ایجاد نخواهد شد (مگر اینکه تنظیم lda_mailbox_autocreate فعال
           باشد). چنانچه به هر دلیلی ذخیره پیام در mailbox ممکن نباشد، پیام به
           جای آن به INBOX تحویل داده می‌شود.

               •   اگر افزونهٔ Sieve استفاده شود، این صندوق پستی به عنوان صندوق
                   پستی اقدام keep استفاده خواهد شد. همچنین در صورتی که هیچ
                   اسکریپت Sieve وجود نداشته باشد یا اسکریپت به هر دلیلی
                   ناموفق باشد، از آن استفاده می‌شود.

               •   تحویل پیام‌ها به پیشوند فضای نام موجب ذخیره شدن ایمیل در
                   INBOX می‌شود. به عنوان مثال، اگر فضای نام Mail/ را دارید،
                   این قابلیت به شما امکان می‌دهد dovecot-lda -m Mail/$mailbox
                   را مشخص کنید که در آن ایمیل در Mail/$mailbox ذخیره می‌شود یا
                   در صورتی که $mailbox خالی باشد، در INBOX ذخیره می‌گردد.

               •   نام صندوق پستی همان‌گونه که در کلاینت IMAP قابل مشاهده است
                   مشخص می‌شود. برای مثال اگر یک Maildir با پوشهٔ .box.sub/
                   دارید و پیکربندی فضای نام شما شامل تنظیمات namespace_prefix
                   و namespace_separator است، روش صحیح برای تحویل ایمیل به
                   آنجا استفاده از -m INBOX/box/sub می‌باشد.




       -o setting=value

           تنظیم پیکربندی setting را از /etc/dovecot/dovecot.conf و از userdb
           با مقدار داده‌شدهٔ value بازنویسی می‌کند. جهت بازنویسی چندین تنظیم،
           می‌توان گزینهٔ -o را چندین بار مشخص کرد.



       -p path

           مسیر ایمیلی که باید تحویل داده شود به‌جای خواندن از stdin. در صورت
           استفاده از maildir، فایل در صورت امکان به مقصد پیوند سخت (hard
           link) داده می‌شود. این به یک ایمیل اجازه می‌دهد تا با استفاده از
           پیوندهای سخت به چندین کاربر تحویل داده شود، اما در حال حاضر مانع
           به‌روزرسانی فایل کش توسط deliver نیز می‌شود، بنابراین نباید استفاده
           شود مگر اینکه واقعاً لازم باشد.



       -r address

           نشانی نهایی گیرنده پاکت (envelope recipient). مقدار پیش‌فرض آن نشانی
           گزینهٔ -a است، اما اگر برای مثال از نام‌های مستعار استفاده شود یا بخش
           +detail حذف شود، ممکن است متفاوت باشد.



وضعیت خروج (EXIT STATUS)
       دستور dovecot-lda با یکی از مقادیر زیر خارج خواهد شد:

       0

           تحویل با موفقیت انجام شد. (EX_OK)



       64

           پارامتر نامعتبر داده شده است. (EX_USAGE)



       67

           کاربر گیرنده ناشناخته است. (EX_NOUSER)



       77

           گزینهٔ -e استفاده شده و ایمیل رد شد. این مورد معمولاً زمانی رخ می‌دهد
           که سهمیه کاربر تمام شده باشد و quota_full_tempfail = no پیکربندی
           شده باشد. (EX_NOPERM)



       75

           یک شکست موقت رخ داد. این وضعیت تقریباً برای تمام شکست‌ها بازگردانده
           می‌شود. برای جزئیات به فایل لاگ مراجعه کنید. (EX_TEMPFAIL)



فایل‌ها (FILES)
       /etc/dovecot/dovecot.conf

           فایل پیکربندی اصلی Dovecot.



       /etc/dovecot/conf.d/10-mail.conf

           مکان‌های صندوق پستی و فضاهای نام (namespaces).



       /etc/dovecot/conf.d/15-lda.conf

           تنظیمات ویژه LDA.



       /etc/dovecot/conf.d/90-plugin.conf

           تنظیمات ویژه افزونه‌ها (پلاگین‌ها).



       /etc/dovecot/conf.d/90-quota.conf

           پیکربندی سهمیه (Quota).



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

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

       مستندات مرتبط با MTAهای خاص:

       •   پست‌فیکس (Postfix):

           •   postconf(5), transport(5), pipe(8)


       •   اگزیل (Exim):

           •   ⟨https://exim.org/exim-html-
               current/doc/html/spec_html/ch16.html⟩

           •   ⟨https://exim.org/exim-html-
               current/doc/html/spec_html/ch24.html⟩

           •   ⟨https://exim.org/exim-html-
               current/doc/html/spec_html/ch29.html⟩


e5ac02a                            May 2026                     DOVECOT-LDA(1)