.TH "DOVECONF" "1" "May 2026" "e5ac02a" "Dovecot" .SH "نام (NAME)" \fBdoveconf\fR \- ابزار برون‌ریزی پیکربندی Dovecot .SH "خلاصه دستور (SYNOPSIS)" .P \fBdoveconf\fR \[lB]\fB-aCdFInPNUwx\fR\[rB] \[lB]\fB-c\fR \fIconfig-file\fR\[rB] \[lB]\fB-f\fR \fIfilter\fR\[rB] .P \fBdoveconf\fR \[lB]\fB-n\fR\[rB] \[lB]\fB-c\fR \fIconfig-file\fR\[rB] \fIsection_name\fR ... .P \fBdoveconf\fR \[lB]\fB-h\fR\[rB] \[lB]\fB-c\fR \fIconfig-file\fR\[rB] \[lB]\fB-f\fR \fIfilter\fR\[rB] \fIsetting_name\fR ... .SH "توضیحات (DESCRIPTION)" .P دستور \fBdoveconf\fR فایل‌های پیکربندی Dovecot را خوانده و تجزیه می‌کند و آن‌ها را به قالبی ساده‌تر که توسط سایر بخش‌های Dovecot استفاده می‌شود، تبدیل می‌نماید. .P تمامی برنامه‌های مستقل، مانند dovecot(1)، ابتدا تنظیمات خود را با اجرای doveconf به دست می‌آورند، مگر اینکه بتوانند تنظیمات را از طریق اتصال به سوکت یونیکس (UNIX socket) پیکربندی دریافت کنند. .P برای مدیران سیستم، \fBdoveconf\fR عمدتاً برای بازرسی پیکربندی فعلی در یک قالب خوانا برای انسان، بررسی تنظیمات منفرد و مقایسه مقادیر پیکربندی‌شده با مقادیر پیش‌فرض آن‌ها مفید است. .P همچنین می‌توان از آن برای بررسی گروه‌های پیکربندی (@groups) از طریق پرس‌وجوی مستقیم آن‌ها استفاده کرد. .SH "گزینه‌ها (OPTIONS)" .P \fB-a\fR .RS 0 .RS 4 .P نمایش تمامی تنظیمات به همراه مقادیر پیکربندی‌شده فعلی آن‌ها. .RE 0 .RE 0 .P \fB-C\fR .RS 0 .RS 4 .P TODO (بررسی پیکربندی کامل). .RE 0 .RE 0 .P \fB-c\fR \fIconfig-file\fR .RS 0 .RS 4 .P خواندن پیکربندی از \fIconfig-file\fR مشخص‌شده. به طور پیش‌فرض از \fI/etc/dovecot/dovecot.conf\fR استفاده خواهد شد. .RE 0 .RE 0 .P \fB-d\fR .RS 0 .RS 4 .P نمایش مقدار پیش‌فرض تنظیم به جای مقدار پیکربندی‌شده فعلی. .P همچنین می‌توان از این گزینه برای نمایش محتویات گروه‌های تنظیمات پیش‌فرض با پرس‌وجوی مستقیم نام گروه استفاده کرد، برای مثال: .P \fBdoveconf -d @mailbox_defaults/english\fR .RE 0 .RE 0 .P \fB-F\fR .RS 0 .RS 4 .P نمایش پیکربندی در یک قالب مبتنی بر فیلتر، یعنی همان شیوه‌ای که Dovecot در ساختار داخلی به آن دسترسی دارد. این گزینه می‌تواند برای اشکال‌زدایی از دلایل کار نکردن پیکربندی طبق انتظار مفید باشد. .P تنظیمات در «struct»های گوناگونی دسته‌بندی می‌شوند که همگی به طور مستقل قابل دسترسی هستند. در خروجی، یک struct جدید با \fB# struct_name\fR آغاز می‌شود. .P مورد بعدی فهرست فیلترها است که با \fB:FILTER\fR و به دنبال آن فیلتر در نحو فیلتر رویداد (event filter syntax) آغاز می‌شود. یک فیلتر خالی با همه موارد مطابقت دارد. فیلترها از انتها به ابتدا پردازش می‌شوند. تنظیمات از نخستین فیلتر منطبق (یعنی آخرین فیلتر در خروجی) دریافت می‌شوند. از آنجا که تمام فیلترها همه تنظیمات را تعریف نکرده‌اند، پردازش تا زمانی که تمام تنظیمات پیدا شوند ادامه می‌یابد. .P فیلترهای فهرست‌های نام‌گذاری‌شده مانند \fBprotocols = imap pop3\fR به صورت \fBprotocol/imap=yes\fR و \fBprotocol/pop3=yes # stop list\fR نمایش داده می‌شوند. عبارت «stop list» به این معناست که این مقدار توسط هیچ‌کدام از فیلترهای منطبق بعدی دستخوش تغییر نمی‌شود. اگر تنظیم به صورت \fBprotocols { imap=yes, pop3=yes }\fR تعریف می‌شد، «stop list» وجود نداشت، زیرا این نوع تعریف صرفاً پروتکل‌ها را اضافه می‌کند، نه اینکه کل فهرست را جایگزین کند. .P گروه‌های تنظیمات در خطوط \fB:INCLUDE\fR گنجانده می‌شوند. موارد include در آخر پردازش می‌شوند، پس از اینکه همه فیلترها اعمال شدند؛ بنابراین تمامی تنظیمات درون این گروه‌ها می‌توانند بازنویسی شوند. .RE 0 .RE 0 .P \fB-f\fR \fIfilter\fR .RS 0 .RS 4 .P نمایش پیکربندی منطبق برای شرط \fIfilter\fR مشخص‌شده. رشته گزینه \fIfilter\fR باید به صورت جفتِ \fIname\fR \fB=\fR \fIvalue\fR داده شود. برای چندین شرط فیلتر، گزینه \fB-f\fR می‌تواند چند بار تکرار شود. .P نام‌های ممکن برای \fIfilter\fR عبارتند از: .RS 4 .P \fBprotocol\fR : پروتکل، مانند imap یا pop3 .RE 0 .RS 4 .P \fBlocal_name\fR : نام میزبان محلی برای تطبیق TLS SNI، مانند mail.example.com. .P این مورد با فیلترهایی مطابقت دارد که بدین صورت پیکربندی شده‌اند: .RS 4 .P \fBlocal_name mail.example.com { # special settings }\fR .RE 0 .RE 0 .RS 4 .P \fBlocal\fR : نام میزبان محلی یا نشانی IP. .P این مورد با فیلترهایی مطابقت دارد که بدین صورت پیکربندی شده‌اند: .RS 4 .P \fBlocal 1.2.3.0/24 { # special settings }\fR .RE 0 .RE 0 .RS 4 .P \fBremote\fR : نام میزبان کارخواه (کلاینت) یا نشانی IP آن. .P این مورد با فیلترهایی مطابقت دارد که بدین صورت پیکربندی شده‌اند: .RS 4 .P \fBremote 1.2.3.0/24 { # special settings }\fR .RE 0 .RE 0 .RE 0 .RE 0 .P \fB-h\fR .RS 0 .RS 4 .P پنهان کردن نام تنظیم و تنها نمایش مقدار آن. .RE 0 .RE 0 .P \fB-I\fR .RS 0 .RS 4 .P TODO (برون‌ریزی config import). .RE 0 .RE 0 .P \fB-n\fR .RS 0 .RS 4 .P تنها نمایش تنظیماتی با مقادیر غیر پیش‌فرض. در صورتی که هیچ پارامتر دیگری مشخص نشود، این رفتار پیش‌فرض است. .RE 0 .RE 0 .P \fB-N\fR .RS 0 .RS 4 .P نمایش تنظیمات با مقادیر غیر پیش‌فرض و مقادیر پیش‌فرضی که به صراحت مقداردهی شده‌اند. .RE 0 .RE 0 .P \fB-s\fR .RS 0 .RS 4 .P نمایش تنظیمات پنهان. تنظیمات پنهان به طور معمول نباید تغییر داده شوند. .RE 0 .RE 0.P \fB-P\fR .RS 0 .RS 4 .P نمایش گذرواژه‌ها و سایر مقادیر حساس. .RE 0 .RE 0 .P \fB-U\fR .RS 0 .RS 4 .P نادیده‌گرفتن تمام تنظیمات ناشناخته در فایل پیکربندی. .RE 0 .RE 0 .P \fB-w\fR .RS 0 .RS 4 .P TODO (پنهان‌کردن هشدارهای منسوخ‌شده). .RE 0 .RE 0 .P \fB-x\fR .RS 0 .RS 4 .P بسط متغیرهای پیکربندی (مانند \fB$ENV:foo\fR) و نمایش محتویات فایل (به‌عنوان مثال از \fBssl_server_key_password =