.\" Copyright (c) 2010-2018 Pigeonhole authors, see the included COPYING file
.TH "SIEVE\-FILTER" 1 "2016-04-05" "Pigeonhole for Dovecot v2.4" "Pigeonhole"
.SH "نام (NAME)"
sieve\-filter \- ابزار پالایش صندوق پستی Sieve متعلق به Pigeonhole

.PP
\fBهشدار: \fRاین ابزار هنوز آزمایشی است. این راهنما را با دقت بخوانید و پیش از استفاده از این ابزار، از هر ایمیل مهمی پشتیبان تهیه کنید. همچنین توجه داشته باشید که برخی از قابلیت‌های مستندشده در اینجا هنوز پیاده‌سازی نشده‌اند؛ این موارد در جای مناسب به روشنی مشخص شده‌اند.
.\"------------------------------------------------------------------------
.SH "خلاصه دستور (SYNOPSIS)"
.B sieve\-filter
.RI [ options ]
.I script\-file
.I source\-mailbox
.RI [ discard\-action ]
.SH "توضیحات (DESCRIPTION)"
.PP
دستور \fBsieve\-filter\fP بخشی از پروژهٔ Pigeonhole (\fBpigeonhole\fR(7)) است که پشتیبانی از Sieve (RFC 5228) را به کارگزار امن IMAP و POP3 موسوم به Dovecot (\fBdovecot\fR(1)) اضافه می‌کند.
.PP
زبان Sieve در اصل برای پالایش پیام‌ها هنگام تحویل طراحی شده بود. با این حال، مواقعی وجود دارد که پالایش پیام‌های از پیش ذخیره‌شده در یک صندوق پستی مطلوب است، به عنوان مثال زمانی که یک باگ در اسکریپت Sieve باعث تحویل نادرست پیام‌های زیادی شده باشد. با استفاده از ابزار sieve\-filter، اعمال یک اسکریپت Sieve روی همهٔ پیام‌های موجود در یک \fIsource\-mailbox\fP مشخص امکان‌پذیر می‌شود؛ که امکان حذف پیام‌ها، ذخیرهٔ آن‌ها در صندوق پستی دیگر، تغییر محتوای آن‌ها، و تغییر پرچم‌ها و کلیدواژه‌های اختصاص‌یافتهٔ IMAP را فراهم می‌سازد. تلاش‌ها برای ارسال پیام‌ها به دنیای بیرون به دلایل واضح به طور پیش‌فرض نادیده گرفته می‌شوند، اما با استفاده از گزینه‌های مناسب خط فرمان، امکان دریافت و مدیریت ایمیل‌های خروجی نیز وجود دارد.
.PP
اگر هیچ گزینه‌ای مشخص نشود، دستور sieve\-filter در حالت شبیه‌سازی اجرا می‌شود که در آن فقط آنچه قرار است انجام شود را چاپ می‌کند، بدون اینکه عملاً کاری انجام دهد. از گزینهٔ \fB\-e\fP برای فعال‌سازی اجرای واقعی اسکریپت استفاده کنید. همچنین، \fIsource\-mailbox\fP به طور پیش‌فرض فقط‌خواندنی باز می‌شود، به این معنی که معمولاً همیشه دست‌نخورده باقی می‌ماند. از گزینهٔ \fB\-W\fP برای مجاز کردن تغییرات در \fIsource\-mailbox\fP استفاده کنید.
.PP
حتی با فعال بودن گزینهٔ \fB\-W\fP، پیام‌ها در \fIsource\-mailbox\fP تنها ممکن است اصلاح شوند یا به پوشهٔ دیگری انتقال یابند. پیام‌ها هرگز از بین نمی‌روند مگر اینکه آرگومان \fIdiscard\-action\fP غیر از \fBkeep\fP (پیش‌فرض) مشخص شده باشد. اگر پالایهٔ Sieve تصمیم به ذخیرهٔ پیام در \fIsource\-mailbox\fP بگیرد (جایی که پیام از قبل در آنجا وجود دارد)، پیام هرگز در آنجا تکرار نمی‌شود. در این حالت، در صورت مشخص بودن \fB\-W\fP، پرچم‌های IMAP پیام اصلی می‌توانند توسط مفسر Sieve با استفاده از افزونهٔ \fIimap4flags\fP اصلاح شوند. اگر خود پیام توسط مفسر Sieve ویرایش شود (مثلاً با استفاده از افزونهٔ \fIeditheader\fP)، یک پیام جدید ذخیره شده و پیام قدیمی پاکسازی (expunge) می‌شود. با این حال، اگر \fB-W\fP مشخص نشود، پیام اصلی دست‌نخورده باقی می‌ماند و تغییرات دور ریخته می‌شوند.

