DOVEADM-DICT(1)                     Dovecot                    DOVEADM-DICT(1)

نام (NAME)
       doveadm-mail-dict - دستورات مربوط به دستکاری دیکشنری در بافت کاربر

خلاصه دستور (SYNOPSIS)
       doveadm [GLOBAL OPTIONS] dict command [-u user] [OPTIONS] config-
       filter-name [args]

       doveadm [GLOBAL OPTIONS] mail dict command [OPTIONS] config-filter-name
       [args]

توضیحات (DESCRIPTION)
       از doveadm dict و doveadm mail dict می‌توان برای پرسمان و ویرایش مدخل‌های
       دیکشنری استفاده کرد.

       دستور doveadm mail dict می‌تواند در بافت یک کاربر مشخص استفاده شود. این
       قابلیت زمانی مفید است که برای نمونه، جستجوی userdb تنظیمات دیکشنری
       مخصوص کاربر را بازگرداند. در غیر این صورت، این دستورها رفتار یکسانی
       دارند.

       config-filter-name

           نام فیلتری که هنگام جستجوی تنظیمات dict استفاده می‌شود؛ برای نمونه
           mail_attribute یا quota_clone. همچنین می‌توان از یک نام فیلتر خالی
           استفاده کرد و تنظیمات dict را با استفاده از پارامترهای -o مشخص
           نمود.



گزینه‌های عمومی (GLOBAL OPTIONS)
       گزینه‌های عمومی doveadm(1):

       -D

           پیام‌های پرگویی (verbosity) و اشکال‌زدایی را فعال می‌کند.



       -O

           هیچ فایل پیکربندی‌ای را نمی‌خواند، صرفاً از پیش‌فرض‌ها استفاده می‌کند.
           مقدار تنظیم dovecot_storage_version به‌طور پیش‌فرض روی آخرین نسخه
           قرار دارد، اما می‌توان آن را با -o بازنویسی کرد.



       -k

           تمام محیط را برای doveadm حفظ می‌کند، نه فقط تنظیم
           import_environment را.



       -v

           پرگویی از جمله شمارنده پیشرفت را فعال می‌کند.



       -i instance-name

           در صورت استفاده از چند نمونهٔ Dovecot، فایل پیکربندی را بر اساس نام
           این نمونه انتخاب می‌کند.

           برای اطلاعات بیشتر تنظیم instance_name را ببینید.



       -c config-file

           پیکربندی را از config-file داده‌شده می‌خواند. به‌طور پیش‌فرض ابتدا سوکت
           پیکربندی را می‌خواند و سپس در صورت لزوم به /etc/dovecot/dovecot.conf
           بازمی‌گردد. همچنین می‌توانید این گزینه را به سوکت پیکربندی نمونه‌ای که
           نسخه‌ای سازگار را اجرا می‌کند هدایت کنید.



       -o setting=value

           تنظیم پیکربندی setting را از /etc/dovecot/dovecot.conf و از userdb
           با value داده‌شده بازنویسی می‌کند. به منظور بازنویسی چند تنظیم، گزینهٔ
           -o می‌تواند چندین بار مشخص شود.



       -f formatter

           قالب‌بند (formatter) را برای قالب‌بندی خروجی مشخص می‌کند. قالب‌بندهای
           پشتیبانی‌شده عبارتند از:

           flow

               هر خط را با جفت‌های key=value چاپ می‌کند.


       json

           یک آرایهٔ JSON از اشیاء JSON چاپ می‌کند.


       pager

           هر جفت key: value را در خط اختصاصی خود چاپ کرده و رکوردها را با
           نویسهٔ فرم‌فید (^L) جدا می‌کند.


       tab

           یک سربرگ جدول و به‌دنبال آن خطوط مقادیر جداشده با تب (tab) را چاپ
           می‌کند.


       table

           یک سربرگ جدول و به‌دنبال آن خطوط مقادیر تراز‌شده را چاپ می‌کند.




