.TH "DOVEADM" "1" "May 2026" "e5ac02a" "Dovecot" .SH "نام (NAME)" \fBdoveadm\fR \- ابزار مدیریت Dovecot .SH "خلاصه دستور (SYNOPSIS)" .P \fBdoveadm\fR \[lB]\fB-DOkv\fR\[rB] \[lB]\fB-i\fR \fIinstance-name\fR\[rB] \[lB]\fB-c\fR \fIconfig-file\fR\[rB] \[lB]\fB-o\fR \fIkey\fR\fB=\fR\fIvalue\fR \[lB] .. \[rB]\[rB] \[lB]\fB-f\fR \fIformatter\fR\[rB] \fIcommand\fR \[lB]\fIcommand_options\fR\[rB] \[lB]\fIcommand_arguments\fR\[rB] .SH "توضیحات (DESCRIPTION)" .P دستور \fBdoveadm\fR ابزار مدیریت Dovecot است. از این ابزار می‌توان برای مدیریت بخش‌های گوناگون Dovecot و همچنین دسترسی به صندوق‌های پستی کاربران استفاده کرد. .P جهت مشاهدهٔ فهرست کاربرد دستورات، دستور \fBdoveadm help\fR را اجرا کنید. .SH "گزینه‌های عمومی (GLOBAL OPTIONS)" .P \fIگزینه‌های\fR عمومی doveadm(1): .P \fB-D\fR .RS 0 .RS 4 .P حالت پرگویی (\fIverbosity\fR) و پیام‌های اشکال‌زدایی را فعال می‌کند. .RE 0 .RE 0 .P \fB-O\fR .RS 0 .RS 4 .P هیچ فایل پیکربندی‌ای خوانده نشود، صرفاً از مقادیر پیش‌فرض استفاده شود. مقدار پیش‌فرض تنظیم \fBdovecot_storage_version\fR برابر با آخرین نسخه است، اما می‌توان با \fB-o\fR آن را بازنویسی کرد. .RE 0 .RE 0 .P \fB-k\fR .RS 0 .RS 4 .P کل محیط را برای doveadm حفظ می‌کند، نه فقط مقدار تنظیم \fBimport_environment\fR را. .RE 0 .RE 0 .P \fB-v\fR .RS 0 .RS 4 .P حالت پرگویی را فعال می‌کند، شامل شمارندهٔ پیشرفت. .RE 0 .RE 0 .P \fB-i\fR \fIinstance-name\fR .RS 0 .RS 4 .P در صورت استفاده از چندین نمونهٔ Dovecot، فایل پیکربندی را بر اساس این نام نمونه انتخاب می‌کند. .P برای اطلاعات بیشتر تنظیم \fBinstance_name\fR را ببینید. .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-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-f\fR \fIformatter\fR .RS 0 .RS 4 .P قالب‌بند (\fIformatter\fR) را برای قالب‌بندی خروجی مشخص می‌کند. قالب‌بندهای پشتیبانی‌شده عبارتند از: .P \fBflow\fR .RS 4 .P هر خط را با جفت‌های \fIkey\fR\fB=\fR\fIvalue\fR چاپ می‌کند. .RE 0 .P \fBjson\fR .RS 4 .P یک آرایهٔ JSON از اشیاء JSON را چاپ می‌کند. .RE 0 .P \fBpager\fR .RS 4 .P هر جفت \fIkey\fR: \fIvalue\fR را در خط اختصاصی خود چاپ کرده و رکوردها را با نویسهٔ form feed (\fB^L\fR) جدا می‌کند. .RE 0 .P \fBtab\fR .RS 4 .P یک سربرگ جدول و در ادامه خطوط مقادیر جدا شده با تب را چاپ می‌کند. .RE 0 .P \fBtable\fR .RS 4 .P یک سربرگ جدول و در ادامه خطوط مقادیر تراز شده را چاپ می‌کند. .RE 0 .RE 0 .RE 0.SH "دستورها (COMMANDS)" .P این دستورها مستقیماً با فرایند اصلی (master process) مربوط به Dovecot کار می‌کنند. .SS "doveadm reload" .P اجبار dovecot(1) به بارگذاری مجدد پیکربندی. .SS "doveadm stop" .P متوقف کردن dovecot(1) و تمام فرایندهای فرزند آن. .SH "دستورهای تکمیلی فرایند اصلی (ADDITIONAL MASTER COMMANDS)" .SS "doveadm config" .P doveconf(1)، برون‌ریزی پیکربندی Dovecot. .SS "doveadm exec" .P doveadm-exec(1)، اجرای آسان دستورها از libexec_dir مربوط به Dovecot. .SS "doveadm instance" .P doveadm-instance(1)، مدیریت فهرست نمونه‌های در حال اجرای Dovecot. .SS "doveadm kick" .P doveadm-kick(1)، قطع اتصال کاربران بر اساس نام کاربری و/یا نشانی IP. .SS "doveadm log" .P doveadm-log(1)، مکان‌یابی، آزمایش یا بازگشایی مجدد فایل‌های گزارش (log) مربوط به Dovecot. .SS "doveadm penalty" .P doveadm-penalty(1)، نمایش جریمه‌های جاری. .SS "doveadm proxy" .P doveadm-proxy(1)، مدیریت اتصالات پروکسی Dovecot. .SS "doveadm who" .P doveadm-who(1)، نمایش کاربرانی که به کارساز Dovecot وارد شده‌اند. .SH "دستورهای احراز هویت (AUTHENTICATION COMMANDS)" .SS "doveadm auth" .P doveadm-auth(1)، آزمایش احراز هویت برای یک کاربر. .SS "doveadm pw" .P doveadm-pw(1)، تولیدکننده درهم‌ساز (hash) گذرواژه Dovecot. .SS "doveadm user" .P doveadm-user(1)، جستجوی اطلاعات کاربر در userdbهای Dovecot. .SH "دستورهای صندوق پستی (MAILBOX COMMANDS)" .SS "doveadm acl" .P doveadm-acl(1)، مدیریت فهرست کنترل دسترسی (ACL). .SS "doveadm altmove" .P doveadm-altmove(1)، انتقال رایانامه‌های منطبق به فضای ذخیره‌سازی جایگزین. .SS "doveadm backup" .P doveadm-sync(1)، ابزار همگام‌سازی یک‌طرفه صندوق پستی Dovecot. .SS "doveadm copy" .P doveadm-move(1)، رونوشت/انتقال پیام‌های منطبق با پرس‌وجوی جستجوی داده‌شده به یک صندوق پستی دیگر. .SS "doveadm deduplicate" .P doveadm-deduplicate(1)، حذف دائمی (expunge) پیام‌های تکراری. .SS "doveadm dump" .P doveadm-dump(1)، برون‌ریزی محتوای نمایه/گزارش باینری صندوق پستی Dovecot. .SS "doveadm expunge" .P doveadm-expunge(1)، حذف دائمی پیام‌های منطبق با پرس‌وجوی جستجوی داده‌شده. .SS "doveadm fetch" .P doveadm-fetch(1)، واکشی پیام‌های منطبق با پرس‌وجوی جستجوی داده‌شده. .SS "doveadm flags" .P doveadm-flags(1)، افزودن، حذف یا جایگزینی پرچم‌های پیام‌ها. .SS "doveadm force-resync" .P doveadm-force-resync(1)، ترمیم صندوق‌های پستی خراب، در صورتی که Dovecot این کار را به‌طور خودکار انجام ندهد. .SS "doveadm fs" .P doveadm-fs(1)، تعامل با سامانه فایل انتزاعی ذخیره‌سازی رایانامه. .SS "doveadm fts" .P doveadm-fts(1)، دستکاری و بازسازی نمایه جستجوی تمام‌متن (FTS). .SS "doveadm import" .P doveadm-import(1)، درون‌ریزی پیام‌های منطبق با پرس‌وجوی جستجوی داده‌شده. .SS "doveadm index" .P doveadm-index(1)، نمایه‌سازی پیام‌ها در یک صندوق پستی مشخص. .SS "doveadm mail fs" .P doveadm-mail-fs(1)، تعامل با سامانه فایل انتزاعی ذخیره‌سازی رایانامه در بستر کاربر. .SS "doveadm mailbox" .P doveadm-mailbox(1)، دستورهای گوناگون مربوط به مدیریت صندوق‌های پستی. .SS "doveadm mailbox cryptokey" .P doveadm-mailbox-cryptokey(1)، مدیریت افزونه رمزنگاری رایانامه (mail crypt plugin). .SS "doveadm move" .P doveadm-move(1)، انتقال پیام‌های منطبق با پرس‌وجوی جستجوی داده‌شده به یک صندوق پستی دیگر. .SS "doveadm purge" .P doveadm-purge(1)، پاکسازی پیام‌های دارای refcount=0 از فایل‌های mdbox. .SS "doveadm quota" .P doveadm-quota(1)، مقداردهی اولیه/محاسبه مجدد یا نمایش میزان سهمیه مصرفی فعلی. .SS "doveadm rebuild" .P doveadm-rebuild(1)، بازسازی فراداده‌های نمایه از روی داده‌های پیام. .SS "doveadm save" .P doveadm-save(1)، ذخیره رایانامه در صندوق‌های پستی کاربران. .SS "doveadm search" .P doveadm-search(1)، نمایش فهرستی از GUIDهای صندوق پستی و UIDهای پیام منطبق با پرس‌وجوی جستجوی داده‌شده. .SS "doveadm stats" .P doveadm-stats(1)، بررسی یا بازنشانی آمارها. .SS "doveadm sync" .P doveadm-sync(1)، ابزار همگام‌سازی دوطرفه صندوق پستی Dovecot..SH "وضعیت خروج (EXIT STATUS)" .P \fBdoveadm\fR با یکی از مقادیر زیر پایان می‌یابد: .P \fB0\fR .RS 0 .RS 4 .P دستور انتخاب‌شده با موفقیت اجرا شد. .RE 0 .RE 0 .P \fB64\fR .RS 0 .RS 4 .P خطا در نحوه استفاده از خط فرمان. .RE 0 .RE 0 .P \fB65\fR .RS 0 .RS 4 .P خطای قالب داده یا امکان‌پذیر نبودن عملیات. .RE 0 .RE 0 .P \fB67\fR .RS 0 .RS 4 .P کاربر وجود ندارد. .RE 0 .RE 0 .P \fB68\fR .RS 0 .RS 4 .P فایل ورودی، نشانی یا منبع دیگر وجود ندارد. .RE 0 .RE 0 .P \fB73\fR .RS 0 .RS 4 .P امکان ایجاد فایل خروجی وجود ندارد. .RE 0 .RE 0 .P \fB75\fR .RS 0 .RS 4 .P یک خطای موقت رخ داد، گزارش‌ها را بررسی کنید. .RE 0 .RE 0 .P \fB76\fR .RS 0 .RS 4 .P خطای پروتکل هنگام اتصال به میزبان راه دور. .RE 0 .RE 0 .P \fB77\fR .RS 0 .RS 4 .P خطای مجوز دسترسی. .RE 0 .RE 0 .P \fB78\fR .RS 0 .RS 4 .P خطای پیکربندی. .RE 0 .RE 0 .P \fB127\fR .RS 0 .RS 4 .P خطای ناشناخته. .RE 0 .RE 0 .SH "محیط (ENVIRONMENT)" .P \fBUSER\fR .RS 0 .RS 4 .P این متغیر محیطی برای تعیین \fIuser\fR به کار می‌رود، در صورتی که دستوری یک \fIuser\fR بپذیرد ولی مقداری برای آن مشخص نشده باشد. .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 مکان‌های صندوق پستی و فضاهای نام. .RE 0 .RE 0 .P \fI/etc/dovecot/conf.d/90-plugin.conf\fR .RS 0 .RS 4 .P تنظیمات اختصاصی افزونه‌ها. .RE 0 .RE 0 .SH "گزارش باگ‌ها (REPORTING BUGS)" .P باگ‌ها را، به همراه خروجی \fIdoveconf -n\fR، به فهرست پستی Dovecot به نشانی \fI\(ladovecot@dovecot.org\(ra\fR گزارش دهید. اطلاعات مربوط به گزارش باگ‌ها در این نشانی در دسترس است: \fI\(lahttps://dovecot.org/bugreport.html\(ra\fR .SH "همچنین ببینید (SEE ALSO)" .P doveadm-help(1)