.TH "DOVEADM-DICT" "1" "May 2026" "e5ac02a" "Dovecot"
.SH "نام (NAME)"
doveadm-mail-dict \- دستورات مربوط به دستکاری دیکشنری در بافت کاربر
.SH "خلاصه دستور (SYNOPSIS)"
.P
\fBdoveadm\fR \[lB]\fIGLOBAL OPTIONS\fR\[rB] \fBdict\fR \fIcommand\fR \[lB]\fB-u\fR \fIuser\fR\[rB] \[lB]\fIOPTIONS\fR\[rB] \fIconfig-filter-name\fR \[lB]\fIargs\fR\[rB]
.P
\fBdoveadm\fR \[lB]\fIGLOBAL OPTIONS\fR\[rB] \fBmail dict\fR \fIcommand\fR \[lB]\fIOPTIONS\fR\[rB] \fIconfig-filter-name\fR \[lB]\fIargs\fR\[rB]
.SH "توضیحات (DESCRIPTION)"
.P
از \fBdoveadm dict\fR و \fBdoveadm mail dict\fR می‌توان برای پرسمان و ویرایش مدخل‌های دیکشنری استفاده کرد.
.P
دستور \fBdoveadm mail dict\fR می‌تواند در بافت یک کاربر مشخص استفاده شود. این قابلیت زمانی مفید است که برای نمونه، جستجوی userdb تنظیمات دیکشنری مخصوص کاربر را بازگرداند. در غیر این صورت، این دستورها رفتار یکسانی دارند.
.P
\fIconfig-filter-name\fR
.RS 0
.RS 4
.P
نام فیلتری که هنگام جستجوی تنظیمات dict استفاده می‌شود؛ برای نمونه \fImail_attribute\fR یا \fIquota_clone\fR. همچنین می‌توان از یک نام فیلتر خالی استفاده کرد و تنظیمات dict را با استفاده از پارامترهای \fB-o\fR مشخص نمود.
.RE 0

.RE 0

