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

razor-report - عامل گزارش‌دهی Razor

razor-report [options]  file_with_mail_in_rfc822_format
$ cat mail | razor-report
$ razor-report ./mail 
$ razor-report -d ./mail

دستور "razor-report" عامل گزارش‌دهی Razor است که برای گزارش پیام‌های هرزنامه به یک Razor Nomination Server استفاده می‌شود. به طور معمول "razor-report" باید از یک MUA فراخوانی شود، هرچند هیچ محدودیتی برای اجرای آن از خط فرمان وجود ندارد. برنامه "razor-report" یک پالایه (filter) است، به این معنی که پیام‌های هرزنامه باید از طریق لوله (pipe) به آن هدایت شوند. به طور پیش‌فرض، "razor-report" در زمان راه‌اندازی به پس‌زمینه می‌رود و خود را از ترمینال کنترل جدا می‌کند.

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

با این حال، امکان خواندن بیش از یک ایمیل non-mbox از stdin وجود ندارد. هم "razor-report" و هم razor-revoke(1) برای فعالیت نیاز به احراز هویت کاربر دارند؛ به razor-admin(1) مراجعه کنید. این امکان به سرور نامزدی Razor (Razor Nomination Server) اجازه می‌دهد تعداد پیام‌هایی را که یک کاربر گزارش یا ابطال (revoke) می‌کند، پیگیری کند. هر چه کاربر پیام‌های بیشتری را به درستی گزارش و/یا ابطال نماید، اعتماد بیشتری به دست می‌آورد. به همین ترتیب، با گزارش یا ابطال نادرست پیام‌ها، میزان اعتماد کاربر کاهش می‌یابد. کاربران با سطح اعتماد بالا بیشترین تأثیر را روی کاتالوگ Razor (Razor Catalogue) خواهند داشت.

دستور "razor-report" آرگومان‌های زیر را می‌پذیرد:

"-h"
چاپ پیام نحوه استفاده و خروج.
"-v"
چاپ شماره نسخه و خروج.
"-d | --verbose"
چاپ اطلاعات اشکال‌زدایی در stdout.
"-debuglevel=n | -dl=n"
تنظیم سطح اشکال‌زدایی روی 'n'. پیش‌فرض بدون گزینه "-d" برابر ۳ و به همراه آن ۹ است.
"-whitelist=file"
مشخص کردن فایل مورد استفاده برای لیست سفید (whitelisting). این گزینه بر گزینه '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" است.
"-ident=filename"
مشخص کردن یک فایل هویت برای احراز هویت با سرورهای Razor. در صورت عدم تعیین، از "<razorhome>/identity-<user>" استفاده می‌شود.
"-rs=razor.server.com"
استفاده از این Razor Nomination Server به جای خواندن "servers.nomination.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 Nomination Serverها منتشر شده و به صورت مداوم به‌روزرسانی می‌شود. فقط زمانی که "-e=4" باشد استفاده می‌شود.
"-i=filename"
استفاده از هویت درون filename به جای خواندن <razorhome>/identity. سرورهای Razor میزان اعتماد را برای هر هویت منحصربه‌فرد محاسبه می‌کنند. عامل‌های Razor هویت را در یک فرایند دو مرحله‌ای مشخص می‌کنند. نخست، بررسی می‌کنند که آیا هویت از طریق خط فرمان (-i=file) مشخص شده است یا خیر. اگر مشخص نشده بود، در <razorhome> به دنبال فایل هویت می‌گردند. اگر <razorhome> حاوی هیچ فایل هویتی نباشد، احراز هویت با شکست مواجه می‌شود - شما نمی‌توانید گزارش یا ابطال کنید. برای اطلاعات بیشتر درباره <razorhome> به razor-agents.conf(5) مراجعه کنید. ---fixme----
"-a"
تنها احراز هویت انجام شود. در صورت احراز هویت، خروج با وضعیت ۰؛ در غیر این صورت، خروج با وضعیت ۱.
"-f"
ماندن در پیش‌زمینه؛ جدا نشدن از ترمینال و اجرا نشدن در پس‌زمینه.

خط زیر را به "mutt.conf" بیفزایید

macro index S "|/usr/bin/razor-report"

سپس کلید S را روی پیام هرزنامه در "mutt" فشار دهید تا با "razor-report" گزارش شود. از آنجا که "razor-report" انشعاب (fork) پیدا می‌کند، کنترل بلافاصله بازمی‌گردد.

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

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

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

2026-04-06 perl v5.42.2