.TH "DOVEADM-MAILBOX" "1" "May 2026" "e5ac02a" "Dovecot" .SH "نام (NAME)" \fBdoveadm-mailbox\fR \- دستورهای مربوط به مدیریت صندوق‌های پستی .SH "خلاصه دستور (SYNOPSIS)" .P \fBdoveadm\fR \[lB]\fIGLOBAL OPTIONS\fR\[rB] \[lB]\fB-f\fR \fIformatter\fR\[rB] \fImailbox_cmd\fR \[lB]\fIOPTIONS\fR\[rB] \[lB]\fIARGUMENTS\fR\[rB] .SH "توضیحات (DESCRIPTION)" .P از \fBdoveadm mailbox\fR می‌توان برای پرس‌وجو و اصلاح صندوق‌های پستی استفاده کرد. .SH "گزینه‌های عمومی (GLOBAL OPTIONS)" .P \fIگزینه‌های\fR عمومی doveadm(1): .P \fB-D\fR .RS 0 .RS 4 .P \fIپُرگویی\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 را در یک خط مجزا چاپ کرده و رکوردها را با نویسهٔ پیشروی برگه (\fB^L\fR) جدا می‌کند. .RE 0 .P \fBtab\fR .RS 4 .P یک سربرگ جدول و به‌دنبال آن خطوطی از مقادیر جداشده با تب (tab) را چاپ می‌کند. .RE 0 .P \fBtable\fR .RS 4 .P یک سربرگ جدول و به‌دنبال آن خطوطی از مقادیر تراز شده را چاپ می‌کند. .RE 0 .RE 0 .RE 0.SH "گزینه‌ها (OPTIONS)" .P \fB-A\fR .RS 0 .RS 4 .P در صورت استفاده از گزینهٔ \fB-A\fR، \fIcommand\fR برای همهٔ کاربران اجرا خواهد شد. استفاده از این گزینه در ترکیب با کاربران سیستمی برگرفته از \fBuserdb { driver = passwd }\fR توصیه نمی‌شود، زیرا شامل کاربرانی با UID کمتر از مقدار پیکربندی‌شده در تنظیمات \fBfirst_valid_uid\fR نیز می‌شود. .P هنگامی که از ماژول SQL در userdb استفاده می‌شود، اطمینان حاصل کنید که تنظیمات \fBuserdb_sql_iterate_query\fR با ساختار پایگاه‌دادهٔ شما مطابقت دارد. .P هنگام استفاده از ماژول LDAP در userdb، مطمئن شوید که تنظیمات \fBuserdb_fields\fR و \fBuserdb_ldap_iterate_fields\fR با طرحوارهٔ (schema) LDAP شما مطابقت دارند. در غیر این صورت doveadm(1) قادر به پیمایش روی تمام کاربران نخواهد بود. .RE 0 .RE 0 .P \fB-F\fR \fIfile\fR .RS 0 .RS 4 .P اجرای \fIcommand\fR برای همهٔ کاربران موجود در \fIfile\fR. این گزینه مشابه گزینهٔ \fB-A\fR است، با این تفاوت که به جای دریافت فهرست کاربران از userdb، آن‌ها از \fIfile\fR داده‌شده خوانده می‌شوند. این \fIfile\fR در هر سطر شامل یک نام کاربری است. .RE 0 .RE 0 .P \fB--no-userdb-lookup\fR .RS 0 .RS 4 .P جستجو در userdb را انجام ندهید. از متغیر محیطی \fBUSER\fR برای مشخص کردن نام کاربری استفاده کنید. .RE 0 .RE 0 .P \fB-S\fR \fIsocket_path\fR .RS 0 .RS 4 .P آرگومان این گزینه یا یک مسیر مطلق به یک سوکت محلی دامنهٔ یونیکس (UNIX domain socket) است، یا یک نام میزبان و درگاه (\fIhostname\fR:\fIport\fR)، برای اتصال به یک میزبان راه دور از طریق سوکت TCP. .P این به مدیر سیستم امکان می‌دهد دستورهای ایمیل doveadm(1) را از طریق سوکت داده‌شده اجرا کند. .RE 0 .RE 0 .P \fB-u\fR \fIuser/mask\fR .RS 0 .RS 4 .P اجرای \fIcommand\fR تنها برای \fIuser\fR مشخص‌شده. همچنین امکان استفاده از نویسه‌های عام (wildcard) «\fB*\fR» و «\fB?\fR» وجود دارد (مانند -u *@example.org). .RE 0 .RE 0 .SH "آرگومان‌ها (ARGUMENTS)" .P \fImailbox\fR .RS 0 .RS 4 .P نام یک \fImailbox\fR است، همان‌گونه که برای کلاینت‌های IMAP قابل مشاهده است، با این تفاوت که در قالب UTF-8 می‌باشد. جداکنندهٔ سلسله‌مراتبی میان یک صندوق پستی والد و فرزند معمولاً '\fB/\fR' یا '\fB.\fR' است، اما این موضوع به قالب ذخیره‌سازی انتخاب‌شده برای صندوق پستی و پیکربندی namespace شما بستگی دارد. همچنین ممکن است نام‌های صندوق پستی به یک پیشوند namespace نیاز داشته باشند. .RE 0 .RE 0 .SH "دستورها (COMMANDS)" .SS "mailbox create" .P \fBdoveadm\fR \[lB]\fIGLOBAL OPTIONS\fR\[rB] mailbox create \[lB]\fB-A\fR | \fB-u\fR \fIuser\fR | \fB-F\fR \fIfile\fR | \fB--no-userdb-lookup\fR\[rB] \[lB]\fB-S\fR \fIsocket_path\fR\[rB] \[lB]\fB-g\fR \fIguid\fR\[rB] \[lB]\fB-s\fR\[rB] \fImailbox\fR... .P این دستور برای ایجاد یک یا چند صندوق پستی به کار می‌رود. قالب صندوق‌های پستی ایجادشده به تنظیمات \fImail_driver\fR یا فیلد \fImail\fR کاربر که توسط userdb بازگردانده شده، بستگی دارد. .P \fB-g\fR \fIguid\fR .RS 0 .RS 4 .P ایجاد صندوق پستی با GUID مشخص‌شده. .RE 0 .RE 0 .P \fB-s\fR .RS 0 .RS 4 .P هنگامی که این گزینه مشخص شود، صندوق‌های پستی ایجادشده به اشتراک‌های (subscriptions) کاربر نیز افزوده خواهند شد. .RE 0 .RE 0.SS "mailbox cryptokey" .P \fBdoveadm\fR \[lB]\fIGLOBAL OPTIONS\fR\[rB] mailbox cryptokey \fBexport|generate|list|password\fR .P این دستور برای مدیریت کلیدهای رمزنگاری افزونهٔ mail crypt به کار می‌رود. لطفاً برای جزئیات بیشتر به doveadm-mailbox-cryptokey(1) مراجعه کنید. .SS "mailbox delete" .P \fBdoveadm\fR \[lB]\fIGLOBAL OPTIONS\fR\[rB] mailbox delete \[lB]\fB-A\fR | \fB-u\fR \fIuser\fR | \fB-F\fR \fIfile\fR | \fB--no-userdb-lookup\fR\[rB] \[lB]\fB-S\fR \fIsocket_path\fR\[rB] \[lB]\fB-s\fR\[rB] \[lB]\fB-r\fR\[rB] \[lB]\fB-e\fR\[rB] \[lB]\fB-Z\fR\[rB] \fImailbox\fR... .P این دستور یک صندوق پستی را حذف کرده و تمام پیام‌های درون آن را به طور کامل پاکسازی (expunge) می‌کند. اگر صندوق پستی دارای هرگونه زیرمجموعه باشد، حذف نخواهند شد مگر اینکه \fB-r\fR داده شده باشد. .P \fB-r\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-e\fR .RS 0 .RS 4 .P الزام خالی بودن صندوق‌های پستی پیش از اقدام به حذف. .RE 0 .RE 0 .P \fB-Z\fR .RS 0 .RS 4 .P صندوق پستی را تا حد ممکن با بیشترین کارایی حذف می‌کند، اما ممکن است پس از آن وضعیت کاربر کاملاً سازگار (consistent) باقی نماند؛ به عنوان مثال ممکن است سهمیه (quota) نادرست باشد. این گزینه عمدتاً هنگام حذف کامل کاربر مفید است. .RE 0 .RE 0 .SS "mailbox list" .P \fBdoveadm\fR \[lB]\fIGLOBAL OPTIONS\fR\[rB] mailbox list \[lB]\fB-7\fR | \fB-8\fR\[rB] \[lB]\fB-A\fR | \fB-u\fR \fIuser\fR | \fB-F\fR \fIfile\fR | \fB--no-userdb-lookup\fR\[rB] \[lB]\fB-S\fR \fIsocket_path\fR\[rB] \[lB]\fB-s\fR\[rB] \[lB]\fImailbox\fR ...\[rB] .P برای دریافت یک دید کلی از صندوق‌های پستی موجود از این دستور استفاده کنید. همچنین امکان استفاده از نویسه‌های عام (wildcards) در نام \fImailbox\fR وجود دارد. .P هنگامی که گزینهٔ \fB-s\fR مشخص شده باشد، تنها صندوق‌های پستی مشترک‌شده فهرست خواهند شد. اشتراک‌های فهرست‌شده ممکن است شامل صندوق‌های پستی باشند که پیش از این حذف شده‌اند. .P \fB-7\fR .RS 0 .RS 4 .P صندوق‌های پستی را با رمزگذاری mUTF-7 فهرست می‌کند. .RE 0 .RE 0 .P \fB-8\fR .RS 0 .RS 4 .P صندوق‌های پستی را با رمزگذاری UTF-8 فهرست می‌کند. .RE 0 .RE 0 .SS "mailbox metadata list" .P \fBdoveadm\fR \[lB]\fIGLOBAL OPTIONS\fR\[rB] mailbox metadata list \[lB]\fB-A\fR | \fB-u\fR \fIuser\fR | \fB-F\fR \fIfile\fR | \fB--no-userdb-lookup\fR\[rB] \[lB]\fB-S\fR \fIsocket_path\fR\[rB] \[lB]\fB-s\fR\[rB] \[lB]\fB-p\fR\[rB] \fImailbox\fR \[lB]\fIkey-prefix\fR\[rB] .P \fB-s\fR .RS 0 .RS 4 .P امکان تعیین "" را برای \fImailbox\fR فراهم می‌کند که به جای متاداده‌های صندوق پستی، به متاداده‌های سرور اشاره دارد. اگر mailbox چیزی غیر از یک رشتهٔ خالی باشد، این گزینه هیچ تأثیری ندارد. .RE 0 .RE 0 .P \fB-p\fR .RS 0 .RS 4 .P افزودن پیشوند به ابتدای خروجی. .RE 0 .RE 0 .P \fImailbox\fR .RS 0 .RS 4 .P صندوق پستی هدف (اجباری). اگر \fB-s\fR مشخص شده باشد، می‌توان از رشتهٔ خالی "" برای نشان دادن دسترسی به متاداده‌های سرور استفاده کرد. .RE 0 .RE 0 .P \fIkey-prefix\fR .RS 0 .RS 4 .P پیشوند کلید مورد نظر برای جستجو. در صورت عدم تعیین، تمام کلیدها فهرست خواهند شد. .RE 0 .RE 0.SS "mailbox metadata get" .P \fBdoveadm\fR \[lB]\fIGLOBAL OPTIONS\fR\[rB] mailbox metadata get \[lB]\fB-A\fR | \fB-u\fR \fIuser\fR | \fB-F\fR \fIfile\fR | \fB--no-userdb-lookup\fR\[rB] \[lB]\fB-S\fR \fIsocket_path\fR\[rB] \[lB]\fB-s\fR\[rB] \fImailbox\fR \fIkey\fR .P \fB-s\fR .RS 0 .RS 4 .P امکان مشخص کردن "" را برای \fImailbox\fR فراهم می‌کند، که به جای متادیتای صندوق‌های پستی به متادیتای سرور اشاره دارد. اگر mailbox چیزی به جز یک رشته خالی باشد، این گزینه هیچ تاثیری ندارد. .RE 0 .RE 0 .P \fImailbox\fR .RS 0 .RS 4 .P صندوق پستی هدف (اجباری). اگر \fB-s\fR مشخص شده باشد، می‌توان از رشته خالی "" برای اشاره به دسترسی به متادیتای سرور استفاده کرد. .RE 0 .RE 0 .P \fIkey\fR .RS 0 .RS 4 .P کلیدی که باید بازیابی شود. .RE 0 .RE 0 .SS "mailbox metadata set" .P \fBdoveadm\fR \[lB]\fIGLOBAL OPTIONS\fR\[rB] mailbox metadata set \[lB]\fB-A\fR | \fB-u\fR \fIuser\fR | \fB-F\fR \fIfile\fR | \fB--no-userdb-lookup\fR\[rB] \[lB]\fB-S\fR \fIsocket_path\fR\[rB] \[lB]\fB-s\fR\[rB] \fImailbox\fR \fIkey\fR \fIvalue\fR .P \fB-s\fR .RS 0 .RS 4 .P امکان مشخص کردن "" را برای \fImailbox\fR فراهم می‌کند، که به جای متادیتای صندوق‌های پستی به متادیتای سرور اشاره دارد. اگر mailbox چیزی به جز یک رشته خالی باشد، این گزینه هیچ تاثیری ندارد. .RE 0 .RE 0 .P \fImailbox\fR .RS 0 .RS 4 .P صندوق پستی هدف (اجباری). اگر \fB-s\fR مشخص شده باشد، می‌توان از رشته خالی "" برای اشاره به دسترسی به متادیتای سرور استفاده کرد. .RE 0 .RE 0 .P \fIkey\fR .RS 0 .RS 4 .P کلیدی که باید تنظیم شود. .RE 0 .RE 0 .P \fIvalue\fR .RS 0 .RS 4 .P مقداری که باید تنظیم شود. .RE 0 .RE 0 .SS "mailbox metadata unset" .P \fBdoveadm\fR \[lB]\fIGLOBAL OPTIONS\fR\[rB] mailbox metadata unset \[lB]\fB-A\fR | \fB-u\fR \fIuser\fR | \fB-F\fR \fIfile\fR | \fB--no-userdb-lookup\fR\[rB] \[lB]\fB-S\fR \fIsocket_path\fR\[rB] \[lB]\fB-s\fR\[rB] \fImailbox\fR \fIkey\fR .P \fB-s\fR .RS 0 .RS 4 .P امکان مشخص کردن "" را برای \fImailbox\fR فراهم می‌کند، که به جای متادیتای صندوق‌های پستی به متادیتای سرور اشاره دارد. اگر mailbox چیزی به جز یک رشته خالی باشد، این گزینه هیچ تاثیری ندارد. .RE 0 .RE 0 .P \fImailbox\fR .RS 0 .RS 4 .P صندوق پستی هدف (اجباری). اگر \fB-s\fR مشخص شده باشد، می‌توان از رشته خالی "" برای اشاره به دسترسی به متادیتای سرور استفاده کرد. .RE 0 .RE 0 .P \fIkey\fR .RS 0 .RS 4 .P کلیدی که باید حذف (unset) شود. .RE 0 .RE 0.SS "mailbox mutf7" .P \fBdoveadm\fR \[lB]\fIGLOBAL OPTIONS\fR\[rB] mailbox mutf7 \[lB]\fB-7\fR | \fB-8\fR\[rB] \fIname\fR... .P دستور \fBmailbox mutf7\fR می‌تواند برای تبدیل \fIname\fR بین‌المللی صندوق پستی به یک نسخهٔ اصلاح‌شده از کدگذاری UTF-7 و برعکس به کار رود. RFC 3501 (Mailbox International Naming Convention) را ببینید. .P \fB-7\fR .RS 0 .RS 4 .P نشان می‌دهد که بازنمایی رشته‌ای \fIname\fR با mUTF-7 کدگذاری شده است و باید به UTF-8 تبدیل شود. .RE 0 .RE 0 .P \fB-8\fR .RS 0 .RS 4 .P نشان می‌دهد که \fIname\fR با UTF-8 کدگذاری شده است و باید به mUTF-7 تبدیل شود (پیش‌فرض). .RE 0 .RE 0 .P \fIname\fR .RS 0 .RS 4 .P یک یا چند نام صندوق پستی که باید تبدیل شوند. .RE 0 .RE 0 .SS "mailbox path" .P \fBdoveadm\fR \[lB]\fIGLOBAL OPTIONS\fR\[rB] mailbox path \[lB]\fB-A\fR | \fB-u\fR \fIuser\fR | \fB-F\fR \fIfile\fR | \fB--no-userdb-lookup\fR\[rB] \[lB]\fB-S\fR \fIsocket_path\fR\[rB] \[lB]\fB-s\fR\[rB] \[lB]\fB-t\fR \fItype\fR\[rB] \fImailbox\fR .P دستور \fBmailbox path\fR مسیر سیستم‌فایل را برای صندوق پستی مشخص‌شده بازمی‌گرداند. این مسیر به طور پیش‌فرض، مسیر دایرکتوری «index» است. .P \fB-t\fR \fItype\fR .RS 0 .RS 4 .P مسیر مربوط به این نوع مکان صندوق پستی را خروجی می‌دهد. یکی از موارد زیر: .RS 4 .IP \(bu 4 \fBalt-dir\fR .IP \(bu 4 \fBalt-mailbox\fR .IP \(bu 4 \fBcontrol\fR .IP \(bu 4 \fBdir\fR .IP \(bu 4 \fBindex\fR (پیش‌فرض) .IP \(bu 4 \fBindex-cache\fR .IP \(bu 4 \fBindex-private\fR .IP \(bu 4 \fBlist-index\fR .IP \(bu 4 \fBmailbox\fR .RE 0 .RE 0 .RE 0 .P \fImailbox\fR .RS 0 .RS 4 .P صندوق پستی مورد نظر برای پرس‌وجو (اجباری). .RE 0 .RE 0.SS "mailbox rename" .P \fBdoveadm\fR \[lB]\fIGLOBAL OPTIONS\fR\[rB] mailbox rename \[lB]\fB-A\fR | \fB-u\fR \fIuser\fR | \fB-F\fR \fIfile\fR | \fB--no-userdb-lookup\fR\[rB] \[lB]\fB-S\fR \fIsocket_path\fR\[rB] \[lB]\fB-s\fR\[rB] \fIold_name\fR \fInew_name\fR .P دستور \fBmailbox rename\fR برای تغییر نام صندوق پستی \fIold_name\fR به \fInew_name\fR به کار می‌رود. .P هنگامی که گزینهٔ \fB-s\fR داده شود، اشتراک \fIold_name\fR لغو شده و \fInew_name\fR مشترک می‌شود. .SS "mailbox status" .P \fBdoveadm\fR \[lB]\fIGLOBAL OPTIONS\fR\[rB] mailbox status \[lB]\fB-A\fR | \fB-u\fR \fIuser\fR | \fB-F\fR \fIfile\fR | \fB--no-userdb-lookup\fR\[rB] \[lB]\fB-S\fR \fIsocket_path\fR\[rB] \[lB]\fB-t\fR\[rB] \fIfields\fR \fImailbox\fR... .P نمایش \fBstatus\fR (وضعیت) یک یا چند صندوق پستی. نام \fImailbox\fR می‌تواند شامل نویسه‌های عامه‌نما (wildcards) نیز باشد. .P این دستور به‌طور پیش‌فرض از قالب‌بند خروجی (\fIformatter\fR) \fBflow\fR استفاده می‌کند. .P \fB-t\fR .RS 0 .RS 4 .P جمع‌بندی مقادیر فیلدهای (\fIfields\fR) وضعیت \fBmessages\fR، \fBrecent\fR، \fBunseen\fR و/یا \fBvsize\fR چند صندوق پستی در قالب یک مجموع کل (total). .RE 0 .RE 0 .P \fBfields\fR .RS 0 .RS 4 .P مشخص کردن فیلدهای (\fIfields\fR) وضعیتی که باید نمایش داده شوند. .P به منظور مشخص کردن چندین فیلد وضعیت، آن‌ها را داخل علامت نقل‌قول قرار دهید. .RS 4 .P \fBall\fR : این یک نام فیلد وضعیت ویژه است. به معنای نمایش تمام فیلدهای (\fIfields\fR) زیر است. هنگامی که گزینهٔ \fB-t\fR وجود داشته باشد، به معنای نمایش تنها فیلدهای \fBmessages\fR، \fBrecent\fR، \fBunseen\fR و \fBvsize\fR است. .RE 0 .RS 4 .P \fBguid\fR : شناسهٔ یکتای سراسری (globally unique identifier) صندوق پستی (\fImailbox\fR). .RE 0 .RS 4 .P \fBhighestmodseq\fR : بالاترین مقدار توالی تغییرات (mod-sequence) در بین تمام پیام‌های موجود در \fImailbox\fR. .RE 0 .RS 4 .P \fBmessages\fR : تعداد پیام‌های موجود در \fImailbox\fR. .RE 0 .RS 4 .P \fBdeleted\fR : تعداد پیام‌هایی که پرچم \[rs]Deleted برای آن‌ها تنظیم شده است. .RE 0 .RS 4 .P \fBrecent\fR : تعداد پیام‌هایی که پرچم \[rs]Recent برای آن‌ها تنظیم شده است. .RE 0 .RS 4 .P \fBuidnext\fR : مقدار شناسهٔ یکتای بعدی. .RE 0 .RS 4 .P \fBuidvalidity\fR : مقدار اعتبار شناسهٔ یکتا (unique identifier validity). .RE 0 .RS 4 .P \fBunseen\fR : شماره توالی پیام مربوط به نخستین پیام دیده‌نشده در \fImailbox\fR. .RE 0 .RS 4 .P \fBvsize\fR : اندازهٔ مجازی \fImailbox\fR، محاسبه‌شده با پایان‌دهنده‌های خط CRLF. .RE 0 .RS 4 .P \fBfirstsaved\fR : زمان ذخیره شدن نخستین نامه در صندوق پستی. .RE 0 .RE 0 .RE 0.SS "mailbox subscribe" .P \fBdoveadm\fR \[lB]\fIGLOBAL OPTIONS\fR\[rB] mailbox subscribe \[lB]\fB-A\fR | \fB-u\fR \fIuser\fR | \fB-F\fR \fIfile\fR | \fB--no-userdb-lookup\fR\[rB] \[lB]\fB-S\fR \fIsocket_path\fR\[rB] \fImailbox\fR \fI...\fR .P از این دستور برای مشترک شدن در یک یا چند صندوق پستی استفاده می‌شود. .SS "mailbox unsubscribe" .P \fBdoveadm\fR \[lB]\fIGLOBAL OPTIONS\fR\[rB] mailbox unsubscribe \[lB]\fB-A\fR | \fB-u\fR \fIuser\fR | \fB-F\fR \fIfile\fR | \fB--no-userdb-lookup\fR\[rB] \[lB]\fB-S\fR \fIsocket_path\fR\[rB] \fImailbox\fR \fI...\fR .P از این دستور برای لغو اشتراک یک یا چند صندوق پستی استفاده می‌شود. .SS "mailbox update" .P \fBdoveadm\fR \[lB]\fIGLOBAL OPTIONS\fR\[rB] mailbox update \[lB]\fB-A\fR | \fB-u\fR \fIuser\fR | \fB-F\fR \fIfile\fR | \fB--no-userdb-lookup\fR\[rB] \[lB]\fB-S\fR \fIsocket_path\fR\[rB] \[lB]\fB--mailbox-guid\fR \fIguid\fR\[rB] \[lB]\fB--uid-validity\fR \fIuid\fR\[rB] \[lB]\fB--min-next-uid\fR \fIuid\fR\[rB] \[lB]\fB--min-first-recent-uid\fR \fIuid\fR\[rB] \[lB]\fB--min-highest-modseq\fR \fIseq\fR\[rB] \[lB]\fB--min-highest-pvt-modseq\fR \fIseq\fR\[rB] \fImailbox\fR \fI...\fR .P این دستور برای تنظیم مقادیر UID validity، UID بعدی (next UID)، نخستین UID اخیر (first recent UID) و مقادیر دنباله تغییرات (modification sequence) به کار می‌رود. .P معمولاً این دستور تنها در زمان مهاجرت (migration) یا بازیابی صندوق پستی پس از بروز فاجعه استفاده می‌شود. تغییر و تنظیم این مقادیر به‌هیچ‌وجه توصیه نمی‌شود و در تمام زیرساخت‌های ذخیره‌سازی ایمیل (mail backends) نیز پشتیبانی نمی‌شود. .SS "mailbox cache purge" .P \fBdoveadm\fR \[lB]\fIGLOBAL OPTIONS\fR\[rB] mailbox cache purge \[lB]\fB-A\fR | \fB-u\fR \fIuser\fR | \fB-F\fR \fIfile\fR | \fB--no-userdb-lookup\fR\[rB] \[lB]\fB-S\fR \fIsocket_path\fR\[rB] \fImailbox\fR \fI...\fR .P پاک‌سازی فایل dovecot.index.cache. مهم‌ترین کاربرد این دستور، آزادسازی فضای دیسک از ایمیل‌هایی است که پیش‌تر حذف شده‌اند. معمولاً نیازی به اجرای دستی این دستور نیست، چرا که عملیات فشرده‌سازی به‌صورت خودکار نیز اجرا می‌شود. .SS "mailbox cache decision" .P \fBdoveadm\fR \[lB]\fIGLOBAL OPTIONS\fR\[rB] mailbox cache decision \[lB]\fB-A\fR | \fB-u\fR \fIuser\fR | \fB-F\fR \fIfile\fR | \fB--no-userdb-lookup\fR\[rB] \[lB]\fB-S\fR \fIsocket_path\fR\[rB] \[lB]\fB--all\fR\[rB] \[lB]\fB--fields\fR \fIlist of fields\fR\[rB] \[lB]\fB--last-used\fR \fIunix timestamp\fR\[rB] \[lB]\fB--decision\fR \fIno|temp|yes\fR\[rB] \fImailbox\fR \fI...\fR .P این دستور برای فهرست‌کردن یا تغییر تصمیم‌گیری‌های حافظه موقت (caching decisions) برای فیلد(ها) در صندوق(های) پستی استفاده می‌شود. می‌توانید با صرف‌نظر کردن از پارامترهای decision و last-used، تصمیمات فعلی را فهرست کنید. .P \fB--all\fR .RS 0 .RS 4 .P فهرست‌کردن یا تغییر تمامی فیلدها. .RE 0 .RE 0 .P \fB--fields\fR .RS 0 .RS 4 .P فهرست‌کردن یا تغییر این فیلدها که با ویرگول یا فاصله از یکدیگر جدا شده‌اند. .RE 0 .RE 0 .P \fB--decision\fR .RS 0 .RS 4 .P تنظیم تصمیم ذخیره‌سازی فیلد در حافظه موقت. مقدار Yes به این معنی است که همیشه در حافظه موقت ذخیره می‌شود. Temp به معنای ذخیره‌سازی موقت و مشروط است. No بدین معنی است که فیلد در حافظه موقت ذخیره نمی‌شود. .RE 0 .RE 0 .P \fB--last-used\fR .RS 0 .RS 4 .P تنظیم برچسب زمانی (timestamp) آخرین استفاده از فیلد. .RE 0 .RE 0 .P نکته: از این دستور نمی‌توان برای افزودن فیلدهای جدید به حافظه موقت (cache) استفاده کرد! ابتدا باید آن‌ها را در پیکربندی تعریف کنید. تنظیم کش روی no فیلد را بلافاصله از حافظه موقت حذف نمی‌کند، بلکه افزودن آن به حافظه موقت را متوقف می‌سازد. .SS "mailbox cache remove" .P \fBdoveadm\fR \[lB]\fIGLOBAL OPTIONS\fR\[rB] mailbox cache remove \[lB]\fB-A\fR | \fB-u\fR \fIuser\fR | \fB-F\fR \fIfile\fR | \fB--no-userdb-lookup\fR\[rB] \[lB]\fB-S\fR \fIsocket_path\fR\[rB] \fIsearch query\fR .P حذف هرگونه ایمیل(های) منطبق از حافظه موقت (cache). .P هشدار! این دستور می‌تواند تمام داده‌های ذخیره‌شده در حافظه موقت را پاک کند و باعث کندی سیستم شود. .P برای اطلاع از ساختار دستوری عبارت جستجو، \fBdoveadm\-search\-query\fR(7) را ببینید. .SH "مثال‌ها (EXAMPLES)" .P فهرست‌کردن صندوق‌های پستیِ مشترک‌شدهٔ کاربر bob که با 'dovecot' آغاز می‌شوند: .P .RS 2 .nf doveadm mailbox list -s -u bob dovecot\[rs]* .fi .RE .P .RS 2 .nf dovecot dovecot/pigeonhole dovecot/pigeonhole/2.0 .fi .RE .P مشاهده وضعیت صندوق‌های پستی dovecot متعلق به کاربر bob: .P .RS 2 .nf doveadm -f table mailbox status -u bob "messages vsize" dovecot\[rs]* .fi .RE .P .RS 2 .nf mailbox messages vsize dovecot 20501 93968492 dovecot/pigeonhole 0 0 dovecot/pigeonhole/2.0 47 323474 .fi .RE .P تبدیل نام بین‌المللی یک صندوق پستی از mUTF-7 به UTF-8 و برعکس: .P .RS 2 .nf doveadm mailbox mutf7 -7 "~peter/mail/&U,BTFw-/&ZeVnLIqe-" .fi .RE .P .RS 2 .nf ~peter/mail/台北/日本語 .fi .RE .P .RS 2 .nf doveadm mailbox mutf7 ~peter/mail/台北/日本語 .fi .RE .P .RS 2 .nf ~peter/mail/&U,BTFw-/&ZeVnLIqe- .fi .RE.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(1)