.TH check-sieve 1 "10 Apr 2026" "version 1.0.1"
.
.
.
.SH "نام (NAME)"
.
check-sieve \- بررسی‌کننده نحو برای فیلترهای ایمیل Sieve.
.
.SH "خلاصه دستور (SYNOPSIS)"
.
.B check-sieve [گزینه‌ها]
.I file
.B [
.I file ...
.B ]
.br
.B check-sieve --help
.br
.B check-sieve --version
.
.SH "توضیحات (DESCRIPTION)"
.
.B check-sieve
یک بررسی‌کننده نحو ساده برای غربال‌ها (اسکریپت‌های فیلتر Sieve) سمت سرور ایمیل است. این ابزار از بسیاری از RFCهای mail-sieve پشتیبانی می‌کند که جزئیات آن‌ها در ادامه آمده است.
.
.SH "گزینه‌ها (OPTIONS)"
.
.IP "-h, --help"
نمایش راهنمای برنامه
.IP "--max-list-length N"
بررسی طول فهرست‌های رشته‌ای، و پرچم‌گذاری مواردی که طولانی‌تر از مقدار مشخص‌شده هستند
.IP "--server <host>:<port>"
اتصال به سرور مشخص‌شده، و فقط فعال‌سازی قابلیت‌های اعلان‌شده
.IP "--trace-parser"
ردگیری عملکرد تجزیه‌کننده (parser)
.IP "--trace-scanner"
ردگیری عملکرد اسکنر (scanner)
.IP "--trace-tree"
ردگیری درخت نحو انتزاعی (abstract syntax tree)
.IP "--simulate <email-file>"
شبیه‌سازی پردازش sieve روی یک فایل ایمیل (با فرمت .eml).
بخش
.B "شبیه‌سازی (SIMULATION)"
در زیر را ببینید.
.IP "--test-dir <dir>"
اجرای شبیه‌سازی برای هر فایل .eml در
.I dir
و مقایسه (diff) هر نتیجه با فایل منطبق .out.
بخش
.B "شبیه‌سازی (SIMULATION)"
در زیر را ببینید.
.IP "--rebase <dir>"
بازتولید فایل‌های .out در
.I dir
از روی خروجی شبیه‌سازی فعلی.
بخش
.B "شبیه‌سازی (SIMULATION)"
در زیر را ببینید.
.IP "--version"
چاپ اطلاعات نسخه
.
.SH "شبیه‌سازی (SIMULATION)"
.
.B check-sieve
می‌تواند نحوه مرتب‌سازی نامه‌ها توسط یک اسکریپت sieve را شبیه‌سازی کند، که اعتبارسنجی رفتار اسکریپت را بدون استقرار روی سرور ایمیل آسان می‌سازد.
.SS "شبیه‌سازی تک‌پیام (Single-message simulation)"
.IP "--simulate <email-file>"
.
اسکریپت sieve را اعتبارسنجی کرده و سپس آن را در برابر فایل .eml داده‌شده ارزیابی می‌کند.
هر آزمایشی که مطابقت داشته باشد به صورت
.BR "MATCH: " <test>
و هر عمل اجراشده به صورت
.BR "ACTION: " <action> .
چاپ می‌شود.
اگر هیچ عمل تحویلی انجام نشود،
.B keep (implicit)
به طور خودکار طبق RFC 5228 §4.2 افزوده می‌شود.
.br
.B "نکته:"
بسیاری از افزونه‌های RFC هنوز در دست توسعه هستند. ثبت یک گزارش اشکال برای افزونه‌های پشتیبانی‌نشده به اولویت‌بندی کارهای بعدی کمک خواهد کرد.
.SS "آزمایش دسته‌ای با یک دایرکتوری آزمایشی (Batch testing with a test directory)"
یک دایرکتوری آزمایشی حاوی فایل‌های .eml و به‌طور اختیاری فایل‌های .out است که خروجی مورد انتظار شبیه‌سازی را ثبت می‌کنند. فایل .out برای یک ایمیل مشخص، بر اساس نام پایه (stem) آن ایمیل نام‌گذاری می‌شود (برای مثال\&
.I msg.eml
←
.IR msg.out ).
.IP "--test-dir <dir>"
اجرای شبیه‌سازی در برابر تمام فایل‌های .eml در
.IR dir .
برای هر ایمیلی که دارای یک فایل منطبق .out باشد، خروجی واقعی (با حذف خط اولِ وابسته به محیط) با آن مقایسه (diff) می‌شود. اگر تمام مقایسه‌ها موفق باشند، برنامه با کد ۰ و بدون خروجی خارج می‌شود. اگر اختلافی وجود داشته باشد، هر تفاوت چاپ شده و به دنبال آن خلاصه‌ای در خروجی خطای استاندارد (stderr) نمایش می‌یابد و برنامه با کد ۱ خارج می‌شود. ایمیل‌های بدون فایل .out شبیه‌سازی می‌شوند اما مورد مقایسه قرار نمی‌گیرند.
.IP "--rebase <dir>"
بازتولید فایل .out برای تمامی فایل‌های .eml در
.IR dir ،
با ایجاد یا بازنویسی در صورت نیاز. این دستور را پس از اعمال تغییرات عمدی در یک اسکریپت sieve یا شبیه‌ساز اجرا کنید تا خروجی مورد انتظار پیش از اجرای مجدد
.BR --test-dir
به‌روزرسانی شود.
.
.SH "اشکالات (BUGS)"
.
برای دریافت اطلاعات درباره مشکلات موجود، و ثبت گزارش اشکال نشانی زیر را بررسی کنید:
https://github.com/dburkart/check-sieve/issues
.
.SH "نویسندگان (AUTHORS)"
.
Dana Burkart
.br
Stuart Montgomery
.
.SH "RFCهای پشتیبانی‌شده (SUPPORTED RFCs)"
.
فهرست کامل RFCهای پشتیبانی‌شده:

