.TH "DOVEADM-DICT" "1" "May 2026" "e5ac02a" "Dovecot"
.SH "نام (NAME)"
\fBdoveadm-dict\fR \- دستورهای مربوط به کار با دیکشنری
.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 تنظیمات dict خاص کاربر را بازمی‌گرداند می‌تواند مفید باشد. در غیر این صورت، این دستورها رفتار یکسانی دارند.
.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
\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 را در خط جداگانه‌ای چاپ می‌کند و رکوردها را با نویسهٔ پرش صفحه (\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 "گزینه‌ها (OPTIONS)"
.P
\fIگزینه‌های\fR خاص دستور \fBdoveadm dict\fR:
.P
\fB-u\fR \fIuser\fR
.RS 0
.RS 4
.P
کاربری که باید استفاده شود.
.RE 0

.RE 0

.P
\fIگزینه‌های\fR خاص دستور \fBdoveadm mail dict\fR:
.P
\fB-A\fR
.RS 0
.RS 4
.P
اگر گزینهٔ \fB-A\fR مشخص شده باشد، \fIدستور\fR برای همهٔ کاربران اجرا خواهد شد. استفاده از این گزینه در ترکیب با کاربران سیستمی از \fBuserdb { driver = passwd }\fR توصیه نمی‌شود، زیرا همچنین شامل کاربرانی با UID کمتر از مقدار پیکربندی‌شده در تنظیم \fBfirst_valid_uid\fR است.
.P
هنگامی که ماژول userdb مبتنی بر SQL استفاده می‌شود، اطمینان حاصل کنید که تنظیم \fBuserdb_sql_iterate_query\fR با طرح پایگاه داده (database layout) شما مطابقت داشته باشد.
.P
هنگام استفاده از ماژول userdb مبتنی بر LDAP، اطمینان حاصل کنید که تنظیمات \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
اجرای \fIدستور\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
اجرای \fIدستور\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
واکشی یک کلید از یک واژه‌نامه (dictionary).
.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
برچسب زمانی را نیز تنظیم می‌کند.
.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
برچسب زمانی را نیز تنظیم می‌کند.
.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
برچسب زمانی را نیز تنظیم می‌کند.
.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
\fBdoveadm\fR(1)