.TH "DOVEADM-SIEVE" "1" "May 2026" "e5ac02a" "Dovecot"
.SH "نام (NAME)"
\fBdoveadm-sieve\fR \- دستورهای مربوط به مدیریت اسکریپت‌های Sieve
.SH "خلاصه دستور (SYNOPSIS)"
.P
\fBdoveadm\fR \[lB]\fIGLOBAL OPTIONS\fR\[rB] \fIsieve_cmd\fR \[lB]\fIoptions\fR\[rB] \[lB]\fIarguments\fR\[rB]
.SH "توضیحات (DESCRIPTION)"
.P
دستورهای \fBdoveadm sieve\fR بخشی از Pigeonhole (pigeonhole(7)) هستند که پشتیبانی از Sieve (RFC 5228) و ManageSieve (RFC 5804) را به Dovecot (dovecot(1)) اضافه می‌کند.
.P
دستورهای \fBdoveadm sieve\fR می‌توانند برای مدیریت فیلترکردن Sieve استفاده شوند.
.SH "گزینه‌های عمومی (GLOBAL OPTIONS)"
.P
گزینه‌های عمومی doveadm(1) (\fIoptions\fR):
.P
\fB-D\fR
.RS 0
.RS 4
.P
پرگویی (\fIverbosity\fR) و پیام‌های اشکال‌زدایی را فعال می‌کند.
.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

.P
\fB-f\fR \fIformatter\fR
.RS 0
.RS 4
.P
قالب‌بندی‌کننده (\fIformatter\fR) را برای قالب‌بندی خروجی مشخص می‌کند. قالب‌بندی‌کننده‌های پشتیبانی‌شده عبارتند از:
.P
\fBflow\fR
.RS 4
.P
هر خط را با جفت‌های \fIkey\fR\fB=\fR\fIvalue\fR چاپ می‌کند.
.RE 0

.P
\fBjson\fR
.RS 4
.P
یک آرایهٔ JSON از اشیاء JSON چاپ می‌کند.
.RE 0

.P
\fBpager\fR
.RS 4
.P
هر جفت \fIkey\fR: \fIvalue\fR را در خط جداگانه‌ای چاپ کرده و رکوردها را با نویسهٔ فرم‌فید (\fB^L\fR) جدا می‌کند.
.RE 0

.P
\fBtab\fR
.RS 4
.P
یک سربرگ جدول و در ادامه خطوط مقادیرِ جداشده با تب را چاپ می‌کند.
.RE 0

.P
\fBtable\fR
.RS 4
.P
یک سربرگ جدول و در ادامه خطوط مقادیر هم‌تراز شده را چاپ می‌کند.
.RE 0

.RE 0

.RE 0

.SH "گزینه‌ها (OPTIONS)"
.P
\fB-A\fR
.RS 0
.RS 4
.P
اگر گزینهٔ \fB-A\fR موجود باشد، \fIدستور\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
\fIدستور\fR را برای همهٔ کاربران موجود در \fIfile\fR اجرا می‌کند. این مشابه گزینهٔ \fB-A\fR است، اما به‌جای دریافت فهرست کاربران از userdb، آن‌ها از \fIfile\fR داده‌شده خوانده می‌شوند. \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
آرگومان این گزینه یا یک مسیر مطلق به یک سوکت محلی دامنه‌ی یونیکس (UNIX domain socket) است، یا یک نام میزبان و درگاه (\fIhostname\fR:\fIport\fR) برای اتصال به یک میزبان راه دور از طریق سوکت TCP.
.P
این به مدیر سیستم اجازه می‌دهد دستورهای پستی doveadm(1) را از طریق سوکت داده‌شده اجرا کند.
.RE 0

.RE 0

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

.RE 0

.SH "آرگومان‌ها (ARGUMENTS)"
.P
\fIscriptname\fR
.RS 0
.RS 4
.P
نام یک \fIاسکریپت Sieve\fR است، همان‌طور که برای کلاینت‌های ManageSieve قابل مشاهده است.
.P
برای اسکریپت‌های Sieve که روی دیسک ذخیره می‌شوند، این نام فایل بدون پسوند «.sieve» است.
.RE 0

.RE 0

