.\" -*- mode: troff; coding: utf-8 -*- .\" Automatically generated by Pod::Man v6.0.2 (Pod::Simple 3.45) .\" .\" Standard preamble: .\" ======================================================================== .de Sp \" Vertical space (when we can't use .PP) .if t .sp .5v .if n .sp .. .de Vb \" Begin verbatim text .ft CW .nf .ne \\$1 .. .de Ve \" End verbatim text .ft R .fi .. .\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>. .ie n \{\ . ds C` "" . ds C' "" 'br\} .el\{\ . ds C` . ds C' 'br\} .\" .\" Escape single quotes in literal strings from groff's Unicode transform. .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" .\" If the F register is >0, we'll generate index entries on stderr for .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index .\" entries marked with X<> in POD. Of course, you'll have to process the .\" output yourself in some meaningful fashion. .\" .\" Avoid warning from groff about undefined register 'F'. .de IX .. .nr rF 0 .if \n(.g .if rF .nr rF 1 .if (\n(rF:(\n(.g==0)) \{\ . if \nF \{\ . de IX . tm Index:\\$1\t\\n%\t"\\$2" .. . if !\nF==2 \{\ . nr % 0 . nr F 2 . \} . \} .\} .rr rF .\" .\" Required to disable full justification in groff 1.23.0. .if n .ds AD l .\" ======================================================================== .\" .IX Title "RAZOR-CHECK 1" .TH RAZOR-CHECK 1 2026-04-06 "perl v5.42.2" "User Contributed Perl Documentation" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l .nh .SH "نام (NAME)" razor\-check \- عامل پالایش Razor .SH "خلاصه دستور (SYNOPSIS)" .IX Header "SYNOPSIS" .Vb 1 \& razor\-check [options] [ mail1 [ mail2 .. ] ] \& \& $ cat mbox | razor\-check \& $ razor\-check ./mbox \& $ razor\-check \-d mbox mail.1 mail.2 mail.3 .Ve .SH "توضیحات (DESCRIPTION)" .IX Header "DESCRIPTION" دستور \f(CW\*(C`razor\-check\*(C'\fR با برقراری ارتباط با یک Razor Catalogue Server، ایمیل را در برابر «کاتالوگ توزیع‌شده Razor» بررسی می‌کند. این دستور باید پیش از تحویل ایمیل یا پردازش آن توسط کاربر فراخوانی شود. اگر امضای ایمیل در سرور ثبت شده باشد (هرزنامه)، دستور \f(CW\*(C`razor\-check\*(C'\fR با مقدار خروج \f(CW0\fR و اگر در سرور ثبت نشده باشد (غیر هرزنامه)، با مقدار خروج \f(CW1\fR به کار خود پایان می‌دهد. پردازنده‌های ایمیل (مانند procmail) یا برنامه‌های انتقال ایمیل (مانند sendmail) باید \f(CW\*(C`razor\-check\*(C'\fR را برای تمام ایمیل‌های دریافتی اجرا کنند. یک روش جایگزین، فراخوانی دوره‌ای \f(CW\*(C`razor\-check\*(C'\fR از طریق cron برای شناسایی و نشانه‌گذاری هرزنامه‌ها در صندوق‌های پستیِ در صف انتظار است. .PP اگر بیش از یک ایمیل به \f(CW\*(C`razor\-check\*(C'\fR داده شود، هرکدام را در پایگاه‌داده بررسی کرده و شماره سریال هر ایمیلی را که هرزنامه تشخیص داده شود، چاپ می‌کند. \f(CW\*(C`razor\-check\*(C'\fR از فایل‌های با قالب mbox حاوی ۱ یا چند ایمیل و همچنین فایل‌های حاوی یک پیام RFC 822 (غیر mbox) پشتیبانی می‌کند. بیش از یک فایل می‌توانند در خط فرمان مشخص شوند که می‌توانند به هر ترتیبی mbox یا غیر mbox باشند. با این حال، نمی‌توان بیش از یک ایمیل غیر mbox را از stdin خواند. .SH "نحوه استفاده (USAGE)" .IX Header "USAGE" دستور \f(CW\*(C`razor\-check\*(C'\fR معمولاً با هدایت کردن محتوای ایمیل به ورودی آن (pipe) یا با ارائه نام فایل حاوی پیام ایمیل مورد بررسی به عنوان آخرین آرگومان اجرا می‌شود. \f(CW\*(C`razor\-check\*(C'\fR آرگومان‌های زیر را می‌پذیرد: .ie n .IP """\-h""" 4 .el .IP \f(CW\-h\fR 4 .IX Item "-h" چاپ پیام راهنما و خروج. .ie n .IP """\-v""" 4 .el .IP \f(CW\-v\fR 4 .IX Item "-v" چاپ شماره نسخه و خروج. .ie n .IP """\-d | \-\-verbose""" 4 .el .IP "\f(CW\-d | \-\-verbose\fR" 4 .IX Item "-d | --verbose" چاپ اطلاعات اشکال‌زدایی. .ie n .IP """\-debuglevel=n | \-dl=n""" 4 .el .IP "\f(CW\-debuglevel=n | \-dl=n\fR" 4 .IX Item "-debuglevel=n | -dl=n" تنظیم سطح اشکال‌زدایی روی \*(Aqn\*(Aq. پیش‌فرض بدون گزینه \f(CW\*(C`\-d\*(C'\fR مقدار ۳ و با آن مقدار ۹ است. .ie n .IP """\-whitelist=file""" 4 .el .IP \f(CW\-whitelist=file\fR 4 .IX Item "-whitelist=file" مشخص کردن فایل مورد استفاده برای لیست سفید. گزینه \*(Aqwhitelist\*(Aq را در \f(CW\*(C`razor\-agent.conf\*(C'\fR لغو و جایگزین می‌کند. .ie n .IP """\-s""" 4 .el .IP \f(CW\-s\fR 4 .IX Item "-s" شبیه‌سازی بررسی. تمام مراحل به جز ارتباط با سرور انجام می‌شود. .ie n .IP """\-conf=filename""" 4 .el .IP \f(CW\-conf=filename\fR 4 .IX Item "-conf=filename" مشخص کردن یک فایل پیکربندی جایگزین. اگر مشخص نشود، به صورت خودکار تعیین می‌شود؛ برای جزئیات به صفحه راهنمای \fBrazor\-agents\fR\|(1) مراجعه کنید. برای گزینه‌های پیکربندی گوناگون به صفحه راهنمای \fBrazor\-agent.conf\fR\|(5) مراجعه کنید. پیش‌فرض برابر با \f(CW\*(C`/razor\-agent.conf\*(C'\fR است. .ie n .IP """\-home=dir""" 4 .el .IP \f(CW\-home=dir\fR 4 .IX Item "-home=dir" مشخص کردن دایرکتوری razorhome. این دایرکتوری محل قرارگیری فایل پیکربندی، فایل‌های لاگ، شناسه‌ها و فایل‌های سرور است. اگر مشخص نشود، به صورت خودکار تعیین می‌شود؛ برای جزئیات به صفحه راهنمای \fBrazor\-agents\fR\|(1) مراجعه کنید. .ie n .IP """\-logfile=file""" 4 .el .IP \f(CW\-logfile=file\fR 4 .IX Item "-logfile=file" مشخص کردن فایلی برای ثبت وقایع (لاگ) به جای فایل تعریف‌شده در فایل پیکربندی. پیش‌فرض برابر با \f(CW\*(C`/razor\-agent.log\*(C'\fR است. .ie n .IP """\-rs=razor.server.com""" 4 .el .IP \f(CW\-rs=razor.server.com\fR 4 .IX Item "-rs=razor.server.com" استفاده از این Razor Catalogue Server به جای خواندن فایل \f(CW\*(C`servers.catalogue.lst\*(C'\fR. .ie n .IP """\-H""" 4 .el .IP \f(CW\-H\fR 4 .IX Item "-H" محاسبه و چاپ امضای محتوای ایمیل و سپس خروج. اگر \f(CW\*(C`\-e=integer\*(C'\fR مشخص نشده باشد، همه موتورهای پشتیبانی‌شده به کار گرفته می‌شوند. .ie n .IP """\-S=string""" 4 .el .IP \f(CW\-S=string\fR 4 .IX Item "-S=string" پذیرش فهرستی از امضاهای از پیش محاسبه‌شده (با \f(CW\*(C`\-H\*(C'\fR) از طریق خط فرمان، به جای محاسبه مجدد آن از روی محتوای ایمیل. امضاها می‌توانند در مبنای ۱۶ (hex) یا base64 وارد شوند، اما استفاده از base64 ترجیح داده می‌شود. به \f(CW\*(C`\-e=integer\*(C'\fR نیاز دارد. نحوه استفاده: .Sp \&\f(CW\*(C`razor\-report \-e 1 \-S a8a3d545adb73f9733675571ffeaf10cba87745b\*(C'\fR .ie n .IP """\-e=integer""" 4 .el .IP \f(CW\-e=integer\fR 4 .IX Item "-e=integer" مشخص کردن موتور مورد استفاده برای ایجاد امضاها. در این نسخه باید ۱، ۲، ۳ یا ۴ باشد. موتور ۱ یا \f(CW\*(C`\-e=1\*(C'\fR برای امضاهای نسخه Razor 1.x استفاده می‌شود. فقط همراه با \f(CW\*(C`\-S=string\*(C'\fR یا \f(CW\*(C`\-H\*(C'\fR کاربرد دارد. .ie n .IP """\-ep4=string""" 4 .el .IP \f(CW\-ep4=string\fR 4 .IX Item "-ep4=string" رشته مورد استفاده موتور ۴ هنگام محاسبه امضاها. این رشته توسط Razor Catalogue Serverها منتشر شده و در بازه‌های زمانی کوتاه به‌روزرسانی می‌شود. فقط هنگام استفاده از \f(CW\*(C`\-e=4\*(C'\fR کاربرد دارد. .SH "دستورالعمل‌ها (RECIPES)" .IX Header "RECIPES" دستور \f(CW\*(C`razor\-check\*(C'\fR معمولاً از درون \fBprocmail\fR\|(1) فراخوانی می‌شود. در ادامه روش‌های معمول استفاده از آن به همراه procmail آورده شده است: .ie n .IP "برای تغییر سرایند ""Subject"" در صورت هرزنامه بودن ایمیل:" 4 .el .IP "برای تغییر سرایند \f(CWSubject\fR در صورت هرزنامه بودن ایمیل:" 4 .IX Item "To change the Subject header if mail is spam:" .Vb 4 \& :0 Wc \& | razor\-check \& :0 Waf \& | formail \-i "Subject: Razor Warning: SPAM/UBE/UCE" .Ve .ie n .IP "برای افزودن سرایند ""X\-Razor2\-Warning"" به هرزنامه:" 4 .el .IP "برای افزودن سرایند \f(CWX\-Razor2\-Warning\fR به هرزنامه:" 4 .IX Item "To add a X-Razor2-Warning header to spam:" .Vb 4 \& :0 Wc \& | razor\-check \& :0 Waf \& | formail \-A "X\-Razor2\-Warning: SPAM." .Ve .IP "برای ذخیره هرزنامه در یک صندوق پستی (mailbox):" 4 .IX Item "To file spam in a mailbox" .Vb 4 \& :0 Wc \& | razor\-check \& :0 Wa \& /home/foo/Mail/razor\-caught .Ve .SH "نویسندگان (AUTHORS)" .IX Header "AUTHORS" Vipul Ved Prakash و Chad Norwood .SH "همچنین ببینید (SEE ALSO)" .IX Header "SEE ALSO" \&\fBrazor\-agents\fR\|(1), \fBrazor\-agent.conf\fR\|(5), \fBrazor\-admin\fR\|(1), \&\fBrazor\-report\fR\|(1), \fBrazor\-revoke\fR\|(1), \fBrazor\-whitelist\fR\|(5) .SH "مجوز (LICENSE)" .IX Header "LICENSE" این یک نرم‌افزار آزاد است که تحت مجوز Artistic License 2.0 منتشر شده است.