'\" t .\" Title: bogofilter .\" Author: [see the "AUTHOR" section] .\" Generator: DocBook XSL Stylesheets vsnapshot .\" Date: 05/19/2019 .\" Manual: Bogofilter Reference Manual .\" Source: Bogofilter .\" Language: Persian .\" .TH "BOGOFILTER" "1" "05/19/2019" "Bogofilter" "Bogofilter Reference Manual" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .\" http://bugs.debian.org/507673 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" ----------------------------------------------------------------- .\" * set default formatting .\" ----------------------------------------------------------------- .\" disable hyphenation .nh .\" disable justification (adjust text to left margin only) .ad l .\" ----------------------------------------------------------------- .\" * MAIN CONTENT STARTS HERE * .\" ----------------------------------------------------------------- .SH "نام (NAME)" bogofilter \- فیلتر سریع و آماری بیزی برای تشخیص هرزنامه‌ها و اسپم ایمیل .SH "خلاصه دستور (SYNOPSIS)" .HP \w'\fBbogofilter\fR\ 'u \fBbogofilter\fR [help\ options | classification\ options | registration\ options | parameter\ options | info\ options] [general\ options] [config\ file\ options] .PP که در آن .PP \fBگزینه‌های راهنما (help options)\fR عبارتند از: .HP \w'\ 'u [\-h] [\-\-help] [\-V] [\-Q] .PP \fBگزینه‌های طبقه‌بندی (classification options)\fR عبارتند از: .HP \w'\ 'u [\-p] [\-e] [\-t] [\-T] [\-u] [\-H] [\-M] [\-b] [\-B\ \fIobject\ \&.\&.\&.\fR] [\-R] [general\ options] [parameter\ options] [config\ file\ options] .PP \fBگزینه‌های ثبت (registration options)\fR عبارتند از: .HP \w'\ 'u [\-s | \-n] [\-S | \-N] [general\ options] .PP \fBگزینه‌های عمومی (general options)\fR عبارتند از: .HP \w'\ 'u [\-c\ \fIfilename\fR] [\-C] [\-d\ \fIdir\fR] [\-k\ \fIcachesize\fR] [\-l] [\-L\ \fItag\fR] [\-I\ \fIfilename\fR] [\-O\ \fIfilename\fR] .PP \fBگزینه‌های پارامتر (parameter options)\fR عبارتند از: .HP \w'\ 'u [\-E\ \fIvalue\fR\fI[,value]\fR] [\-m\ \fIvalue\fR\fI[,value]\fR\fI[,value]\fR] [\-o\ \fIvalue\fR\fI[,value]\fR] .PP \fBگزینه‌های اطلاعاتی (info options)\fR عبارتند از: .HP \w'\ 'u [\-v] [\-y\ \fIdate\fR] [\-D] [\-x\ \fIflags\fR] .PP \fBگزینه‌های فایل پیکربندی (config file options)\fR عبارتند از: .HP \w'\ 'u [\-\-\fIoption=value\fR] .PP نکته: از دستور \fBbogofilter \-\-help\fR برای نمایش فهرست کامل گزینه‌ها استفاده کنید\&. .SH "توضیحات (DESCRIPTION)" .PP برنامه Bogofilter یک فیلتر بیزی برای تشخیص هرزنامه (اسپم) است\&. در حالت عادی کارکرد، این برنامه یک پیام ایمیل یا متنی دیگر را از ورودی استاندارد دریافت می‌کند، یک بررسی آماری در برابر فهرست‌های کلمات «خوب» (سالم) و «بد» (اسپم) انجام می‌دهد، و یک کد وضعیت بازمی‌گرداند که نشان می‌دهد آیا پیام هرزنامه است یا خیر\&. Bogofilter با یک الگوریتم سریع طراحی شده است، از Berkeley DB برای راه‌اندازی و جستجوی سریع بهره می‌برد، مستقیماً به زبان C کدنویسی شده و برای سرعت بالا بهینه‌سازی شده است، به طوری که می‌تواند در محیط‌های عملیاتی توسط سرورها و سایت‌هایی که حجم بالایی از ایمیل را پردازش می‌کنند استفاده شود\&. .SH "نحوه کار تئوری (THEORY OF OPERATION)" .PP برنامه Bogofilter با ورودی خود مانند یک کیسه از توکن‌ها (کلمات و نشانه‌ها) رفتار می‌کند\&. هر توکن در برابر یک فهرست کلمات (wordlist) بررسی می‌شود؛ این فهرست تعداد دفعاتی را که آن توکن در ایمیل‌های غیرهرزنامه (ham) و هرزنامه (spam) رخ داده است نگهداری می‌کند\&. از این ارقام برای محاسبه تخمینی از احتمال اینکه پیامی حاوی آن توکن هرزنامه باشد، استفاده می‌شود\&. این مقادیر با یکدیگر ترکیب می‌شوند تا مشخص شود که پیام هرزنامه (spam) است یا پیام سالم (ham)\&. .PP اگرچه این روش در مقایسه با روش‌های رایج‌تر مبتنی بر تطبیق الگو (pattern-matching) ساده به نظر می‌رسد، اما مشخص شده که بسیار مؤثر و کارآمد است\&. مقاله پاول گراهام (Paul Graham) با عنوان \m[blue]\fBA Plan For Spam\fR\m[]\&\s-2\u[1]\d\s+2 برای مطالعه پیشنهاد می‌شود\&. .PP این برنامه با انجام تحلیل واژگانی هوشمندانه‌تر، پیشنهاد پاول را به‌طور چشمگیری بهبود می‌بخشد\&. Bogofilter رمزگشایی مناسب MIME و تجزیه منطقی کدهای HTML را انجام می‌دهد\&. انواع خاصی از توکن‌ها مانند نام‌های میزبان (hostnames) و آدرس‌های IP به جای تجزیه شدن، به عنوان ویژگی‌های شناسایی حفظ می‌شوند\&. انواع مختلف اطلاعات زائد MTA نظیر تاریخ‌ها و شناسه‌های پیام (message-IDs) نادیده گرفته می‌شوند تا حجم فهرست کلمات بی‌دلیل افزایش نیابد\&. توکن‌های یافت‌شده در فیلدهای مختلف سربرگ (header) نیز به‌درستی نشانه‌گذاری می‌شوند\&. .PP بهبود دیگر این است که این برنامه اصلاحات پیشنهادی گری رابینسون (Gary Robinson) در محاسبات را ارائه می‌دهد (پارامترهای robx و robs را در ادامه ببینید)\&. این تغییرات در مقاله رابینسون با عنوان \m[blue]\fBSpam Detection\fR\m[]\&\s-2\u[2]\d\s+2 شرح داده شده‌اند\&. .PP از آن زمان، رابینسون (مقاله او در Linux Journal با عنوان \m[blue]\fBA Statistical Approach to the Spam Problem\fR\m[]\&\s-2\u[3]\d\s+2 را ببینید) و دیگران متوجه شدند که محاسبات را می‌توان با استفاده از روش فیشر (Fisher\*(Aqs method) بیشتر بهینه‌سازی کرد\&. \m[blue]\fBبهبود دیگری\fR\m[]\&\s-2\u[4]\d\s+2 با اعمال فاکتورهای اندازه مؤثر (ESF - effective size factors) جداگانه در محاسبات احتمال هرزنامه و غیرهرزنامه، افزونگی توکن‌ها را جبران می‌کند\&. .PP به‌طور خلاصه، نحوه کار به این صورت است: تخمین‌های مربوط به احتمال هرزنامه بودن توکن‌های منفرد با استفاده از «تابع معکوس کای‌اسکوئر» (inverse chi-square function) ترکیب می‌شوند\&. مقدار آن نشان می‌دهد که فرض صفر (null hypothesis) مبنی بر اینکه پیام صرفاً مجموعه‌ای تصادفی از کلمات مستقل با احتمالات داده شده توسط تخمین‌های پیشین ماست، تا چه حد نقض می‌شود\&. این تابع نسبت به احتمالات کوچک (کلمات سالم / hammish) بسیار حساس است، اما به احتمالات بالا (کلمات هرزنامه / spammish) حساس نیست؛ بنابراین مقدار آن فقط نشان‌دهنده نشانه‌های قوی سالم بودن در یک پیام است\&. اکنون با استفاده از احتمالات معکوس برای توکن‌ها، همان محاسبه دوباره انجام می‌شود که شاخصی از نشانه‌های قوی هرزنامه بودن پیام به دست می‌دهد\&. در نهایت، این دو شاخص از یکدیگر کسر می‌شوند (و در بازه ۰ تا ۱ مقیاس‌بندی می‌گردند)\&. این شاخص ترکیبی (bogosity) اگر نشانه‌های پیام سالم قوی‌تر از پیام هرزنامه باشد به ۰ نزدیک است و اگر وضعیت برعکس باشد به ۱ نزدیک است\&. اگر نشانه‌ها برای هر دو به یک اندازه قوی باشند، مقدار نزدیک به ۰\&.۵ خواهد بود\&. از آنجا که این پیام‌ها نشانه مشخصی ارائه نمی‌دهند، یک حالت سه‌وضعیتی (tristate) در bogofilter وجود دارد تا این پیام‌ها را به عنوان نامطمئن (unsure) علامت‌گذاری کند، در حالی که پیام‌های واضح به ترتیب به عنوان هرزنامه (spam) یا سالم (ham) مشخص می‌شوند\&. در حالت دووضعیتی (two-state)، هر پیام یا به عنوان هرزنامه و یا به عنوان سالم علامت‌گذاری می‌شود\&. .PP پارامترهای متعددی بر این محاسبات تأثیر می‌گذارند که مهم‌ترین آن‌ها عبارتند از: .PP robx: امتیازی که به توکنی که قبلاً دیده نشده اختصاص داده می‌شود\&. robx احتمال هرزنامه بودن آن توکن است\&. .PP robs: وزنی روی robx که احتمال یک توکن کمتر دیده‌شده را به سمت robx سوق می‌دهد\&. .PP min\-dev: حداقل فاصله از ۰\&.۵ برای توکن‌ها تا در محاسبه استفاده شوند\&. فقط توکن‌هایی که فاصله‌شان از ۰\&.۵ بیشتر از این مقدار باشد استفاده می‌شوند\&. .PP spam\-cutoff: پیام‌هایی با امتیاز بزرگتر یا مساوی این مقدار به عنوان هرزنامه (spam) علامت‌گذاری می‌شوند\&. .PP ham\-cutoff: اگر صفر یا برابر با spam\-cutoff باشد، تمام پیام‌هایی با مقادیر اکیداً کمتر از spam\-cutoff به عنوان سالم (ham) و بقیه به عنوان هرزنامه (دووضعیتی) علامت‌گذاری می‌شوند\&. در غیر این صورت مقادیر کمتر یا مساوی ham\-cutoff به عنوان سالم علامت‌گذاری می‌شوند، پیام‌هایی با مقادیر اکیداً بین ham\-cutoff و spam\-cutoff به عنوان نامطمئن (unsure) و مابقی به عنوان هرزنامه (سه‌وضعیتی) علامت‌گذاری می‌شوند\&. .PP sp\-esf: فاکتور اندازه مؤثر (ESF) برای هرزنامه (spam)\&. .PP ns\-esf: فاکتور اندازه مؤثر (ESF) برای غیرهرزنامه (nonspam)\&. مقدار پیش‌فرض این مقادیر ESF برابر با ۱\&.۰ است که معادل عدم استفاده از ESF در محاسبات است\&. مقادیر مناسب برای جامعه ایمیل کاربر را می‌توان با کمک برنامه bogotune تعیین کرد\&. .SH "گزینه‌ها (OPTIONS)" .PP گزینه‌های راهنما (HELP OPTIONS) .PP گزینه .B \-h پیام راهنما را چاپ کرده و خارج می‌شود\&. .PP گزینه .B \-V شماره نسخه را چاپ کرده و خارج می‌شود\&. .PP گزینه .B \-Q (پرس‌وجو / query) پیکربندی bogofilter، شامل پارامترهای ثبت، گزینه‌های تجزیه، دایرکتوری bogofilter و غیره را چاپ می‌کند\&. .PP گزینه‌های طبقه‌بندی (CLASSIFICATION OPTIONS) .PP گزینه .B \-p (عبور مستقیم / passthrough) پیام را همراه با یک خط X\-Bogosity در انتهای سربرگ پیام خروجی می‌دهد\&. این کار مستلزم نگهداری کل پیام در حافظه هنگام خواندن از ورودی استاندارد stdin (یا از یک لوله یا سوکت) است\&. اگر پیام از فایلی خوانده شود که امکان بازگشت به ابتدا (rewind) را دارد، bogofilter آن را برای بار دوم می‌خواند\&. .PP گزینه .B \-e (جاسازی / embed) به bogofilter می‌گوید در صورتی که پیام قابل طبقه‌بندی باشد (یعنی خطایی رخ ندهد) با کد خروج ۰ خارج شود\&. در حالت عادی bogofilter از کدهای متفاوتی برای طبقه‌بندی‌های هرزنامه (spam)، سالم (ham) و نامطمئن (unsure) استفاده می‌کند، اما این گزینه استفاده از bogofilter را به همراه procmail یا maildrop ساده‌تر می‌سازد\&. .PP گزینه .B \-t (مختصر / terse) به bogofilter دستور می‌دهد تا یک پیام خلاصه هرزنامگی شامل ۱ حرف و امتیاز را چاپ کند\&. هرزنامه با «Y»، سالم با «N» و نامطمئن با «U» نشان داده می‌شود\&. نکته: فرمت‌بندی را می‌توان با استفاده از فایل پیکربندی سفارشی کرد\&. .PP گزینه .B \-T یک حالت مختصر تغییرناپذیر برای استفاده در اسکریپت‌ها فراهم می‌کند\&. bogofilter یک پیام خلاصه هرزنامگی شامل ۱ حرف و امتیاز را چاپ خواهد کرد\&. هرزنامه با «S»، سالم با «H» و نامطمئن با «U» مشخص می‌شود\&. .PP گزینه .B \-TT یک حالت مختصر ثابت برای استفاده در اسکریپت‌ها فراهم می‌آورد\&. Bogofilter تنها امتیاز را با ۱۶ رقم بااهمیت نمایش می‌دهد\&. .PP گزینه .B \-u به bogofilter دستور می‌دهد تا متن پیام را پس از طبقه‌بندی به عنوان هرزنامه یا غیرهرزنامه، ثبت کند\&. یک پیام هرزنامه در فهرست هرزنامه‌ها (spamlist) و یک پیام غیرهرزنامه در فهرست پیام‌های خوب (goodlist) ثبت خواهد شد\&. اگر نتیجه طبقه‌بندی «نامطمئن» (unsure) باشد، پیام ثبت نخواهد شد\&. در واقع این گزینه bogofilter را با پرچم .B \-s یا .B \-n (بر حسب مورد) اجرا می‌کند\&. در استفاده از این قابلیت احتیاط توصیه می‌شود، زیرا هرگونه خطای طبقه‌بندی که bogofilter مرتکب شود حفظ شده و انباشته خواهد شد تا زمانی که به‌صورت دستی با ترکیب گزینه‌های .B \-Sn و .B \-Ns اصلاح گردد\&. توجه داشته باشید که این گزینه باعث می‌شود پایگاه‌داده برای دسترسی نوشتن باز شود، که می‌تواند به دلیل تداخل قفل‌ها و عملیات همگام I/O منجر به افت شدید سرعت شود\&. .PP گزینه .B \-H به bogofilter دستور می‌دهد که توکن‌های موجود در سربرگ را برچسب‌گذاری نکند\&. این گزینه برای آزمایش است و نباید در عملکرد عادی از آن استفاده کنید\&. .PP گزینه .B \-M به bogofilter دستور می‌دهد تا ورودی خود را به عنوان یک فایل با فرمت mbox پردازش کند\&. اگر گزینه .B \-v یا .B \-t نیز داده شده باشد، یک خط وضعیت هرزنامگی برای هر پیام چاپ خواهد شد\&. .PP گزینه .B \-b (حالت دسته‌ای جریانی / streaming bulk mode) به bogofilter می‌گوید چندین شیء را که نام آن‌ها از stdin خوانده می‌شود طبقه‌بندی کند\&. اگر گزینه .B \-v یا .B \-t نیز مشخص شده باشد، bogofilter یک خط حاوی نام فایل و اطلاعات طبقه‌بندی را برای هر فایل چاپ خواهد کرد\&. این یک جایگزین برای گزینه .B \-B است که اشیاء را در خط فرمان فهرست می‌کند\&. .PP یک شیء در این زمینه می‌تواند یک maildir (تشخیص خودکار)، یا اگر maildir نباشد، یک پیام منفرد باشد مگر اینکه گزینه .B \-M داده شده باشد \- که در این صورت به عنوان mbox پردازش می‌شود\&. (سربرگ Content\-Length: در حال حاضر در نظر گرفته نمی‌شود\&.) .PP هنگام خواندن فرمت mbox، برنامه bogofilter به خط خالی پس از هر ایمیل اتکا می‌کند\&. در صورت نیاز، دستور \fBformail \-es\fR اطمینان حاصل می‌کند که این مورد رعایت شده است\&. .PP گزینه .B \-B \fIobject \&.\&.\&.\fR (حالت دسته‌ای / bulk mode) به bogofilter دستور می‌دهد چندین شیء مشخص‌شده در خط فرمان را طبقه‌بندی کند\&. این اشیاء می‌توانند نام فایل‌ها (برای پیام‌های منفرد)، صندوق‌های پستی (فایل‌های حاوی چندین پیام) یا دایرکتوری‌ها (با فرمت maildir و MH) باشند\&. اگر گزینه .B \-v یا .B \-t نیز مشخص شده باشد، bogofilter یک خط حاوی نام فایل و اطلاعات طبقه‌بندی برای هر فایل چاپ خواهد کرد\&. این یک جایگزین برای گزینه .B \-b است که اشیاء را از ورودی استاندارد stdin می‌خواند\&. .PP گزینه .B \-R به bogofilter دستور می‌دهد تا یک دیتا فریم R (R data frame) را به صورت متنی در خروجی استاندارد تولید کند\&. برای جزئیات بیشتر، بخش یکپارچه‌سازی با R را در ادامه ببینید\&. .PP گزینه‌های ثبت (REGISTRATION OPTIONS) .PP گزینه .B \-s به bogofilter می‌گوید متن ارائه‌شده را به عنوان هرزنامه (spam) ثبت کند\&. در صورت عدم وجود پایگاه‌داده، ایجاد خواهد شد\&. .PP گزینه .B \-n به bogofilter می‌گوید متن ارائه‌شده را به عنوان غیرهرزنامه (non-spam) ثبت کند\&. .PP برنامه Bogofilter ثبت دوباره یک پیام را تشخیص نمی‌دهد\&. اگر این کار را تصادفی انجام دهید، شمارش توکن‌ها ۱ واحد با آنچه واقعاً می‌خواهید اختلاف خواهد داشت و امتیازهای هرزنامگی متناظر کمی تغییر خواهند کرد\&. با توجه به تعداد زیاد توکن‌ها و پیام‌ها در فهرست کلمات، این موضوع اهمیت چندانی ندارد\&. این مشکل \fIمی‌تواند\fR با استفاده از گزینه .B \-S یا گزینه .B \-N اصلاح شود\&. .PP گزینه .B \-S به bogofilter دستور می‌دهد ثبت قبلی همان پیام به عنوان هرزنامه را لغو (undo) کند\&. اگر پیامی به اشتباه با گزینه .B \-s یا .B \-u به عنوان هرزنامه ثبت شده باشد و بخواهید آن را حذف کرده و به عنوان غیرهرزنامه ثبت کنید، از .B \-Sn استفاده کنید\&. اگر .B \-S برای پیامی استفاده شود که به عنوان هرزنامه ثبت نشده بوده است، شمارنده‌ها همچنان یک واحد کاهش می‌یابند\&. .PP گزینه .B \-N به bogofilter دستور می‌دهد ثبت قبلی همان پیام به عنوان غیرهرزنامه را لغو کند\&. اگر پیامی به اشتباه با گزینه .B \-n یا .B \-u به عنوان غیرهرزنامه ثبت شده باشد و بخواهید آن را حذف کرده و به عنوان هرزنامه ثبت نمایید، از .B \-Ns استفاده کنید\&. اگر .B \-N برای پیامی استفاده شود که به عنوان غیرهرزنامه ثبت نشده بوده است، شمارنده‌ها همچنان کاهش خواهند یافت\&. .PP گزینه‌های عمومی (GENERAL OPTIONS) .PP گزینه .B \-c \fIfilename\fR به bogofilter می‌گوید فایل پیکربندی نام‌برده را بخواند\&. .PP گزینه .B \-C از خواندن فایل‌های پیکربندی توسط bogofilter جلوگیری می‌کند\&. .PP گزینه .B \-d \fIdir\fR به شما امکان می‌دهد دایرکتوری پایگاه‌داده را تنظیم کنید\&. برای سایر گزینه‌های تنظیم دایرکتوری، بخش محیط (ENVIRONMENT) را ببینید\&. .PP گزینه .B \-k \fIcachesize\fR اندازه حافظه نهان (کَش) زیرسیستم BerkeleyDB را بر حسب واحد ۱ مبی‌بایت (۱٬۰۴۸٬۵۷۶ بایت) تنظیم می‌کند\&. اندازه مناسب کش عملکرد bogofilter را بهبود می‌بخشد\&. اندازه توصیه‌شده یک‌سوم اندازه فایل پایگاه‌داده است\&. می‌توانید اسکریپت bogotune (در پوشه tuning) را برای تعیین اندازه توصیه‌شده اجرا کنید\&. .PP گزینه .B \-l در هر بار اجرای bogofilter یک خط اطلاعاتی در لاگ سیستم (system log) می‌نویسد\&. اطلاعات ثبت‌شده به نحوه اجرای bogofilter بستگی دارد\&. .PP گزینه .B \-L \fItag\fR برچسبی را پیکربندی می‌کند که می‌تواند در اطلاعات ثبت‌شده توسط گزینه .B \-l گنجانده شود، اما در حال حاضر نیازمند یک فرمت سفارشی حاوی رشته %l است\&. این گزینه مستلزم فعال بودن .B \-l است\&. .PP گزینه .B \-I \fIfilename\fR به bogofilter دستور می‌دهد تا ورودی خود را به جای \fBstdin\fR از فایل مشخص‌شده بخواند\&. .PP گزینه .B \-O \fIfilename\fR به bogofilter می‌گوید در حالت عبور مستقیم (passthrough) خروجی خود را در کجا بنویسد\&. توجه داشته باشید که این گزینه فقط زمانی کار می‌کند که \-p به‌طور صریح مشخص شده باشد\&. .PP گزینه‌های پارامتر (PARAMETER OPTIONS) .PP گزینه .B \-E \fIvalue\fR\fI[,value]\fR امکان تنظیم مقدار sp\-esf و مقدار ns\-esf را فراهم می‌کند\&. با دو مقدار، هم sp\-esf و هم ns\-esf تنظیم می‌شوند\&. اگر فقط یک مقدار داده شود، پارامترها طبق توضیحات یادداشت زیر تنظیم می‌شوند\&. .PP گزینه .B \-m \fIvalue\fR\fI[,value]\fR\fI[,value]\fR امکان تنظیم مقدار min\-dev و در صورت تمایل، مقادیر robs و robx را فراهم می‌کند\&. با سه مقدار، min\-dev، robs و robx همگی تنظیم می‌شوند\&. اگر مقادیر کمتری داده شود، پارامترها طبق توضیحات یادداشت زیر تنظیم می‌شوند\&. .PP گزینه .B \-o \fIvalue\fR\fI[,value]\fR امکان تنظیم مقادیر spam\-cutoff و ham\-cutoff را فراهم می‌کند\&. با دو مقدار، هم spam\-cutoff و هم ham\-cutoff تنظیم می‌شوند\&. اگر فقط یک مقدار داده شود، پارامترها طبق توضیحات یادداشت زیر تنظیم می‌شوند\&. .PP نکته: تمامی این گزینه‌ها اجازه می‌دهند که مقادیر کمتری ارائه شود\&. مقادیر را می‌توان با استفاده از علامت کاما خالی گذاشت که در این صورت پارامتر(های) متناظر تغییر نخواهند کرد\&. اگر فقط مقدار اول ارائه شود، تنها پارامتر اول تنظیم می‌شود\&. مقادیر انتهایی را می‌توان نادیده گرفت که در این صورت پارامترهای متناظر تغییر نخواهند کرد\&. در فهرست پارامترها، فاصله بعد از کاما مجاز نیست\&. .PP گزینه‌های اطلاعاتی (INFO OPTIONS) .PP گزینه .B \-v گزارشی از تحلیل bogofilter روی ورودی در خروجی استاندارد تولید می‌کند\&. هر \fBv\fR اضافی میزان جزئیات خروجی را تا حداکثر ۴ افزایش می‌دهد\&. با \fB\-vv\fR، گزارش توکن‌هایی را که بیشترین انحراف از میانگین وابستگی ۰\&.۵ به هرزنامه را دارند فهرست می‌کند\&. .PP گزینه .B \-y date می‌تواند برای لغو تاریخ جاری هنگام برچسب‌گذاری زمانی توکن‌ها استفاده شود\&. مقدار صفر (0) برچسب زمانی را غیرفعال می‌کند\&. .PP گزینه .B \-D خروجی اشکال‌زدایی (debug) را به خروجی استاندارد هدایت می‌کند\&. .PP گزینه .B \-x \fIflags\fR امکان تنظیم فلگ‌های اشکال‌زدایی را برای چاپ اطلاعات دیباگ فراهم می‌سازد\&. برای فهرست فلگ‌های قابل استفاده، فایل سربرگ debug\&.h را ببینید\&. .PP گزینه‌های فایل پیکربندی (CONFIG FILE OPTIONS) .PP با استفاده از نحو longopt گنو \fB\-\-\fR، عبارت \fB\fIname=value\fR\fR در فایل پیکربندی تبدیل به \fB\-\-\fR\fB\fIoption=value\fR\fR در خط فرمان می‌شود\&. برای مشاهده فهرست گزینه‌ها از دستور \fBbogofilter \-\-help\fR استفاده کنید و برای اطلاعات بیشتر درباره آن‌ها فایل bogofilter\&.cf\&.example را ببینید\&. برای مثال برای تغییر هدر X\-Bogosity به "X\-Spam\-Header"، از دستور زیر استفاده کنید: .PP \fB\fI\-\-spam\-header\-name=X\-Spam\-Header\fR\fR .SH "محیط (ENVIRONMENT)" .PP برنامه Bogofilter از یک دایرکتوری پایگاه‌داده استفاده می‌کند که می‌توان آن را در فایل پیکربندی تنظیم کرد\&. اگر در آنجا تنظیم نشده باشد، bogofilter از مقدار متغیر محیطی \fBBOGOFILTER_DIR\fR استفاده خواهد کرد\&. هر دو مورد را می‌توان با گزینه .B \-d \fIdir\fR بازنویسی (override) کرد\&. اگر هیچ‌یک از این موارد در دسترس نباشد، bogofilter از دایرکتوری $HOME/\&.bogofilter استفاده می‌کند\&. .SH "پیکربندی (CONFIGURATION)" .PP خط فرمان bogofilter امکان تنظیم گزینه‌های متعددی را فراهم می‌کند که نحوه عملکرد bogofilter را تعیین می‌کنند\&. از فایل /etc/bogofilter/bogofilter\&.cf می‌توان برای تنظیم پارامترهای اضافی که بر عملکرد آن تأثیر می‌گذارند استفاده کرد\&. فایل /etc/bogofilter/bogofilter\&.cf\&.example حاوی نمونه‌هایی از تمام پارامترها است\&. پیام‌های وضعیت و ثبت لاگ را می‌توان برای هر سرور و محیط به صورت سفارشی تنظیم کرد\&. .SH "وضعیت خروج (EXIT STATUS)" .PP مقدار ۰ برای هرزنامه (spam)؛ ۱ برای غیرهرزنامه (non-spam)؛ ۲ برای نامطمئن (unsure)؛ ۳ برای خطاهای ورودی/خروجی (I/O) یا سایر خطاها\&. .PP اگر هر دو گزینه .B \-p و .B \-e استفاده شوند، مقادیر بازگشتی عبارتند از: ۰ برای هرزنامه یا غیرهرزنامه؛ ۳ برای خطاهای ورودی/خروجی یا سایر خطاها\&. .PP خطای ۳ معمولاً به این معنی است که فایل فهرست کلماتی که bogofilter می‌خواهد در زمان راه‌اندازی بخواند وجود ندارد یا دیسک سخت در حالت .B \-p پر شده است\&. .SH "یکپارچه‌سازی با سایر ابزارها (INTEGRATION WITH OTHER TOOLS)" .PP استفاده به همراه procmail .PP دستورالعمل (recipe) زیر (الف) هر پیامی را که bogofilter به عنوان هرزنامه ارزیابی کند در صندوق هرزنامه قرار می‌دهد، (ب) کلمات موجود در پیام‌های ارزیابی‌شده به عنوان هرزنامه را به عنوان هرزنامه ثبت می‌کند، و (ج) کلمات موجود در پیام‌های ارزیابی‌شده به عنوان غیرهرزنامه را به عنوان غیرهرزنامه ثبت می‌کند\&. با استقرار این دستورالعمل، معمولاً تنها زمانی نیاز به دخالت کاربر (با گزینه‌های .B \-Ns یا .B \-Sn\fR) خواهد بود که bogofilter پیامی را به اشتباه دسته‌بندی کرده باشد\&. .sp .if n \{\ .RS 4 .\} .nf # فیلتر کردن ایمیل از طریق bogofilter، برچسب‌گذاری به عنوان Ham، Spam یا Unsure # و به‌روزرسانی فهرست کلمات (wordlist) :0fw | bogofilter \-u \-e \-p # اگر اجرای bogofilter ناموفق بود، ایمیل به صف بازگردانده می‌شود؛ # سرور MTA بعداً ارسال مجدد آن را امتحان خواهد کرد # مقدار ۷۵ همان مقدار EX_TEMPFAIL در /usr/include/sysexits.h است :0e { EXITCODE=75 HOST } # انتقال ایمیل به spam-bogofilter در صورتی که هرزنامه باشد :0: * ^X\-Bogosity: Spam, tests=bogofilter spam\-bogofilter # انتقال ایمیل به unsure-bogofilter # در صورتی که نه هرزنامه و نه سالم تشخیص داده شود :0: * ^X\-Bogosity: Unsure, tests=bogofilter unsure\-bogofilter # با این دستورالعمل می‌توانید آموزش bogofilter را با یک فهرست کلمات # خالی آغاز کنید. حتماً پوشه unsure خود را مرتباً بررسی کنید، # پیام‌ها را از آن خارج کرده، به عنوان ham (یا spam) دسته‌بندی نموده # و از آن‌ها برای آموزش bogofilter استفاده کنید. .fi .if n \{\ .RE .\} .PP قاعده procmail زیر ایمیل را از ورودی استاندارد stdin دریافت کرده و در صورت تشخیص هرزنامه بودن توسط bogofilter، آن را در فایل spam ذخیره می‌کند: .sp .if n \{\ .RS 4 .\} .nf :0HB: * ? bogofilter spam .fi .if n \{\ .RE .\} .sp و این قاعده مشابه نیز توکن‌های موجود در ایمیل را مطابق با طبقه‌بندی bogofilter ثبت می‌کند: .sp .if n \{\ .RS 4 .\} .nf :0HB: * ? bogofilter \-u spam .fi .if n \{\ .RE .\} .PP اگر bogofilter با شکست مواجه شود (بازگرداندن مقدار ۳)، با پیام به عنوان غیرهرزنامه رفتار خواهد شد\&. .PP این پیکربندی برای maildrop است؛ این دستور به طور خودکار تحویل ایمیل را به تعویق انداخته و زمانی که دستور xfilter با شکست مواجه شود دوباره تلاش می‌کند؛ از این مورد در فایل ~/\&.mailfilter خود استفاده کنید: .sp .if n \{\ .RS 4 .\} .nf xfilter "bogofilter \-u \-e \-p" if (/^X\-Bogosity: Spam, tests=bogofilter/) { to "spam\-bogofilter" } .fi .if n \{\ .RE .\} .PP خطوط زیر در فایل \&.muttrc ماکروهای mutt را برای ارسال ایمیل به bogofilter ایجاد می‌کنند\&. .sp .if n \{\ .RS 4 .\} .nf macro index d "unset wait_key\en\e bogofilter \-n\en\e set wait_key\en\e " "delete message as non\-spam" macro index \eed "unset wait_key\en\e bogofilter \-s\en\e set wait_key\en\e " "delete message as spam" .fi .if n \{\ .RE .\} .PP یکپارچه‌سازی با عامل انتقال پیام (MTA) .sp .RS 4 .ie n \{\ \h'-04' 1.\h'+01'\c .\} .el \{\ .sp -1 .IP " 1." 4.2 .\} برنامه bogofilter همچنین می‌تواند در یک MTA ادغام شود تا تمام ایمیل‌های ورودی را فیلتر کند\&. اگرچه پیاده‌سازی خاص به نوع MTA وابسته است، اما مراحل کلی به شرح زیر است: .RE .sp .RS 4 .ie n \{\ \h'-04' 2.\h'+01'\c .\} .el \{\ .sp -1 .IP " 2." 4.2 .\} نصب bogofilter روی سرور ایمیل .RE .sp .RS 4 .ie n \{\ \h'-04' 3.\h'+01'\c .\} .el \{\ .sp -1 .IP " 3." 4.2 .\} آماده‌سازی و تغذیه اولیه پایگاه‌های داده bogofilter با مجموعه‌ای از پیام‌های هرزنامه و غیرهرزنامه\&. از آنجا که bogofilter به جامعه بزرگ‌تری از کاربران خدمت خواهد کرد، بسیار مهم است که آن را با مجموعه‌ای معرف و نمونه از پیام‌ها آماده‌سازی کنید\&. .RE .sp .RS 4 .ie n \{\ \h'-04' 4.\h'+01'\c .\} .el \{\ .sp -1 .IP " 4." 4.2 .\} تنظیم MTA برای فراخوانی bogofilter روی هر پیام\&. اگرچه این مرحله وابسته به MTA است، اما احتمالاً باید از گزینه‌های .B \-p\fR، .B \-u و .B \-e استفاده کنید\&. .RE .sp .RS 4 .ie n \{\ \h'-04' 5.\h'+01'\c .\} .el \{\ .sp -1 .IP " 5." 4.2 .\} راه‌اندازی مکانیزمی برای کاربران جهت ثبت پیام‌های هرزنامه/غیرهرزنامه و همچنین تصحیح طبقه‌بندی‌های نادرست\&. عمومی‌ترین راه‌حل ایجاد آدرس‌های ایمیل مستعار (alias) است که کاربران پیام‌ها را به آن‌ها بازارسال (bounce) می‌کنند\&. .RE .sp .RS 4 .ie n \{\ \h'-04' 6.\h'+01'\c .\} .el \{\ .sp -1 .IP " 6." 4.2 .\} برای اطلاعات بیشتر دایرکتوری‌های doc و contrib را ببینید\&. .RE .PP استفاده از R برای تأیید محاسبات bogofilter .PP گزینه \-R به bogofilter دستور می‌دهد تا یک دیتا فریم R تولید کند\&. این دیتا فریم برای هر توکن تحلیل‌شده شامل یک ردیف است\&. هر ردیف شامل توکن، مجموع شمارش‌های «خوب» و «اسپم» آن در پایگاه‌داده، شمارش «خوب» تقسیم بر تعداد پیام‌های غیرهرزنامه استفاده‌شده برای ایجاد پایگاه‌داده آموزشی، شمارش «اسپم» تقسیم بر تعداد پیام‌های هرزنامه، مقدار f(w) رابینسون برای آن توکن، لگاریتم‌های طبیعی (1 \- f(w)) و f(w)، و یک نویسه نشانگر (+ اگر مقدار f(w) توکن از حداقل انحراف از ۰\&.۵ فراتر رفته باشد، و \- اگر فراتر نرفته باشد) است\&. یک ردیف اضافی در انتهای جدول وجود دارد که شامل یک برچسب در فیلد توکن، و به دنبال آن تعداد کلمات واقعاً استفاده‌شده (آن‌هایی که نشانگر + دارند)، مقادیر P، Q، S، s و x رابینسون و مقدار حداقل انحراف است\&. .PP دیتا فریم R را می‌توان در یک فایل ذخیره کرد و بعداً در یک نشست R بارگذاری نمود (برای اطلاعات درباره بسته محاسباتی و ریاضی R، \m[blue]\fBوب‌سایت پروژه R\fR\m[]\&\s-2\u[5]\d\s+2 را ببینید)\&. همراه با توزیع bogofilter، یک اسکریپت ساده R (فایل bogo\&.R) ارائه شده است که می‌تواند برای تأیید محاسبات bogofilter استفاده شود\&. دستورالعمل‌های استفاده از آن در قالب کامنت درون اسکریپت گنجانده شده است\&. .SH "پیام‌های لاگ (LOG MESSAGES)" .PP برنامه Bogofilter هنگام استفاده از گزینه .B \-l پیام‌هایی را در لاگ سیستم می‌نویسد\&. آنچه نوشته می‌شود به این بستگی دارد که از کدام پرچم‌های دیگر استفاده شده است\&. .PP یک اجرای طبقه‌بندی پیام‌های زیر را تولید خواهد کرد (در اینجا بخش تاریخ و میزبان نشان داده نشده است): .sp .if n \{\ .RS 4 .\} .nf bogofilter[1412]: X\-Bogosity: Ham, spamicity=0\&.000227 bogofilter[1415]: X\-Bogosity: Spam, spamicity=0\&.998918 .fi .if n \{\ .RE .\} .PP استفاده از .B \-u برای طبقه‌بندی یک پیام و به‌روزرسانی فهرست کلمات، خروجی زیر را تولید می‌کند (در یک خط): .sp .if n \{\ .RS 4 .\} .nf bogofilter[1426]: X\-Bogosity: Spam, spamicity=0\&.998918, register \-s, 329 words, 1 messages .fi .if n \{\ .RE .\} .PP ثبت کلمات (\fB\-l\fR و \fB\-s\fR، \fB\-n\fR، \fB\-S\fR یا \fB\-N\fR) خروجی زیر را ایجاد خواهد کرد: .sp .if n \{\ .RS 4 .\} .nf bogofilter[1440]: register\-n, 255 words, 1 messages .fi .if n \{\ .RE .\} .PP یک اجرای ثبت (با استفاده از \fB\-s\fR، \fB\-n\fR، \fB\-N\fR یا \fB\-S\fR) پیام‌هایی مانند زیر را تولید خواهد کرد: .sp .if n \{\ .RS 4 .\} .nf bogofilter[17330]: register\-n, 574 words, 3 messages bogofilter[6244]: register\-s, 1273 words, 4 messages .fi .if n \{\ .RE .\} .SH "فایل‌ها (FILES)" .PP /etc/bogofilter/bogofilter\&.cf .RS 4 فایل پیکربندی سیستم\&. .RE .PP ~/\&.bogofilter\&.cf .RS 4 فایل پیکربندی کاربر\&. .RE .PP ~/\&.bogofilter/wordlist\&.db .RS 4 فهرست ترکیبی توکن‌های سالم و هرزنامه\&. .RE .SH "نویسندگان (AUTHORS)" .sp .if n \{\ .RS 4 .\} .nf Eric S\&. Raymond \&. David Relson \&. Matthias Andree \&. Greg Louis \&. .fi .if n \{\ .RE .\} .PP برای دریافت به‌روزرسانی‌ها، به \m[blue]\fBصفحه پروژه bogofilter\fR\m[]\&\s-2\u[6]\d\s+2 مراجعه کنید\&. .SH "همچنین ببینید (SEE ALSO)" .PP \fBbogolexer\fR(1), \fBbogotune\fR(1), \fBbogoupgrade\fR(1), \fBbogoutil\fR(1) .SH "یادداشت‌ها (NOTES)" .IP " 1." 4 A Plan For Spam .RS 4 \%http://www.paulgraham.com/spam.html .RE .IP " 2." 4 Spam Detection .RS 4 \%http://radio-weblogs.com/0101454/stories/2002/09/16/spamDetection.html .RE .IP " 3." 4 A Statistical Approach to the Spam Problem .RS 4 \%http://www.linuxjournal.com/article/6467 .RE .IP " 4." 4 Another improvement .RS 4 \%http://www.garyrobinson.net/2004/04/improved%5fchi.html .RE .IP " 5." 4 the R project website .RS 4 \%http://cran.r-project.org .RE .IP " 6." 4 bogofilter project page .RS 4 \%http://bogofilter.sourceforge.net .RE