.SH "گزینه‌های عمومی (GLOBAL OPTIONS)"
.P
گزینه‌های عمومی 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 را در خط اختصاصی خود چاپ کرده و رکوردها را با نویسهٔ فرم‌فید (\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
گزینه‌های اختصاصی دستور \fBdoveadm dict\fR:
.P
\fB-u\fR \fIuser\fR
.RS 0
.RS 4
.P
کاربری که باید استفاده شود.
.RE 0

.RE 0

.P
گزینه‌های اختصاصی دستور \fBdoveadm mail dict\fR:
.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 با اسکیمای 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-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 داده‌شده اجرا می‌کند. همچنین امکان استفاده از نویسه‌های عام (wildcards) '\fB*\fR' و '\fB?\fR' نیز وجود دارد (مانند ‎-u *@example.org).
.RE 0

.RE 0

.SH "دستورات (COMMANDS)"
.SS "get"
.P
\fBdoveadm\fR \[lB]\fIGLOBAL OPTIONS\fR\[rB] dict get \[lB]\fB-u\fR \fIuser\fR\[rB] \fIconfig-filter-name\fR \fIkey\fR
.P
\fBdoveadm\fR \[lB]\fIGLOBAL OPTIONS\fR\[rB] mail dict get \[lB]\fB-A\fR | \fB-u\fR \fIuser\fR | \fB-F\fR \fIfile\fR\[rB] \[lB]\fB-S\fR \fIsocket_path\fR\[rB] \fIconfig-filter-name\fR \fIkey\fR
.P
واکشی یک کلید از یک دیکشنری.
.P
\fIkey\fR
.RS 0
.RS 4
.P
کلیدی که باید واکشی شود.
.RE 0

.RE 0

.SS "iter"
.P
\fBdoveadm\fR \[lB]\fIGLOBAL OPTIONS\fR\[rB] dict iter \[lB]\fB-u\fR \fIuser\fR\[rB] \[lB]\fB-1RV\fR\[rB] \fIconfig-filter-name\fR \fIprefix\fR
.P
\fBdoveadm\fR \[lB]\fIGLOBAL OPTIONS\fR\[rB] mail dict iter \[lB]\fB-A\fR | \fB-u\fR \fIuser\fR | \fB-F\fR \fIfile\fR\[rB] \[lB]\fB-S\fR \fIsocket_path\fR\[rB] \[lB]\fB-1RV\fR\[rB] \fIconfig-filter-name\fR \fIprefix\fR
.P
یافتن کلیدهای منطبق با یک پیشوند در دیکشنری.
.P
\fB-1\fR
.RS 0
.RS 4
.P
تطابق دقیق.
.RE 0

.RE 0

.P
\fB-R\fR
.RS 0
.RS 4
.P
بازگشتی.
.RE 0

.RE 0

.P
\fB-V\fR
.RS 0
.RS 4
.P
عدم چاپ مقادیر، فقط چاپ نام کلیدها.
.RE 0

.RE 0

.P
\fIprefix\fR
.RS 0
.RS 4
.P
پیشوند کلید برای جستجو.
.RE 0

.RE 0

.P
فهرست کردن کلیدها در دیکشنری.
.SS "inc"
.P
\fBdoveadm\fR \[lB]\fIGLOBAL OPTIONS\fR\[rB] dict inc \[lB]\fB-u\fR \fIuser\fR\[rB] \[lB]\fB-t\fR \fItimestamp-msecs\fR\[rB] \fIconfig-filter-name\fR \fIkey\fR \fIdiff\fR
.P
\fBdoveadm\fR \[lB]\fIGLOBAL OPTIONS\fR\[rB] mail dict inc \[lB]\fB-A\fR | \fB-u\fR \fIuser\fR | \fB-F\fR \fIfile\fR\[rB] \[lB]\fB-S\fR \fIsocket_path\fR\[rB] \[lB]\fB-t\fR \fItimestamp-msecs\fR\[rB] \fIconfig-filter-name\fR \fIkey\fR \fIdiff\fR
.P
افزایش مقدار یک کلید عددی در کلیدهای درون دیکشنری.
.P
\fB-t\fR \fItimestamp-msecs\fR
.RS 0
.RS 4
.P
مهرزمانی (timestamp) را نیز تنظیم می‌کند.
.RE 0

.RE 0

.P
\fIkey\fR
.RS 0
.RS 4
.P
کلیدی که باید مقدار آن افزایش یابد.
.RE 0

.RE 0

.P
\fIdiff\fR
.RS 0
.RS 4
.P
مقدار افزایش.
.RE 0

.RE 0

.SS "set"
.P
\fBdoveadm\fR \[lB]\fIGLOBAL OPTIONS\fR\[rB] dict set \[lB]\fB-u\fR \fIuser\fR\[rB] \[lB]\fB-t\fR \fItimestamp-msecs\fR\[rB] \[lB]\fB-e\fR \fIexpire-secs\fR\[rB] \fIconfig-filter-name\fR \fIkey\fR \fIvalue\fR
.P
\fBdoveadm\fR \[lB]\fIGLOBAL OPTIONS\fR\[rB] mail dict set \[lB]\fB-A\fR | \fB-u\fR \fIuser\fR | \fB-F\fR \fIfile\fR\[rB] \[lB]\fB-S\fR \fIsocket_path\fR\[rB] \[lB]\fB-t\fR \fItimestamp-msecs\fR\[rB] \[lB]\fB-e\fR \fIexpire-secs\fR\[rB] \fIconfig-filter-name\fR \fIkey\fR \fIvalue\fR
.P
تنظیم/ایجاد کلیدها در دیکشنری.
.P
\fB-t\fR \fItimestamp-msecs\fR
.RS 0
.RS 4
.P
مهرزمانی (timestamp) را نیز تنظیم می‌کند.
.RE 0

.RE 0

.P
\fB-e\fR \fIexpire-secs\fR
.RS 0
.RS 4
.P
مدت زمان اعتبار کلید را نیز تنظیم می‌کند.
.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 "unset"
.P
\fBdoveadm\fR \[lB]\fIGLOBAL OPTIONS\fR\[rB] dict unset \[lB]\fB-u\fR \fIuser\fR\[rB] \[lB]\fB-t\fR \fItimestamp-msecs\fR\[rB] \fIconfig-filter-name\fR \fIkey\fR
.P
\fBdoveadm\fR \[lB]\fIGLOBAL OPTIONS\fR\[rB] mail dict unset \[lB]\fB-A\fR | \fB-u\fR \fIuser\fR | \fB-F\fR \fIfile\fR\[rB] \[lB]\fB-S\fR \fIsocket_path\fR\[rB] \[lB]\fB-t\fR \fItimestamp-msecs\fR\[rB] \fIconfig-filter-name\fR \fIkey\fR
.P
حذف یک کلید از دیکشنری.
.P
\fB-t\fR \fItimestamp-msecs\fR
.RS 0
.RS 4
.P
مهرزمانی (timestamp) را نیز تنظیم می‌کند.
.RE 0

.RE 0

.P
\fIkey\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(1)