.RS
غربال: زبانی برای فیلتر کردن ایمیل (RFC 5228) - Sieve: An Email Filtering Language
.br
افزونه متغیرها (RFC 5229)
.br
افزونه‌های تاریخ و نمایه (RFC 5260)
.br
افزونه تعطیلات (RFC 5230)
.br
پارامتر "Seconds" برای تعطیلات (RFC 6131)
.br
افزونه الحاق (RFC 6609)
.br
کپی کردن بدون اثرات جانبی (RFC 3894)
.br
افزونه‌های رد کردن و رد گسترش‌یافته (RFC 5429)
.br
افزونه بدنه (RFC 5173)
.br
افزونه رابطه‌ای (RFC 5231)
.br
آزمون‌های بخش MIME، تکرار، استخراج، جایگزینی و محصور‌سازی (RFC 5703)
.br
افزونه پرچم‌های IMAP4 (RFC 5232)
.br
افزونه ویرایش سرآیند (RFC 5293)
.br
افزونه عبارات باقاعده (پیش‌نویس)
.br
افزونه‌های آزمون هرزنامه و ویروس (RFC 5235)
.br
افزونه‌های اعلان‌ها (RFC 5435)
.br
افزونه زیرنشانی (RFC 5233)
.br
افزونه Ihave (RFC 5463)
.br
افزونه محیط (RFC 5183)
.br
سازوکار اعلان Sieve: mailto (RFC 5436)
.br
رویدادهای پروتکل دسترسی به پیام اینترنتی (IMAP) (RFC 6785)
.br
تبدیل پیام‌ها پیش از تحویل (RFC 6558)
.br
تشخیص تحویل‌های تکراری (RFC 7352)
.br
فهرست‌های ذخیره‌شده خارجی (RFC 6134)
.br
تحویل به صندوق‌های پستی با کاربرد ویژه (RFC 8579)
.br
رونوشت کاربنی فایل (FCC) (RFC 8580)
.br
تحویل از طریق MAILBOXID (RFC 9042)
.br
اعلان‌های وضعیت تحویل و افزونه‌های Deliver-By (RFC 6009)
.br
افزونه پردازش پیوست‌های تقویم (RFC 9671)
.br
افزونه انقضای پروتون (ویژه ارائه‌دهنده)
.br
افزونه ارزیابی پروتون (ویژه ارائه‌دهنده)
.br
فراخوانی برنامه‌های خارجی داوکات (ویژه ارائه‌دهنده)
.RE