.TH "DOVEADM-FLAGS" "1" "May 2026" "e5ac02a" "Dovecot"
.SH "نام (NAME)"
doveadm-flags \- افزودن، حذف یا جایگزینی پرچم‌های پیام‌ها
.SH "خلاصه دستور (SYNOPSIS)"
.P
\fBdoveadm\fR \[lB]\fIGLOBAL OPTIONS\fR\[rB] \fBflags\fR \[lB]\fB-S\fR \fIsocket_path\fR\[rB] \fB-A\fR \fIcommand flags\fR \fIsearch_query\fR
.P
\fBdoveadm\fR \[lB]\fIGLOBAL OPTIONS\fR\[rB] \fBflags\fR \[lB]\fB-S\fR \fIsocket_path\fR\[rB] \fB-F\fR \fIfile\fR \fIcommand flags\fR \fIsearch_query\fR
.P
\fBdoveadm\fR \[lB]\fIGLOBAL OPTIONS\fR\[rB] \fBflags\fR \[lB]\fB-S\fR \fIsocket_path\fR\[rB] \fB--no-userdb-lookup\fR \fIcommand flags\fR \fIsearch_query\fR
.P
\fBdoveadm\fR \[lB]\fIGLOBAL OPTIONS\fR\[rB] \fBflags\fR \[lB]\fB-S\fR \fIsocket_path\fR\[rB] \fB-u\fR \fIuser\fR \fIcommand flags\fR \fIsearch_query\fR
.SH "توضیحات (DESCRIPTION)"
.P
این دستور برای مدیریت و تغییر پرچم‌های پیام‌ها به کار می‌رود.
.SH "گزینه‌های سراسری (GLOBAL OPTIONS)"
.P
گزینه‌های سراسری \fIdoveadm\fR(1):
.P
\fB-D\fR
.RS 0
.RS 4
.P
فعال‌سازی پرگویی (verbosity) و پیام‌های اشکال‌زدایی.
.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

.SH "گزینه‌ها (OPTIONS)"
.P
\fB-A\fR
.RS 0
.RS 4
.P
اگر گزینه \fB-A\fR موجود باشد، \fIcommand\fR برای همه کاربران اجرا خواهد شد. استفاده از این گزینه همراه با کاربران سیستمی از \fBuserdb { driver = passwd }\fR توصیه نمی‌شود، زیرا شامل کاربرانی با UID کمتر از مقدار پیکربندی‌شده در تنظیم \fBfirst_valid_uid\fR نیز می‌شود.
.P
هنگام استفاده از ماژول SQL userdb، مطمئن شوید که تنظیم \fBuserdb_sql_iterate_query\fR با ساختار پایگاه داده شما مطابقت دارد.
.P
هنگام استفاده از ماژول LDAP userdb، مطمئن شوید که تنظیمات \fBuserdb_fields\fR و \fBuserdb_ldap_iterate_fields\fR با طرحواره LDAP شما مطابقت دارند. در غیر این صورت doveadm(1) قادر نخواهد بود روی همه کاربران پیمایش انجام دهد.
.RE 0

.RE 0

.P
\fB-F\fR \fIfile\fR
.RS 0
.RS 4
.P
اجرای \fIcommand\fR برای همه کاربران موجود در \fIfile\fR. این گزینه مشابه گزینه \fB-A\fR است، اما به جای دریافت فهرست کاربران از userdb، آن‌ها از \fIfile\fR داده‌شده خوانده می‌شوند. این پرونده در هر خط شامل یک نام کاربری است.
.RE 0

.RE 0

.P
\fB--no-userdb-lookup\fR
.RS 0
.RS 4
.P
عدم جستجو در userdb. از متغیر محیطی \fBUSER\fR برای تعیین نام کاربری استفاده کنید.
.RE 0

.RE 0

.P
\fB-S\fR \fIsocket_path\fR
.RS 0
.RS 4
.P
آرگومان این گزینه یا یک مسیر مطلق به یک سوکت دامنه یونیکس محلی است، یا یک نام میزبان و درگاه (\fIhostname\fR:\fIport\fR) برای اتصال به یک میزبان راه دور از طریق سوکت TCP.
.P
این قابلیت به مدیر سیستم امکان می‌دهد دستورات ایمیل doveadm(1) را از طریق سوکت داده‌شده اجرا کند.
.RE 0

