نام (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)