.\" -*- 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-AGENTS 5"
.TH RAZOR-AGENTS 5 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\-Agents \- مجموعه‌ای از پرونده‌ها برای بررسی، گزارش و ابطال هرزنامه‌ها
.SH "توضیحات (DESCRIPTION)"
.IX Header "DESCRIPTION"
شبکه رِیزور ویپول (Vipul\*(Aqs Razor) یک شبکه مشارکتی و توزیع‌شده برای تشخیص، گزارش و فیلتر کردن هرزنامه‌ها است. تمرکز اصلی این سیستم بر شناسایی و حذف تمامی هرزنامه‌های ایمیل از اینترنت است. از وب‌سایت آن در نشانی http://razor.sourceforge.net دیدن کنید.
.SH "نحوه استفاده (USAGE)"
.IX Header "USAGE"
ابتدا باید یک دایرکتوری razorhome ایجاد شود که اطلاعات مربوط به لاگ‌ها، پیکربندی و سرورهای ذخیره‌شده در حافظه نهان در آن قرار گیرد. این کار از طریق گزینه \f(CW\*(C`\-create\*(C'\fR در \fBrazor\-admin\fR\|(1) انجام می‌شود. برای جزئیات به صفحه راهنما مراجعه کنید.
.PP
می‌توانید بلافاصله با استفاده از \fBrazor\-check\fR\|(1) هرزنامه را بررسی کنید. برای جزئیات به صفحه راهنما مراجعه کنید.
.PP
برای گزارش هرزنامه، باید یک هویت ثبت شود. این کار از طریق گزینه \f(CW\*(C`\-register\*(C'\fR در \fBrazor\-admin\fR\|(1) انجام می‌شود. پس از آن، \fBrazor\-report\fR\|(1) و \fBrazor\-revoke\fR\|(1) بدون نقص کار خواهند کرد.
.SH "پیکربندی (CONFIGURATION)"
.IX Header "CONFIGURATION"
تمامی Razor\-Agents از یک فایل پیکربندی مشترک استفاده می‌کنند. محتویات فایل پیکربندی به تفصیل در صفحه راهنمای \fBrazor\-agent.conf\fR\|(5) آمده است.
.PP
فایل پیکربندی پیش از razorhome و به ترتیب زیر بررسی و تعیین می‌شود:
.PP
.Vb 4
\& \-conf=/path/file.conf           در صورت خواندنی بودن استفاده می‌شود، وگرنه
\& <home>/.razor/razor\-agent.conf  در صورت خواندنی بودن استفاده می‌شود، وگرنه
\& /etc/razor/razor\-agent.conf     در صورت خواندنی بودن استفاده می‌شود، وگرنه
\& همه پیش‌فرض‌ها استفاده می‌شوند.
.Ve
.PP
برای مشاهده پیش‌فرض‌های پیکربندی، این دستور را اجرا کنید:
  razor\-admin \-create \-conf=/tmp/razor2\-defaults.conf
.SH "پوشه خانگی رِیزور (RAZORHOME)"
.IX Header "RAZORHOME"
تمامی Razor\-Agents همچنین از یک دایرکتوری razorhome مشترک استفاده می‌کنند که در آن اطلاعات هویت، ثبت وقایع و اطلاعات ذخیره‌شده سرورها در حافظه نهان نگهداری می‌شود.
دایرکتوری razorhome پس از فایل پیکربندی، به ترتیب زیر تعیین می‌شود:
.PP
.Vb 5
\& \-home=/tmp/razor/                     در صورت خواندنی بودن استفاده می‌شود، وگرنه
\& \*(Aqrazorhome\*(Aq از فایل پیکربندی       در صورت خواندنی بودن استفاده می‌شود، وگرنه
\& <home>/.razor/                        در صورت خواندنی بودن استفاده می‌شود، وگرنه
\& <home>/.razor/                        ایجاد می‌شود. اگر ناموفق باشد،
\&                                       هیچ razorhome وجود نخواهد داشت.
\&
\&
\& نکته: اگر razorhome وجود نداشته باشد، razor\-report و razor\-revoke
\&       کار نخواهند کرد مگر اینکه \-ident=/path/identity را مشخص کنید.
\&       razor\-check همچنان کار خواهد کرد.
.Ve
.SH "فایل‌ها (FILES)"
.IX Header "FILES"
علاوه بر مواردی که در انتها با صفحات راهنمای اختصاصی خود فهرست شده‌اند، Razor Agents پرونده‌های زیر را نیز دارد:
.IP \fBrazorhome/identity\fR 4
.IX Item "razorhome/identity"
معمولاً یک پیوند نمادین (symlink) به فایل هویت حاوی user+pass است.
توسط \fBrazor\-report\fR\|(1) و \fBrazor\-revoke\fR\|(1) استفاده می‌شود.
.IP \fBrazorhome/razor\-agent.log\fR 4
.IX Item "razorhome/razor-agent.log"
فایل پیش‌فرض ثبت وقایع (لاگ). برای تغییر آن، \fBrazor\-agent.conf\fR\|(5) را ویرایش کنید.
.IP \fBrazorhome/servers.*.lst\fR 4
.IX Item "razorhome/servers.*.lst"
فهرست ذخیره‌شده سرورهای Razor در حافظه نهان. اگر بیش از یک مورد باشد، بر اساس نزدیک‌ترین زمان پینگ مرتب می‌شوند.
.IP \fBrazorhome/server.<name>.lst\fR 4
.IX Item "razorhome/server.<name>.lst"
اطلاعات ذخیره‌شده برای سرور <name> در حافظه نهان. کلید \f(CW\*(C`srl\*(C'\fR در این پرونده
با پیام خوش‌آمدگویی سرور مقایسه می‌شود و اگر مقدار سرور بزرگ‌تر باشد،
اطلاعات نهان جدید از سرور دریافت می‌گردد.
.SH "مثال‌ها (EXAMPLES)"
.IX Header "EXAMPLES"
.IP "razor\-check \-d \-debuglevel=9 mbox" 4
.IX Item "razor-check -d -debuglevel=9 mbox"
بررسی هرزنامه در mbox. شماره‌هایی را برای مواردی که هرزنامه تشخیص داده شده‌اند چاپ می‌کند.
گزینه \f(CW\-d\fR وقایع را در stdout ثبت می‌کند، و \f(CW\-debuglevel=9\fR ثبت وقایع با جزئیات کامل است.
.IP "razor\-admin \-create \-home=/home/chad/.razor \-d \-s" 4
.IX Item "razor-admin -create -home=/home/chad/.razor -d -s"
ایجاد razorhome در /home/chad/.razor، ثبت لاگ در stdout، بدون اتصال به سرور (\f(CW\-s\fR شبیه‌سازی است).
.IP "razor\-report spam \-debuglevel=0" 4
.IX Item "razor-report spam -debuglevel=0"
ارسال هرزنامه به سرور، بدون ثبت هیچ پیام لاگ.
.SH "نویسندگان (AUTHORS)"
.IX Header "AUTHORS"
ویپول ود پراکاش (Vipul Ved Prakash)، <mail@vipul.net> و چاد نوروود (Chad Norwood)، <chad@samo.org>
.SH "همچنین ببینید (SEE ALSO)"
.IX Header "SEE ALSO"
\&\fBrazor\-agent.conf\fR\|(5), \fBrazor\-check\fR\|(1), \fBrazor\-admin\fR\|(1),
\&\fBrazor\-report\fR\|(1), \fBrazor\-revoke\fR\|(1), \fBrazor\-whitelist\fR\|(5)