.SH "دستورها (COMMANDS)"
.SS "sieve put"
.P
\fBdoveadm\fR \[lB]\fIGLOBAL OPTIONS\fR\[rB] sieve put \[lB]\fB-A\fR | \fB-u\fR \fIuser\fR | \fB-F\fR \fIfile\fR | \fB--no-userdb-lookup\fR\[rB] \[lB]\fB-S\fR \fIsocket_path\fR\[rB] \[lB]\fB-a\fR\[rB] \fIscriptname\fR
.P
این دستور یک اسکریپت Sieve جدید را در فضای ذخیره‌سازی اسکریپت قرار می‌دهد. اسکریپت از ورودی استاندارد خوانده می‌شود. اگر اسکریپت با موفقیت کامپایل شود، تحت \fIscriptname\fR ارائه‌شده ذخیره می‌شود. اگر گزینهٔ \fB-a\fR موجود باشد، اسکریپت Sieve متعاقباً به عنوان اسکریپت فعال برای اجرا هنگام تحویل علامت‌گذاری می‌شود.
.SS "sieve get"
.P
\fBdoveadm\fR \[lB]\fIGLOBAL OPTIONS\fR\[rB] sieve get \[lB]\fB-A\fR | \fB-u\fR \fIuser\fR | \fB-F\fR \fIfile\fR | \fB--no-userdb-lookup\fR\[rB] \[lB]\fB-S\fR \fIsocket_path\fR\[rB] \fIscriptname\fR
.P
این دستور اسکریپت Sieve با نام \fIscriptname\fR را بازیابی می‌کند.
.SS "sieve delete"
.P
\fBdoveadm\fR \[lB]\fIGLOBAL OPTIONS\fR\[rB] sieve delete \[lB]\fB-A\fR | \fB-u\fR \fIuser\fR | \fB-F\fR \fIfile\fR | \fB--no-userdb-lookup\fR\[rB] \[lB]\fB-S\fR \fIsocket_path\fR\[rB] \[lB]\fB-a\fR\[rB] \fIscriptname\fR ...
.P
این دستور یک یا چند اسکریپت Sieve را حذف می‌کند. اسکریپت حذف‌شده نمی‌تواند اسکریپت فعال باشد، مگر اینکه گزینهٔ \fB-a\fR موجود باشد.
.SS "sieve list"
.P
\fBdoveadm\fR \[lB]\fIGLOBAL OPTIONS\fR\[rB] sieve list \[lB]\fB-A\fR | \fB-u\fR \fIuser\fR | \fB-F\fR \fIfile\fR | \fB--no-userdb-lookup\fR\[rB] \[lB]\fB-S\fR \fIsocket_path\fR\[rB]
.P
اسکریپت‌های Sieve موجود و وضعیت فعال بودن آن‌ها را فهرست می‌کند.
.SS "sieve rename"
.P
\fBdoveadm\fR \[lB]\fIGLOBAL OPTIONS\fR\[rB] sieve rename \[lB]\fB-A\fR | \fB-u\fR \fIuser\fR | \fB-F\fR \fIfile\fR | \fB--no-userdb-lookup\fR\[rB] \[lB]\fB-S\fR \fIsocket_path\fR\[rB] \fIold_name\fR \fInew_name\fR
.P
دستور \fBsieve rename\fR برای تغییر نام اسکریپت Sieve از \fIold_name\fR به \fInew_name\fR استفاده می‌شود.
.SS "sieve activate"
.P
\fBdoveadm\fR \[lB]\fIGLOBAL OPTIONS\fR\[rB] sieve activate \[lB]\fB-A\fR | \fB-u\fR \fIuser\fR | \fB-F\fR \fIfile\fR | \fB--no-userdb-lookup\fR\[rB] \[lB]\fB-S\fR \fIsocket_path\fR\[rB] \fIscriptname\fR
.P
این دستور اسکریپت Sieve با نام \fIscriptname\fR را به عنوان اسکریپت فعال برای اجرا هنگام تحویل علامت‌گذاری می‌کند.
.SS "sieve deactivate"
.P
\fBdoveadm\fR \[lB]\fIGLOBAL OPTIONS\fR\[rB] sieve deactivate \[lB]\fB-A\fR | \fB-u\fR \fIuser\fR | \fB-F\fR \fIfile\fR | \fB--no-userdb-lookup\fR\[rB] \[lB]\fB-S\fR \fIsocket_path\fR\[rB] \fIscriptname\fR
.P
این دستور پردازش Sieve را غیرفعال می‌کند.
.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), dovecot-lda(1), pigeonhole(7)