.\" Automatically generated by Pandoc 3.1.11.1
.\"
.TH "RSPAMC" "1" "" "Rspamd User Manual" ""
.SH "نام (NAME)"
rspamc \- کلاینت خط فرمان rspamd
.SH "خلاصه دستور (SYNOPSIS)"
rspamc [\f[I]گزینه‌ها\f[R]] [\f[I]دستور\f[R]]
[\f[I]فایل\-ورودی\f[R]]\&...
.PP
rspamc \[en]help
.SH "توضیحات (DESCRIPTION)"
\f[CR]rspamc\f[R] یک کلاینت ساده برای rspamd است که عمدتاً برای دسته‌بندی
یا آموزش پیام‌ها به کار می‌رود.
\f[CR]rspamc\f[R] از دستورات زیر پشتیبانی می‌کند:
.IP \[bu] 2
دستورات اسکن:
.RS 2
.IP \[bu] 2
\f[CR]symbols\f[R]: اسکن پیام و نمایش نمادها (دستور پیش‌فرض)
.RE
.IP \[bu] 2
دستورات کنترلی:
.RS 2
.IP \[bu] 2
\f[CR]learn_spam\f[R]: آموزش پیام به عنوان هرزنامه (spam)
.IP \[bu] 2
\f[CR]learn_ham\f[R]: آموزش پیام به عنوان پیام معتبر (ham)
.IP \[bu] 2
\f[CR]fuzzy_add\f[R]: افزودن پیام به حافظه فازی (گزینه‌های \f[CR]\-f\f[R]
و \f[CR]\-w\f[R] را برای این دستور بررسی کنید)
.IP \[bu] 2
\f[CR]fuzzy_del\f[R]: حذف پیام از حافظه فازی (گزینه
\f[CR]\-f\f[R] را برای این دستور بررسی کنید)
.IP \[bu] 2
\f[CR]stat\f[R]: نمایش آمار rspamd
.IP \[bu] 2
\f[CR]stat_reset\f[R]: نمایش و بازنشانی آمار rspamd (مفید برای
نمودارها)
.IP \[bu] 2
\f[CR]counters\f[R]: نمایش آمار نمادهای rspamd
.IP \[bu] 2
\f[CR]uptime\f[R]: نمایش مدت‌زمان فعال بودن rspamd
.IP \[bu] 2
\f[CR]add_symbol\f[R]: افزودن یا تغییر تنظیمات نماد در rspamd
.IP \[bu] 2
\f[CR]add_action\f[R]: افزودن یا تغییر تنظیمات اقدام (action)
.RE
.PP
دستورات کنترلی که وضعیت rspamd را تغییر می‌دهند دارای دسترسی ویژه محسوب شده و
نیازمند مشخص کردن رمز عبور با گزینه \f[CR]\-P\f[R] هستند (برای جزئیات بیشتر به بخش
\f[B]گزینه‌ها (OPTIONS)\f[R] در ادامه مراجعه کنید).
.PD 0
.P
.PD
این موضوع به تنظیمات کنترل‌کننده بستگی دارد و در صفحه
\f[CR]rspamd\-workers\f[R] مورد بحث قرار گرفته است (برای جزئیات بیشتر به بخش \f[B]همچنین ببینید (SEE ALSO)\f[R]
در ادامه مراجعه کنید).
.PP
\f[CR]فایل‌های ورودی\f[R] می‌توانند فایل(های) معمولی یا یک دایرکتوری برای
اسکن باشند.
اگر هیچ فایلی مشخص نشود، \f[CR]rspamc\f[R] از ورودی استاندارد
می‌خواند.
دستورات کنترل‌کننده معمولاً هیچ ورودی نمی‌پذیرند، اما دستورات *learn و
*fuzzy نیازمند ورودی هستند.
.SH "گزینه‌ها (OPTIONS)"
.TP
\-h \f[I]host[:port]\f[R], \-\-connect=\f[I]host[:port]\f[R]
مشخص کردن میزبان و پورت
.TP
\-P \f[I]password\f[R], \-\-password=\f[I]password\f[R]
مشخص کردن رمز عبور کنترلی. می‌تواند یک مسیر مطلق یا نسبی باشد که در این
صورت رمز عبور از آن فایل خوانده خواهد شد.
.TP
\-c \f[I]name\f[R], \-\-classifier=\f[I]name\f[R]
دسته‌بندی‌کننده برای آموزش هرزنامه یا پیام معتبر (به طور پیش‌فرض از bayes استفاده می‌شود)
.TP
\-w \f[I]weight\f[R], \-\-weight=\f[I]weight\f[R]
وزن برای عملیات فازی
.TP
\-f \f[I]number\f[R], \-\-flag=\f[I]number\f[R]
فلگ برای عملیات فازی
.TP
\-p, \-\-pass
عبور از تمام فیلترها
.TP
\-v, \-\-verbose
خروجی با جزئیات بیشتر
.TP
\-i \f[I]ip address\f[R], \-\-ip=\f[I]ip address\f[R]
شبیه‌سازی دریافت پیام از آدرس IP مشخص‌شده
.TP
\-u \f[I]username\f[R], \-\-user=\f[I]username\f[R]
شبیه‌سازی دریافت پیام از کاربر احراز هویت‌شده مشخص
.TP
\-d \f[I]user\[at]domain\f[R], \-\-deliver=\f[I]user\[at]domain\f[R]
شبیه‌سازی تحویل پیام به کاربر مشخص‌شده (برای
LDA/آمار)
.TP
\-F \f[I]user\[at]domain\f[R], \-\-from=\f[I]user\[at]domain\f[R]
شبیه‌سازی اینکه پیام دارای آدرس مشخص‌شده SMTP FROM است
.TP
\-r \f[I]user\[at]domain\f[R], \-\-rcpt=\f[I]user\[at]domain\f[R]
شبیه‌سازی اینکه پیام دارای آدرس مشخص‌شده SMTP RCPT است
.TP
\-\-helo=\f[I]helo_string\f[R]
شبیه‌سازی ارسال SMTP HELO از سوی MTA
.TP
\-\-hostname=\f[I]hostname\f[R]
شبیه‌سازی ارسال نام میزبان از سوی MTA (برنامه rspamd فرض می‌کند که این مقدار توسط
MTA تأیید شده است)
.TP
\-t \f[I]seconds\f[R], \-\-timeout=\f[I]seconds\f[R]
مهلت زمانی انتظار برای پاسخ (می‌تواند عدد ممیز شناور باشد،
مانند 0.1)
.TP
\-b \f[I]host:port\f[R], \-\-bind=\f[I]host:port\f[R]
متصل شدن به آدرس IP مشخص‌شده
.TP
\-R, \-\-human
نمایش گزارش خوانا برای انسان.
خط اول خروجی شامل امتیاز پیام و سه امتیاز آستانه با این قالب است:
.IP
.EX
    score/greylist/addheader/reject,action=N:ACTION,spam=0|1,skipped=0|1