.RE 0

.P
\fB-u\fR \fIuser/mask\fR
.RS 0
.RS 4
.P
اجرای \fIcommand\fR فقط برای \fIuser\fR داده‌شده. همچنین امکان استفاده از نویسه‌های عام '\fB*\fR' و '\fB?\fR' وجود دارد (مانند -u *@example.org).
.RE 0

.RE 0

.SH "آرگومان‌ها (ARGUMENTS)"
.P
\fIflags\fR
.RS 0
.RS 4
.P
پرچم‌های پیام همان‌طور که در RFC 3501، بخش 2.3.2 (ویژگی پرچم‌های پیام) شرح داده شده‌اند: \fB\[rs]Answered\fR، \fB\[rs]Deleted\fR، \fB\[rs]Draft\fR، \fB\[rs]Flagged\fR، \fB\[rs]Recent\fR و \fB\[rs]Seen\fR. و کلیدواژه‌های IMAP شامل \fB$Forwarded\fR، \fB$MDNSent\fR، \fB$SubmitPending\fR و \fB$Submitted\fR یا کلیدواژه‌های تعریف‌شده توسط کاربر، مانند \fBJunk\fR، \fB$NonSpam\fR یا \fB$Label1\fR.
.P
می‌توان یک یا چند پرچم و/یا کلیدواژه را مشخص کرد.
.RE 0

.RE 0

.P
\fIsearch_query\fR
.RS 0
.RS 4
.P
تغییر پرچم‌های پیام‌هایی که با پرس‌وجوی جستجوی داده‌شده مطابقت دارند. برای جزئیات doveadm-search-query(7) را ببینید.
.RE 0

.RE 0

.SH "دستورات (COMMANDS)"
.SS "flags add"
.P
\fBdoveadm\fR \[lB]\fIGLOBAL OPTIONS\fR\[rB] flags add \[lB]\fB-u\fR \fIuser\fR | \fB-A\fR | \fB-F\fR \fIfile\fR | \fB--no-userdb-lookup\fR\[rB] \[lB]\fB-S\fR \fIsocket_path\fR\[rB] \fIflags search_query\fR
.P
این دستور برای افزودن پرچم‌های داده‌شده \fIflags\fR به مجموعه پرچم‌های فعلی استفاده می‌شود.
.SS "flags remove"
.P
\fBdoveadm\fR \[lB]\fIGLOBAL OPTIONS\fR\[rB] flags remove \[lB]\fB-u\fR \fIuser\fR | \fB-A\fR | \fB-F\fR \fIfile\fR | \fB--no-userdb-lookup\fR\[rB] \[lB]\fB-S\fR \fIsocket_path\fR\[rB] \fIflags search_query\fR
.P
برای حذف پرچم‌های داده‌شده \fIflags\fR از مجموعه پرچم‌های فعلی، از این دستور استفاده کنید.
.SS "flags replace"
.P
\fBdoveadm\fR \[lB]\fIGLOBAL OPTIONS\fR\[rB] flags replace \[lB]\fB-u\fR \fIuser\fR | \fB-A\fR | \fB-F\fR \fIfile\fR | \fB--no-userdb-lookup\fR\[rB] \[lB]\fB-S\fR \fIsocket_path\fR\[rB] \fIflags search_query\fR
.P
این دستور برای جایگزینی تمام پرچم‌های فعلی با پرچم‌های داده‌شده \fIflags\fR استفاده می‌شود.
.SH "مثال (EXAMPLE)"
.P
فهرست کردن و تغییر دادن پرچم‌های پیامی با شناسه uid برابر با 81563:
.P
.RS 2
.nf
doveadm fetch -u bob 'uid flags' mailbox dovecot uid 81563
.fi
.RE
.P
.RS 2
.nf
uid: 81563
flags: \[rs]Answered \[rs]Seen NonJunk
.fi
.RE
.P
.RS 2
.nf
doveadm flags remove -u bob NonJunk mailbox dovecot uid 81563
doveadm flags add -u bob '\[rs]Flagged $Forwarded' mailbox dovecot uid 81563
.fi
.RE
.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
doveadm(1)