.TH "DOVECOT-LDA" "1" "May 2026" "e5ac02a" "Dovecot"
.SH "نام (NAME)"
dovecot\-lda \- عامل محلی تحویل ایمیل Dovecot
.SH "خلاصه دستور (SYNOPSIS)"
.P
\fBdovecot-lda\fR \[lB\]\fB-ek\fR\[rB\] \[lB\]\fB-a\fR \fIaddress\fR\[rB\] \[lB\]\fB-c\fR \fIconfig_file\fR\[rB\] \[lB\]\fB-d\fR \fIusername\fR\[rB\] \[lB\]\fB-f\fR \fIenvelope_sender\fR\[rB\] \[lB\]\fB-m\fR \fImailbox\fR\[rB\] \[lB\]\fB-o\fR \fIsetting=value\fR\[rB\] \[lB\]\fB-p\fR \fIpath\fR\[rB\] \[lB\]\fB-r\fR \fIaddress\fR\[rB\]
.SH "توضیحات (DESCRIPTION)"
.P
دستور \fBdovecot-lda\fR یک عامل محلی تحویل ایمیل (Local Mail Delivery Agent) است که ایمیل را از یک MTA دریافت کرده و ضمن به‌روز نگه داشتن فایل‌های نمایه‌سازی Dovecot، آن را به صندوق پستی کاربر تحویل می‌دهد.
.P
ویژگی‌های اصلی \fBdovecot-lda\fR عبارتند از:
.RS 0
.IP \(bu 4
نمایه‌سازی صندوق پستی هنگام تحویل ایمیل، که باعث دسترسی سریع‌تر به صندوق پستی در آینده می‌شود
.IP \(bu 4
اعمال سهمیه (quota) توسط افزونهٔ quota
.IP \(bu 4
پشتیبانی از زبان Sieve توسط افزونهٔ Pigeonhole sieve
.RE 0

.SH "گزینه‌ها (OPTIONS)"
.P
گزینه‌های پذیرفته‌شده توسط \fBdovecot-lda\fR:
.P
\fB-a\fR \fIaddress\fR
.RS 0
.RS 4
.P
نشانی مقصد (مانند user+ext@domain). در صورت مشخص نشدن، پیش‌فرض بر اساس تنظیم \fBlda_original_recipient_header\fR تعیین می‌شود.
.RE 0

.RE 0

.P
\fB-c\fR \fIconfig_file\fR
.RS 0
.RS 4
.P
مسیر فایل پیکربندی جایگزین.
.RE 0

.RE 0

.P
\fB-d\fR \fIusername\fR
.RS 0
.RS 4
.P
نام کاربری (\fIusername\fR) مقصد. در صورت ارائه، اطلاعات کاربر از userdb جستجو می‌شود. معمولاً برای کاربران مجازی استفاده می‌شود، اما الزامی برای کاربران سیستمی نیست.
.RE 0

.RE 0

.P
\fB-e\fR
.RS 0
.RS 4
.P
اگر ایمیل رد شود، دلیل رد شدن را در خروجی خطای استاندارد (stderr) می‌نویسد و با وضعیت 77 (EX_NOPERM) خارج می‌شود. پیش‌فرض این است که یک ایمیل برگشتی (bounce email) توسط خود برنامه ارسال شود.
.RE 0

.RE 0

.P
\fB-f\fR \fIenvelope_sender\fR
.RS 0
.RS 4
.P
نشانی فرستندهٔ پاکت (envelope sender). اگر مشخص نشود و داده‌های پیام با یک سطر معتبر به سبک mbox یعنی \fB"From "\fR آغاز شود، نشانی از آن گرفته می‌شود.
.RE 0

.RE 0

.P
\fB-k\fR
.RS 0
.RS 4
.P
در هنگام راه‌اندازی، تمام متغیرهای محیطی را پاک نمی‌کند.
.RE 0

.RE 0

.P
\fB-m\fR \fImailbox\fR
.RS 0
.RS 4
.P
صندوق پستی مقصد (پیش‌فرض \fBINBOX\fR است). اگر صندوق پستی وجود نداشته باشد، ایجاد نخواهد شد (مگر اینکه تنظیم \fBlda_mailbox_autocreate\fR فعال باشد). چنانچه به هر دلیلی ذخیره پیام در \fImailbox\fR ممکن نباشد، پیام به جای آن به \fBINBOX\fR تحویل داده می‌شود.
.RS 4
.IP \(bu 4
اگر افزونهٔ Sieve استفاده شود، این صندوق پستی به عنوان صندوق پستی اقدام \fBkeep\fR استفاده خواهد شد. همچنین در صورتی که هیچ اسکریپت Sieve وجود نداشته باشد یا اسکریپت به هر دلیلی ناموفق باشد، از آن استفاده می‌شود.
.IP \(bu 4
تحویل پیام‌ها به پیشوند فضای نام موجب ذخیره شدن ایمیل در INBOX می‌شود. به عنوان مثال، اگر فضای نام \fBMail/\fR را دارید، این قابلیت به شما امکان می‌دهد \fBdovecot-lda -m Mail/$mailbox\fR را مشخص کنید که در آن ایمیل در \fBMail/$mailbox\fR ذخیره می‌شود یا در صورتی که \fB$mailbox\fR خالی باشد، در INBOX ذخیره می‌گردد.
.IP \(bu 4
نام صندوق پستی همان‌گونه که در کلاینت IMAP قابل مشاهده است مشخص می‌شود. برای مثال اگر یک Maildir با پوشهٔ \fB.box.sub/\fR دارید و پیکربندی فضای نام شما شامل تنظیمات \fBnamespace_prefix\fR و \fBnamespace_separator\fR است، روش صحیح برای تحویل ایمیل به آنجا استفاده از \fB-m INBOX/box/sub\fR می‌باشد.
.RE 0

.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

.P
\fB-p\fR \fIpath\fR
.RS 0
.RS 4
.P
مسیر ایمیلی که باید تحویل داده شود به‌جای خواندن از stdin. در صورت استفاده از maildir، فایل در صورت امکان به مقصد پیوند سخت (hard link) داده می‌شود. این به یک ایمیل اجازه می‌دهد تا با استفاده از پیوندهای سخت به چندین کاربر تحویل داده شود، اما در حال حاضر مانع به‌روزرسانی فایل کش توسط deliver نیز می‌شود، بنابراین نباید استفاده شود مگر اینکه واقعاً لازم باشد.
.RE 0

.RE 0

.P
\fB-r\fR \fIaddress\fR
.RS 0
.RS 4
.P
نشانی نهایی گیرندهٔ پاکت (envelope recipient). مقدار پیش‌فرض آن نشانی گزینهٔ \fB-a\fR است، اما اگر برای مثال از نام‌های مستعار استفاده شود یا بخش \fB+detail\fR حذف شود، ممکن است متفاوت باشد.
.RE 0

.RE 0

.SH "وضعیت خروج (EXIT STATUS)"
.P
دستور \fBdovecot-lda\fR با یکی از مقادیر زیر خارج خواهد شد:
.P
\fB0\fR
.RS 0
.RS 4
.P
تحویل با موفقیت انجام شد. (EX_OK)
.RE 0

.RE 0

.P
\fB64\fR
.RS 0
.RS 4
.P
پارامتر نامعتبر داده شده است. (EX_USAGE)
.RE 0

.RE 0

.P
\fB67\fR
.RS 0
.RS 4
.P
کاربر گیرنده ناشناخته است. (EX_NOUSER)
.RE 0

.RE 0

.P
\fB77\fR
.RS 0
.RS 4
.P
گزینهٔ \fB-e\fR استفاده شده و ایمیل رد شد. این مورد معمولاً زمانی رخ می‌دهد که سهمیه کاربر تمام شده باشد و \fBquota_full_tempfail = no\fR پیکربندی شده باشد. (EX_NOPERM)
.RE 0

.RE 0

.P
\fB75\fR
.RS 0
.RS 4
.P
یک شکست موقت رخ داد. این وضعیت تقریباً برای تمام شکست‌ها بازگردانده می‌شود. برای جزئیات به فایل لاگ مراجعه کنید. (EX_TEMPFAIL)
.RE 0

.RE 0

.SH "فایل‌ها (FILES)"
.P
\fI/etc/dovecot/dovecot.conf\fR
.RS 0
.RS 4
.P
فایل پیکربندی اصلی Dovecot.
.RE 0

.RE 0

.P
\fI/etc/dovecot/conf.d/10-mail.conf\fR
.RS 0
.RS 4
.P
مکان‌های صندوق پستی و فضاهای نام (namespaces).
.RE 0

.RE 0

.P
\fI/etc/dovecot/conf.d/15-lda.conf\fR
.RS 0
.RS 4
.P
تنظیمات ویژه LDA.
.RE 0

.RE 0

.P
\fI/etc/dovecot/conf.d/90-plugin.conf\fR
.RS 0
.RS 4
.P
تنظیمات ویژه افزونه‌ها (پلاگین‌ها).
.RE 0

.RE 0

.P
\fI/etc/dovecot/conf.d/90-quota.conf\fR
.RS 0
.RS 4
.P
پیکربندی سهمیه (Quota).
.RE 0

.RE 0

.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
\fBdoveadm\fR(1)
.P
مستندات مرتبط با MTAهای خاص:
.RS 0
.IP \(bu 4
پست‌فیکس (Postfix):
.RS 4
.IP \(bu 4
\fBpostconf\fR(5), \fBtransport\fR(5), \fBpipe\fR(8)
.RE 0

.IP \(bu 4
اگسیم (Exim):
.RS 4
.IP \(bu 4
\fI\(lahttps://exim.org/exim-html-current/doc/html/spec_html/ch16.html\(ra\fR
.IP \(bu 4
\fI\(lahttps://exim.org/exim-html-current/doc/html/spec_html/ch24.html\(ra\fR
.IP \(bu 4
\fI\(lahttps://exim.org/exim-html-current/doc/html/spec_html/ch29.html\(ra\fR
.RE 0

.RE 0