.\" -*- 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-REVOKE 1" .TH RAZOR-REVOKE 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\-revoke \- عامل لغو گزارش هرزنامه و معرفی نامه‌ها به عنوان غیرهرزنامه در ریزور .SH "خلاصه دستور (SYNOPSIS)" .IX Header "SYNOPSIS" .Vb 1 \& razor\-revoke [options] file_with_mail_in_rfc822_format \& \& $ cat mail | razor\-revoke \& $ razor\-revoke ./mail \& $ razor\-revoke \-d ./mail .Ve .SH "توضیحات (DESCRIPTION)" .IX Header "DESCRIPTION" \&\f(CW\*(C`razor\-revoke\*(C'\fR عامل لغو گزارش ریزور است که برای گزارش پیام‌ها به عنوان «غیرهرزنامه» (NOT spam) به یک کارگزار معرفی ریزور (Razor Nomination Server) استفاده می‌شود. برای نمونه، اگر بررسی‌ها پیامی را به اشتباه به عنوان هرزنامه علامت‌گذاری کرده باشند یا پس از آنکه پیامی به نادرست به عنوان هرزنامه گزارش شده باشد، می‌توان آن را فراخوانی کرد. به‌طور کلی \f(CW\*(C`razor\-revoke\*(C'\fR باید از یک MUA فراخوانی شود، اگرچه هیچ محدودیتی برای فراخوانی آن از خط فرمان وجود ندارد. دستور \f(CW\*(C`razor\-revoke\*(C'\fR یک فیلتر است، به این معنی که پیام‌ها باید از طریق لوله (pipe) به آن ارسال شوند. به صورت پیش‌فرض، \f(CW\*(C`razor\-revoke\*(C'\fR در هنگام راه‌اندازی به پس‌زمینه می‌رود و خود را از ترمینال کنترل جدا می‌کند. .PP اگر بیش از یک نامه به \f(CW\*(C`razor\-revoke\*(C'\fR داده شود، گزارش هر یک از آن‌ها را در پایگاه داده لغو می‌کند. لطفاً با احتیاط از این دستور استفاده کنید، زیرا نمی‌خواهیم پایگاه داده اطلاعات نادرستی داشته باشد. دستور \f(CW\*(C`razor\-revoke\*(C'\fR از فایل‌های با قالب mbox حاوی ۱ یا چند نامه، و همچنین فایل‌های حاوی یک نامه منفرد RFC 822 (غیر mbox) پشتیبانی می‌کند. بیش از یک فایل می‌تواند در خط فرمان مشخص شود و این فایل‌ها می‌توانند با هر ترتیبی ترکیبی از فایل‌های mbox یا غیر mbox باشند. با این حال، نمی‌توان بیش از یک نامه غیر mbox را از stdin خواند. .PP هر دو ابزار \fBrazor\-report\fR\|(1) و \f(CW\*(C`razor\-revoke\*(C'\fR برای کار کردن به احراز هویت کاربر نیاز دارند؛ به \fBrazor\-admin\fR\|(1) مراجعه کنید. این امر به کارگزار معرفی ریزور امکان می‌دهد تعداد پیام‌هایی را که یک کاربر گزارش یا لغو می‌کند پیگیری کند. هرچه کاربر پیام‌های بیشتری را به درستی گزارش و/یا لغو کند، اعتماد بیشتری کسب می‌کند. به همین ترتیب، با گزارش یا لغو نادرست پیام‌ها، میزان اعتماد کاربر کاهش می‌یابد. کاربران بسیار مورد اعتماد بیشترین تأثیر را بر پایگاه داده ریزور خواهند داشت. .PP توجه داشته باشید که حتی پس از یک لغو موفق، ممکن است نامه همچنان در فهرست ریزور (Razor Catalogue) به عنوان هرزنامه در نظر گرفته شود. برای نمونه، این حالت زمانی رخ می‌دهد که کاربران مورد اعتماد بیشتری نسبت به غیرهرزنامه، نامه را هرزنامه در نظر گرفته باشند. .SH "نحوه استفاده (USAGE)" .IX Header "USAGE" دستور \f(CW\*(C`razor\-revoke\*(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 """\-ident=filename""" 4 .el .IP \f(CW\-ident=filename\fR 4 .IX Item "-ident=filename" مشخص کردن یک فایل شناسه برای احراز هویت با کارگزارهای ریزور. در صورت عدم تعیین، از \f(CW\*(C`/identity\-\*(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" استفاده از این کارگزار معرفی ریزور به جای خواندن \f(CW\*(C`servers.nomination.lst\*(C'\fR. .ie n .IP """\-M | \-\-mbox""" 4 .el .IP "\f(CW\-M | \-\-mbox\fR" 4 .IX Item "-M | --mbox" پذیرش نام یک صندوق پستی در خط فرمان و لغو گزارش تک‌تک نامه‌های موجود در آن در پایگاه داده. در صورت اجرا در پیش‌زمینه با \f(CW\*(C`\-f\*(C'\fR، دستور \f(CW\*(C`razor\-revoke\*(C'\fR شماره هر نامه‌ای را که توسط کارگزار فهرست پذیرفته شده است چاپ می‌کند. .Sp .Vb 1 \& razor\-revoke \-f \-M ~/Mail/incorrectly\-marked\-spam .Ve .ie n .IP """\-i=filename""" 4 .el .IP \f(CW\-i=filename\fR 4 .IX Item "-i=filename" استفاده از شناسه موجود در filename به جای خواندن /identity. .ie n .IP """\-a""" 4 .el .IP \f(CW\-a\fR 4 .IX Item "-a" فقط احراز هویت. در صورت موفقیت با کد ۰ و در غیر این صورت با ۱ خارج می‌شود. .ie n .IP """\-f""" 4 .el .IP \f(CW\-f\fR 4 .IX Item "-f" ماندن در پیش‌زمینه؛ از ترمینال جدا نشده و در پس‌زمینه اجرا نشود. .SH "یکپارچه‌سازی با MUTT (INTEGRATION WITH MUTT)" .IX Header "INTEGRATION WITH MUTT" خط زیر را به \f(CW\*(C`mutt.conf\*(C'\fR اضافه کنید: .PP .Vb 1 \& macro index R "|/usr/bin/razor\-revoke" .Ve .PP سپس کلید R را روی پیام در \f(CW\*(C`mutt\*(C'\fR فشار دهید تا با \f(CW\*(C`razor\-revoke\*(C'\fR لغو شود. از آنجا که \f(CW\*(C`razor\-revoke\*(C'\fR به عنوان پردازه جداگانه (fork) اجرا می‌شود، کنترل برنامه بلافاصله به کاربر بازمی‌گردد. .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\-check\fR\|(1), \&\fBrazor\-admin\fR\|(1), \fBrazor\-report\fR\|(1), \fBrazor\-whitelist\fR\|(5) .SH "مجوز (LICENSE)" .IX Header "LICENSE" این یک نرم‌افزار آزاد است که تحت مجوز Artistic License 2.0 توزیع شده است.