.SS "احتیاط (CAUTION)"
اگرچه این ابزار بسیار کاربردی است، در صورت استفادهٔ نادرست می‌تواند بسیار مخرب نیز باشد. یک باگ کوچک در اسکریپت Sieve شما به همراه گزینه‌های اشتباه خط فرمان می‌تواند باعث دور ریخته شدن ایمیل‌های نادرست شود. و حتی اگر \fIsource\-mailbox\fP در حالت فقط‌خواندنی باز شود تا از چنین اتفاقاتی جلوگیری شود، باز هم اگر اسکریپت Sieve شما چنین تصمیمی بگیرد، می‌تواند سایر صندوق‌های پستی را با رونوشت‌های زائد از ایمیل‌هایتان پر کند. بنابراین به کاربران توصیه می‌شود این راهنما را با دقت مطالعه کنند و ابتدا از حالت شبیه‌سازی برای بررسی عملکرد اسکریپت بهره ببرند. و البته:
.PP
\fBتهیهٔ پشتیبان برای هرگونه ایمیل مهم امری حیاتی است!\fP

.\"------------------------------------------------------------------------
.SH "گزینه‌ها (OPTIONS)"
.TP
.BI \-c\  config\-file
مسیر جایگزین فایل پیکربندی Dovecot.
.TP
.B \-C
اجبار به کامپایل. به طور پیش‌فرض، باینری کامپایل‌شده روی دیسک ذخیره می‌شود. زمانی که این باینری در اجرای بعدی \fBsieve\-filter\fP یافت شود و زمان تغییر آن جدیدتر از فایل اسکریپت باشد، از همان استفاده شده و اسکریپت دوباره کامپایل نمی‌شود. این گزینه اسکریپت را مجبور به کامپایل می‌کند و در نتیجه هر باینری موجود را نادیده می‌گیرد. برای اطلاعات بیشتر دربارهٔ کامپایل Sieve به \fBsievec\fP(1) مراجعه کنید.
.TP
.B \-D
فعال‌سازی اشکال‌زدایی (debugging) مربوط به Sieve.
.TP
.B \-e
فعال کردن حالت اجرا. به طور پیش‌فرض، دستور sieve\-filter در حالت شبیه‌سازی اجرا می‌شود که در آن چیزی تغییر نمی‌کند؛ بدین معنا که هیچ صندوق پستی به هیچ شکلی دستکاری نمی‌شود و هیچ اقدامی صورت نمی‌گیرد. این حالت تنها کاری را که قرار است انجام شود چاپ می‌کند. با استفاده از این گزینه، دستور sieve\-filter فعال شده و اقدامات درخواستی را به انجام می‌رساند.
.TP
.BI \-m\  default\-mailbox
صندوق پستی‌ای که اقدام (ضمنی) \fBkeep\fP در Sieve پیام‌ها را در آن ذخیره می‌کند. این گزینه به طور پیش‌فرض با \fIsource\-mailbox\fP برابر است. تعیین یک پوشهٔ متفاوت، باعث انتقال (یا رونوشت‌برداری در صورت ذکر نشدن \fB\-W\fP) تمام پیام‌های نگه‌داشته‌شده به پوشهٔ مشخص‌شده می‌شود، به جای آنکه صرفاً در \fIsource\-mailbox\fP باقی بمانند. برای اطلاعات بیشتر دربارهٔ نام‌گذاری صندوق‌های پستی به توضیحات آرگومان \fIsource\-mailbox\fP مراجعه کنید.
.TP
.BI \-o\  setting = value
تنظیم پیکربندی
.I setting
از فایل
.I /usr/etc/dovecot/dovecot.conf
و از userdb را با
.IR value
مشخص‌شده بازنویسی (override) می‌کند. برای بازنویسی چندین تنظیم، گزینهٔ
.B \-o
می‌تواند چندین بار تکرار شود.
.TP
.BI \-q\  output\-mailbox\  \fB[هنوز\ پیاده‌سازی\ نشده]\fP
ذخیرهٔ ایمیل خروجی در \fIoutput\-mailbox\fP مشخص‌شده. به طور پیش‌فرض، دستور sieve\-filter اقدام‌های Sieve مانند redirect، reject، vacation و notify را نادیده می‌گیرد، اما با استفاده از این گزینه می‌توان پیام‌های خروجی را به صندوق پستی مشخص‌شده ضمیمه کرد. این گزینه در حالت شبیه‌سازی تأثیری ندارد. پرچم‌های پیام‌های بازهدایت‌شده حفظ نمی‌شوند.
.TP
.BI \-Q\  mail\-command\  \fB[هنوز\ پیاده‌سازی\ نشده]\fP
ارسال ایمیل خروجی (مثلاً آن‌هایی که توسط redirect، reject و vacation تولید شده‌اند) از طریق برنامهٔ مشخص‌شده. به طور پیش‌فرض، دستور sieve\-filter اقدام‌های Sieve مانند redirect، reject، vacation و notify را نادیده می‌گیرد، اما با استفاده از این گزینه می‌توان پیام‌های خروجی را به \fBstdin\fP یک دستور شل خارجی فرستاد. این گزینه در حالت شبیه‌سازی تأثیری ندارد. مگر اینکه واقعاً بدانید چه کاری انجام می‌دهید، \fBهرگز از این گزینه برای ارسال ایمیل به SENDMAIL استفاده نکنید!\fP.
.TP
.BI \-s\  script\-file\  \fB[هنوز\ پیاده‌سازی\ نشده]\fP
تعیین اسکریپت‌های اضافی برای اجرا پیش از اسکریپت اصلی. تعیین چندین آرگومان \fB\-s\fP مجاز است و اسکریپت‌های مشخص‌شده به صورت متوالی و با ترتیبی که در خط فرمان آمده‌اند اجرا می‌شوند.
.TP
.BI \-u\  user
اجرای اسکریپت Sieve برای \fIuser\fP مشخص‌شده. در صورت عدم ذکر،
.I command
با محیط کاربری که در حال حاضر به سیستم وارد شده است اجرا خواهد شد.
.TP
.B \-v
تولید خروجی پرگو (verbose) در حین پالایش.
.TP
.B \-W
فعال کردن دسترسی نوشتن در \fIsource\-mailbox\fP. این گزینه اجازه می‌دهد پیام‌ها از \fIsource\-mailbox\fP منتقل یا حذف شوند، محتوای آن‌ها تغییر کند، و پرچم‌ها و کلیدواژه‌های IMAP اختصاص‌یافته ویرایش شوند.
.TP
.BI \-x\  extensions
تعیین افزونه‌های در دسترس. این پارامتر فهرستی جداشده با فاصله از افزونه‌های فعال است. با قرار دادن پیشوند \fB+\fP یا \fB\-\fP قبل از شناسهٔ افزونه‌ها، می‌توان افزونه‌ها را نسبت به مجموعه افزونه‌های فعال پیکربندی‌شده اضافه یا حذف کرد. اگر هیچ افزونه‌ای پیشوند \fB+\fP یا \fB\-\fP نداشته باشد، تنها افزونه‌هایی که صراحتاً فهرست شده‌اند فعال خواهند شد. افزونه‌های ناشناخته نادیده گرفته شده و یک هشدار صادر می‌شود.
.sp
برای مثال \fB\-x\fP \(dq+imapflags \-enotify\(dq افزونهٔ منسوخ‌شدهٔ imapflags را فعال و افزونهٔ enotify را غیرفعال می‌کند. سایر افزونه‌های فعال به تنظیمات \fIsieve_extensions\fP و \fIsieve_global_extensions\fP بستگی دارند. به طور پیش‌فرض، یعنی زمانی که \fIsieve_extensions\fP و \fIsieve_global_extensions\fP بدون پیکربندی باقی بمانند، تمام افزونه‌های پشتیبانی‌شده در دسترس هستند، به جز افزونه‌های منسوخ‌شده یا مواردی که هنوز در دست توسعه قرار دارند.

.\"------------------------------------------------------------------------
.SH "آرگومان‌ها (ARGUMENTS)"
.TP
.I script\-file
اسکریپت Sieve را برای (کامپایل و) اجرا مشخص می‌کند.
.sp
توجه داشته باشید که این ابزار به دنبال یک فایل باینری از پیش کامپایل‌شده با پسوند \fI.svbin\fP و با نام پایه (basename) و مسیری یکسان با اسکریپت مشخص‌شده می‌گردد. از گزینهٔ \fB\-C\fP برای غیرفعال کردن این رفتار از طریق اجبار به کامپایل اسکریپت در یک فایل باینری جدید استفاده کنید.
.TP
.I source\-mailbox
صندوق پستی مبدأ حاوی پیام‌هایی را مشخص می‌کند که پالایهٔ Sieve روی آن‌ها اعمال خواهد شد.
.sp
این نام یک صندوق پستی است، همان‌گونه که برای کلاینت‌های IMAP قابل مشاهده است، با این تفاوت که در قالب UTF-8 بیان می‌شود. جداکنندهٔ سلسله‌مراتب میان یک صندوق پستی والد و فرزند معمولاً
.RB \(aq / \(aq
یا
.RB \(aq . \(aq
است، اما این به قالب ذخیره‌سازی صندوق پستی و پیکربندی namespace انتخابی شما بستگی دارد. نام‌های صندوق پستی همچنین ممکن است به یک پیشوند namespace نیاز داشته باشند.
.sp
این صندوق پستی تغییر داده نخواهد شد مگر اینکه گزینهٔ \fB\-W\fP مشخص شده باشد.
.TP
.I discard\-action
مشخص می‌کند چه اقدامی روی پیام‌های موجود در \fIsource\-mailbox\fP که توسط اسکریپت Sieve نگه‌داشته نشده یا به شکل دیگری ذخیره نشده‌اند صورت گیرد؛ یعنی پیام‌هایی که در صورت اجرای اسکریپت Sieve هنگام تحویل، به طور معمول دور ریخته می‌شدند. پارامتر \fIdiscard\-action\fP یکی از مقادیر زیر را می‌پذیرد:
.RS 7
.TP
.BR keep\  (پیش‌فرض)
نگه‌داشتن پیام‌های دور ریخته‌شده در صندوق پستی مبدأ.
.TP
.BI move\  mailbox
انتقال پیام‌های دور ریخته‌شده به \fImailbox\fP مشخص‌شده. این کار برای مثال جهت انتقال پیام‌ها به یک صندوق پستی Trash (سطل زباله) مفید است. برای اطلاعات بیشتر دربارهٔ نام‌گذاری صندوق‌های پستی به توضیحات آرگومان \fIsource\-mailbox\fP مراجعه کنید.
.TP
.B delete
علامت‌گذاری پیام‌های دور ریخته‌شده به عنوان \\DELETED.
.TP
.B expunge
پاکسازی (expunge) پیام‌های دور ریخته‌شده، به این معنی که این پیام‌ها پس از پایان پالایش توسط این ابزار، به صورت برگشت‌ناپذیر حذف می‌شوند.
.RE
.IP
هنگامی که گزینهٔ \fB\-W\fP مشخص نشده باشد، \fIsource\-mailbox\fP غیرقابل‌تغییر است و \fIdiscard\-action\fP مشخص‌شده هیچ تأثیری ندارد. این بدان معناست که پیام‌ها حداکثر در یک مکان جدید \fIرونوشت\fP (کپی) می‌شوند. در مقابل، زمانی که \fB\-W\fP مشخص شده باشد، پیام‌هایی که با موفقیت در جای دیگری توسط اسکریپت Sieve ذخیره شده‌اند \fBهمیشه\fP از \fIsource\-mailbox\fP پاکسازی (expunge) می‌شوند، که در نتیجه پیام‌ها به مکان جدید \fIمنتقل\fP می‌گردند. این فرایند فارغ از \fIdiscard\-action\fP مشخص‌شده رخ می‌دهد. به یاد داشته باشید: تنها پیام‌های دور ریخته‌شده تحت تأثیر \fIdiscard\-action\fP مشخص‌شده قرار می‌گیرند.

.\"------------------------------------------------------------------------

.SH "مثال‌ها (EXAMPLES)"

.TP
[...]

.\"------------------------------------------------------------------------
.SH "وضعیت خروج (EXIT STATUS)"
.B sieve\-filter
با یکی از مقادیر زیر به کار خود پایان می‌دهد:
.TP 4
.B 0
پالایهٔ Sieve با موفقیت اعمال شد. (EX_OK, EXIT_SUCCESS)
.TP
.B 1
عملیات با شکست مواجه شد. این مقدار تقریباً برای همهٔ خطاها بازگردانده می‌شود. (EXIT_FAILURE)
.TP
.B 64
پارامتر نامعتبر داده شده است. (EX_USAGE)
.\"------------------------------------------------------------------------
.SH "فایل‌ها (FILES)"
.TP
.I /usr/etc/dovecot/dovecot.conf
فایل پیکربندی اصلی Dovecot.
.TP
.I /usr/etc/dovecot/conf.d/90\-sieve.conf
تنظیمات مفسر Sieve (فراخوانی‌شده از فایل پیکربندی اصلی Dovecot).
.\"------------------------------------------------------------------------
.SH "گزارش باگ‌ها (BUGS)"
گزارش باگ‌ها را به همراه خروجی
.I doveconf \-n
به لیست پستی Dovecot به نشانی <dovecot@dovecot.org> ارسال کنید.
اطلاعات دربارهٔ نحوهٔ گزارش باگ‌ها در این نشانی در دسترس است:
http://dovecot.org/bugreport.html
.\"------------------------------------------------------------------------
.SH "همچنین ببینید (SEE ALSO)"
.BR dovecot (1),
.BR dovecot\-lda (1),
.BR sieve\-dump (1),
.BR sieve\-test (1),
.BR sievec (1),
.BR pigeonhole (7)