گزینه‌ها (OPTIONS)
       گزینه‌های اختصاصی دستور doveadm dict:

       -u user

           کاربری که باید استفاده شود.



       گزینه‌های اختصاصی دستور doveadm mail dict:

       -A

           اگر گزینهٔ -A وجود داشته باشد، دستور command برای تمام کاربران انجام
           خواهد شد. استفاده از این گزینه در ترکیب با کاربران سیستمی از userdb
           { driver = passwd } توصیه نمی‌شود، زیرا شامل کاربرانی با UID کمتر از
           مقدار پیکربندی‌شده در تنظیم first_valid_uid نیز می‌شود.

           هنگامی که ماژول SQL userdb استفاده می‌شود، مطمئن شوید که تنظیم
           userdb_sql_iterate_query با طرح پایگاه داده شما مطابقت دارد.

           هنگام استفاده از ماژول LDAP userdb، مطمئن شوید که تنظیمات
           userdb_fields و userdb_ldap_iterate_fields با اسکیمای LDAP شما
           مطابقت دارند. در غیر این صورت doveadm(1) قادر به پیمایش روی تمام
           کاربران نخواهد بود.



       -F file

           دستور command را برای تمام کاربران موجود در file اجرا می‌کند. این
           گزینه مشابه گزینهٔ -A است، با این تفاوت که به‌جای دریافت فهرست
           کاربران از userdb، آن‌ها از file داده‌شده خوانده می‌شوند. این file در
           هر خط شامل یک نام کاربری است.



       -S socket_path

           آرگومان این گزینه یا یک مسیر مطلق به یک سوکت محلی دامنه‌ی یونیکس
           (UNIX domain socket) است، یا یک نام میزبان و درگاه (hostname:port)
           به منظور اتصال به یک میزبان راه‌دور از طریق یک سوکت TCP.

           این به مدیر سیستم اجازه می‌دهد دستورات ایمیل doveadm(1) را از طریق
           سوکت داده‌شده اجرا کند.



       -u user/mask

           دستور command را تنها برای user داده‌شده اجرا می‌کند. همچنین امکان
           استفاده از نویسه‌های عام (wildcards) '*' و '?' نیز وجود دارد (مانند
           ‎-u *@example.org).



دستورات (COMMANDS)
   get
       doveadm [GLOBAL OPTIONS] dict get [-u user] config-filter-name key

       doveadm [GLOBAL OPTIONS] mail dict get [-A | -u user | -F file] [-S
       socket_path] config-filter-name key

       واکشی یک کلید از یک دیکشنری.

       key

           کلیدی که باید واکشی شود.



   iter
       doveadm [GLOBAL OPTIONS] dict iter [-u user] [-1RV] config-filter-name
       prefix

       doveadm [GLOBAL OPTIONS] mail dict iter [-A | -u user | -F file] [-S
       socket_path] [-1RV] config-filter-name prefix

       یافتن کلیدهای منطبق با یک پیشوند در دیکشنری.

       -1

           تطابق دقیق.



       -R

           بازگشتی.



       -V

           عدم چاپ مقادیر، فقط چاپ نام کلیدها.



       prefix

           پیشوند کلید برای جستجو.



       فهرست کردن کلیدها در دیکشنری.

   inc
       doveadm [GLOBAL OPTIONS] dict inc [-u user] [-t timestamp-msecs]
       config-filter-name key diff

       doveadm [GLOBAL OPTIONS] mail dict inc [-A | -u user | -F file] [-S
       socket_path] [-t timestamp-msecs] config-filter-name key diff

       افزایش مقدار یک کلید عددی در کلیدهای درون دیکشنری.

       -t timestamp-msecs

           مهرزمانی (timestamp) را نیز تنظیم می‌کند.



       key

           کلیدی که باید مقدار آن افزایش یابد.



       diff

           مقدار افزایش.



   set
       doveadm [GLOBAL OPTIONS] dict set [-u user] [-t timestamp-msecs] [-e
       expire-secs] config-filter-name key value

       doveadm [GLOBAL OPTIONS] mail dict set [-A | -u user | -F file] [-S
       socket_path] [-t timestamp-msecs] [-e expire-secs] config-filter-name
       key value

       تنظیم/ایجاد کلیدها در دیکشنری.

       -t timestamp-msecs

           مهرزمانی (timestamp) را نیز تنظیم می‌کند.



       -e expire-secs

           مدت زمان اعتبار کلید را نیز تنظیم می‌کند.



       key

           کلیدی که باید تنظیم شود.



       value

           مقداری که باید تنظیم شود.



   unset
       doveadm [GLOBAL OPTIONS] dict unset [-u user] [-t timestamp-msecs]
       config-filter-name key

       doveadm [GLOBAL OPTIONS] mail dict unset [-A | -u user | -F file] [-S
       socket_path] [-t timestamp-msecs] config-filter-name key

       حذف یک کلید از دیکشنری.

       -t timestamp-msecs

           مهرزمانی (timestamp) را نیز تنظیم می‌کند.



       key

           کلیدی که باید حذف شود.



گزارش باگ‌ها (REPORTING BUGS)
       باگ‌ها را به همراه خروجی doveconf -n به فهرست پستی Dovecot به نشانی
       ⟨dovecot@dovecot.org⟩ گزارش دهید. اطلاعات دربارهٔ گزارش باگ‌ها در این
       نشانی در دسترس است: ⟨https://dovecot.org/bugreport.html⟩

همچنین ببینید (SEE ALSO)
       doveadm(1)

e5ac02a                            May 2026                    DOVEADM-DICT(1)