.EE
.TP
\-j, \-\-json
خروجی به صورت JSON فرمت‌شده
.TP
\-\-ucl
خروجی به صورت UCL
.TP
\-\-raw
خروجی داده‌های خام دریافت‌شده از rspamd (به صورت JSON فشرده)
.TP
\-\-headers
خروجی هدرهای HTTP از یک پاسخ
.TP
\-\-extended\-urls
نمایش URLها در قالب گسترش‌یافته، شامل نشانی کامل اینترنتی، میزبان و بخشی از
میزبان که توسط ماژول surbl استفاده شده است (در صورت فعال بودن).
.TP
\-n \f[I]parallel_count\f[R], \-\-max\-requests=\f[I]parallel_count\f[R]
حداکثر تعداد درخواست‌های موازی ارسال‌شده به rspamd (پیش‌فرض: 8)
.TP
\-e \f[I]command\f[R], \-\-execute=\f[I]command\f[R]
اجرای دستور مشخص‌شده همراه با خروجی mime (در صورتی که
گزینه \f[CR]mime\f[R] نیز مشخص شده باشد) یا خروجی فرمت‌شده rspamd
.TP
\-\-mime
خروجی کل پیام mime به جای فقط نتایج اسکن
.TP
\-\-header=\f[I]header\f[R]
افزودن هدر سفارشی HTTP برای یک درخواست.
می‌توانید هدر را در قالب \f[CR]name=value\f[R] یا فقط
\f[CR]name\f[R] برای هدر خالی مشخص کنید.
این گزینه می‌تواند چندین بار تکرار شود.
.TP
\-\-sort=\f[I]type\f[R]
مرتب‌سازی خروجی بر اساس یک فیلد خاص.
برای دستور \f[CR]counters\f[R] مقادیر مجاز برای این کلید عبارتند از:
\f[CR]name\f[R]، \f[CR]weight\f[R]، \f[CR]frequency\f[R] و
\f[CR]hits\f[R].
افزودن \f[CR]:asc\f[R] به هر یک از این مقادیر، ترتیب مرتب‌سازی را معکوس می‌کند.
.TP
\-\-commands
فهرست کردن دستورات موجود
.SH "کد خروجی (RETURN VALUE)"
در زمان خروج، اگر عملیات با موفقیت انجام شده باشد \f[CR]rspamc\f[R] مقدار \f[CR]0\f[R]
و در غیر این صورت یک کد خطا بازمی‌گرداند.
.SH "مثال‌ها (EXAMPLES)"
بررسی ورودی استاندارد (stdin):
.IP
.EX
rspamc < some_file
.EE
.PP
بررسی فایل‌ها:
.IP
.EX
rspamc symbols file1 file2 file3
.EE
.PP
آموزش فایل‌ها:
.IP
.EX
rspamc \-P pass learn_spam file1 file2 file3
.EE
.PP
افزودن هش فازی به مجموعه ۲:
.IP
.EX
rspamc \-P pass \-f 2 \-w 10 fuzzy_add file1 file2
.EE
.PP
حذف هش فازی از سرور دیگر:
.IP
.EX
rspamc \-P pass \-h hostname:11334 \-f 2 fuzzy_del file1 file2
.EE
.PP
دریافت آمار:
.IP
.EX
rspamc stat
.EE
.PP
دریافت مدت‌زمان فعال بودن (uptime):
.IP
.EX
rspamc uptime
.EE
.PP
افزودن وزن قانون سفارشی:
.IP
.EX
rspamc add_symbol test 1.5
.EE
.PP
افزودن وزن اقدام سفارشی:
.IP
.EX
rspamc add_action reject 7.1
.EE
.SH "همچنین ببینید (SEE ALSO)"
مستندات و کد منبع Rspamd را می‌توان از نشانی زیر دریافت کرد: \c
.UR https://rspamd.com
.UE \c
\&.