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

نام (NAME)
       doveadm-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 تنظیمات dict خاص
       کاربر را بازمی‌گرداند می‌تواند مفید باشد. در غیر این صورت، این دستورها
       رفتار یکسانی دارند.

       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

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


       table

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



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

       -u user

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



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

       -A

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

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

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



       -F file

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



       -S socket_path

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

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



       -u user/mask

           اجرای دستور تنها برای 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

       واکشی یک کلید از یک واژه‌نامه (dictionary).

       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

           پیشوند کلید جهت جستجو.



       فهرست کردن کلیدها در واژه‌نامه..SS "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

           برچسب زمانی را نیز تنظیم می‌کند.



       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

           برچسب زمانی را نیز تنظیم می‌کند.



       -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

           برچسب زمانی را نیز تنظیم می‌کند.



       key

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



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

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

e5ac02a                            May 2026                    DOVEADM-DICT(1)