DOVEADM-FLAGS(1)                    Dovecot                   DOVEADM-FLAGS(1)

نام (NAME)
       doveadm-flags - افزودن، حذف یا جایگزینی پرچم‌های پیام‌ها

خلاصه دستور (SYNOPSIS)
       doveadm [GLOBAL OPTIONS] flags [-S socket_path] -A command flags
       search_query

       doveadm [GLOBAL OPTIONS] flags [-S socket_path] -F file command flags
       search_query

       doveadm [GLOBAL OPTIONS] flags [-S socket_path] --no-userdb-lookup
       command flags search_query

       doveadm [GLOBAL OPTIONS] flags [-S socket_path] -u user command flags
       search_query

توضیحات (DESCRIPTION)
       این دستور برای مدیریت و تغییر پرچم‌های پیام‌ها به کار می‌رود.

گزینه‌های سراسری (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 را چندین بار مشخص کرد.



گزینه‌ها (OPTIONS)
       -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
           داده‌شده خوانده می‌شوند. این پرونده در هر خط شامل یک نام کاربری است.



       --no-userdb-lookup

           عدم جستجو در userdb. از متغیر محیطی USER برای تعیین نام کاربری
           استفاده کنید.



       -S socket_path

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

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



       -u user/mask

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



آرگومان‌ها (ARGUMENTS)
       flags

           پرچم‌های پیام همان‌طور که در RFC 3501، بخش 2.3.2 (ویژگی پرچم‌های پیام)
           شرح داده شده‌اند: \Answered، \Deleted، \Draft، \Flagged، \Recent و
           \Seen. و کلیدواژه‌های IMAP شامل $Forwarded، $MDNSent، $SubmitPending
           و $Submitted یا کلیدواژه‌های تعریف‌شده توسط کاربر، مانند Junk،
           $NonSpam یا $Label1.

           می‌توان یک یا چند پرچم و/یا کلیدواژه را مشخص کرد.



       search_query

           تغییر پرچم‌های پیام‌هایی که با پرس‌وجوی جستجوی داده‌شده مطابقت دارند.
           برای جزئیات doveadm-search-query(7) را ببینید.



دستورات (COMMANDS)
   flags add
       doveadm [GLOBAL OPTIONS] flags add [-u user | -A | -F file | --no-
       userdb-lookup] [-S socket_path] flags search_query

       این دستور برای افزودن پرچم‌های داده‌شده flags به مجموعه پرچم‌های فعلی
       استفاده می‌شود.

   flags remove
       doveadm [GLOBAL OPTIONS] flags remove [-u user | -A | -F file | --no-
       userdb-lookup] [-S socket_path] flags search_query

       برای حذف پرچم‌های داده‌شده flags از مجموعه پرچم‌های فعلی، از این دستور
       استفاده کنید.

   flags replace
       doveadm [GLOBAL OPTIONS] flags replace [-u user | -A | -F file | --no-
       userdb-lookup] [-S socket_path] flags search_query

       این دستور برای جایگزینی تمام پرچم‌های فعلی با پرچم‌های داده‌شده flags
       استفاده می‌شود.

مثال (EXAMPLE)
       فهرست کردن و تغییر دادن پرچم‌های پیامی با شناسه uid برابر با 81563:

         doveadm fetch -u bob 'uid flags' mailbox dovecot uid 81563

         uid: 81563
         flags: \Answered \Seen NonJunk

         doveadm flags remove -u bob NonJunk mailbox dovecot uid 81563
         doveadm flags add -u bob '\Flagged $Forwarded' mailbox dovecot uid 81563

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

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

e5ac02a                            May 2026                   DOVEADM-FLAGS(1)