RAZOR-CHECK(1) User Contributed Perl Documentation RAZOR-CHECK(1)

razor-check - عامل پالایش Razor

razor-check [options]  [ mail1 [ mail2 .. ] ]
$ cat mbox | razor-check
$ razor-check ./mbox
$ razor-check -d mbox mail.1 mail.2 mail.3

دستور "razor-check" با برقراری ارتباط با یک Razor Catalogue Server، ایمیل را در برابر «کاتالوگ توزیع‌شده Razor» بررسی می‌کند. این دستور باید پیش از تحویل ایمیل یا پردازش آن توسط کاربر فراخوانی شود. اگر امضای ایمیل در سرور ثبت شده باشد (هرزنامه)، دستور "razor-check" با مقدار خروج 0 و اگر در سرور ثبت نشده باشد (غیر هرزنامه)، با مقدار خروج 1 به کار خود پایان می‌دهد. پردازنده‌های ایمیل (مانند procmail) یا برنامه‌های انتقال ایمیل (مانند sendmail) باید "razor-check" را برای تمام ایمیل‌های دریافتی اجرا کنند. یک روش جایگزین، فراخوانی دوره‌ای "razor-check" از طریق cron برای شناسایی و نشانه‌گذاری هرزنامه‌ها در صندوق‌های پستیِ در صف انتظار است.

اگر بیش از یک ایمیل به "razor-check" داده شود، هرکدام را در پایگاه‌داده بررسی کرده و شماره سریال هر ایمیلی را که هرزنامه تشخیص داده شود، چاپ می‌کند. "razor-check" از فایل‌های با قالب mbox حاوی ۱ یا چند ایمیل و همچنین فایل‌های حاوی یک پیام RFC 822 (غیر mbox) پشتیبانی می‌کند. بیش از یک فایل می‌توانند در خط فرمان مشخص شوند که می‌توانند به هر ترتیبی mbox یا غیر mbox باشند. با این حال، نمی‌توان بیش از یک ایمیل غیر mbox را از stdin خواند.

دستور "razor-check" معمولاً با هدایت کردن محتوای ایمیل به ورودی آن (pipe) یا با ارائه نام فایل حاوی پیام ایمیل مورد بررسی به عنوان آخرین آرگومان اجرا می‌شود. "razor-check" آرگومان‌های زیر را می‌پذیرد:

"-h"
چاپ پیام راهنما و خروج.
"-v"
چاپ شماره نسخه و خروج.
"-d | --verbose"
چاپ اطلاعات اشکال‌زدایی.
"-debuglevel=n | -dl=n"
تنظیم سطح اشکال‌زدایی روی 'n'. پیش‌فرض بدون گزینه "-d" مقدار ۳ و با آن مقدار ۹ است.
"-whitelist=file"
مشخص کردن فایل مورد استفاده برای لیست سفید. گزینه 'whitelist' را در "razor-agent.conf" لغو و جایگزین می‌کند.
"-s"
شبیه‌سازی بررسی. تمام مراحل به جز ارتباط با سرور انجام می‌شود.
"-conf=filename"
مشخص کردن یک فایل پیکربندی جایگزین. اگر مشخص نشود، به صورت خودکار تعیین می‌شود؛ برای جزئیات به صفحه راهنمای razor-agents(1) مراجعه کنید. برای گزینه‌های پیکربندی گوناگون به صفحه راهنمای razor-agent.conf(5) مراجعه کنید. پیش‌فرض برابر با "<razorhome>/razor-agent.conf" است.
"-home=dir"
مشخص کردن دایرکتوری razorhome. این دایرکتوری محل قرارگیری فایل پیکربندی، فایل‌های لاگ، شناسه‌ها و فایل‌های سرور است. اگر مشخص نشود، به صورت خودکار تعیین می‌شود؛ برای جزئیات به صفحه راهنمای razor-agents(1) مراجعه کنید.
"-logfile=file"
مشخص کردن فایلی برای ثبت وقایع (لاگ) به جای فایل تعریف‌شده در فایل پیکربندی. پیش‌فرض برابر با "<razorhome>/razor-agent.log" است.
"-rs=razor.server.com"
استفاده از این Razor Catalogue Server به جای خواندن فایل "servers.catalogue.lst".
"-H"
محاسبه و چاپ امضای محتوای ایمیل و سپس خروج. اگر "-e=integer" مشخص نشده باشد، همه موتورهای پشتیبانی‌شده به کار گرفته می‌شوند.
"-S=string"
پذیرش فهرستی از امضاهای از پیش محاسبه‌شده (با "-H") از طریق خط فرمان، به جای محاسبه مجدد آن از روی محتوای ایمیل. امضاها می‌توانند در مبنای ۱۶ (hex) یا base64 وارد شوند، اما استفاده از base64 ترجیح داده می‌شود. به "-e=integer" نیاز دارد. نحوه استفاده:

"razor-report -e 1 -S a8a3d545adb73f9733675571ffeaf10cba87745b";

"-e=integer"
مشخص کردن موتور مورد استفاده برای ایجاد امضاها. در این نسخه باید ۱، ۲، ۳ یا ۴ باشد. موتور ۱ یا "-e=1" برای امضاهای نسخه Razor 1.x استفاده می‌شود. فقط همراه با "-S=string" یا "-H" کاربرد دارد.
"-ep4=string"
رشته مورد استفاده موتور ۴ هنگام محاسبه امضاها. این رشته توسط Razor Catalogue Serverها منتشر شده و در بازه‌های زمانی کوتاه به‌روزرسانی می‌شود. فقط هنگام استفاده از "-e=4" کاربرد دارد.

دستور "razor-check" معمولاً از درون procmail(1) فراخوانی می‌شود. در ادامه روش‌های معمول استفاده از آن به همراه procmail آورده شده است:

برای تغییر سرایند "Subject" در صورت هرزنامه بودن ایمیل:
:0 Wc
| razor-check
:0 Waf
| formail -i "Subject: Razor Warning: SPAM/UBE/UCE"
برای افزودن سرایند "X-Razor2-Warning" به هرزنامه:
:0 Wc
| razor-check
:0 Waf
| formail -A "X-Razor2-Warning: SPAM."
برای ذخیره هرزنامه در یک صندوق پستی (mailbox):
:0 Wc
| razor-check
:0 Wa
/home/foo/Mail/razor-caught

Vipul Ved Prakash <mail@vipul.net> و Chad Norwood <chad@samo.org>

razor-agents(1), razor-agent.conf(5), razor-admin(1), razor-report(1), razor-revoke(1), razor-whitelist(5)

این یک نرم‌افزار آزاد است که تحت مجوز Artistic License 2.0 منتشر شده است.

2026-04-06 perl v5.42.2