'\" t .\" Title: bogotune .\" Author: [see the "AUTHOR" section] .\" Generator: DocBook XSL Stylesheets vsnapshot .\" Date: 05/19/2019 .\" Manual: Bogofilter Reference Manual .\" Source: Bogofilter .\" Language: Persian .\" .TH "BOGOTUNE" "1" "05/19/2019" "Bogofilter" "راهنمای مرجع Bogofilter" .\" ----------------------------------------------------------------- .\" * 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)" bogotune \- ابزار بهینه‌سازی پارامترهای bogofilter .SH "خلاصه دستور (SYNOPSIS)" .HP \w'\fBbogotune\fR\ 'u \fBbogotune\fR [\-v] [\-c\ \fIconfig\fR] [\-C] [\-d\ \fIdir\fR] [\-D] [\-r\ \fIvalue\fR] [\-T\ \fIvalue\fR] \-n\ \fIokfile\fR\ [[\-n]\ \fIokfile\fR\ [\&.\&.\&.]] \-s\ \fIspamfile\fR\ [[\-s]\ \fIspamfile\fR\ [\&.\&.\&.]] [\-M\ \fIfile\fR] .HP \w'\fBbogotune\fR\ 'u \fBbogotune\fR [\-h] .SH "توضیحات (DESCRIPTION)" .PP برنامه \fBbogotune\fR تلاش می‌کند تا تنظیمات بهینه پارامترها را برای \fBbogofilter\fR بیابد\&. این برنامه حداقل به یک مجموعه از هر یک از پیام‌های هرزنامه و غیرهرزنامه نیاز دارد\&. معمولاً از فهرست کلمات عملیاتی استفاده می‌شود، اما می‌توان آن را هدایت کرد تا فهرست کلمات متفاوتی را بخواند، یا فهرست کلمات خود را از نیمی از پیام‌های ارائه‌شده بسازد\&. .PP به منظور تولید نتایج مفید، \fBbogotune\fR حداقل الزاماتی برای تعداد پیام‌ها دارد\&. فهرست کلماتی که استفاده می‌کند باید حداقل دارای ۲٬۰۰۰ هرزنامه و ۲٬۰۰۰ غیرهرزنامه باشد و فایل‌های پیام باید حداقل شامل ۵۰۰ پیام هرزنامه و ۵۰۰ پیام غیرهرزنامه باشند\&. همچنین، نسبت هرزنامه به غیرهرزنامه باید در محدوده ۰٫۲ تا ۵ باشد\&. اگر به \fBbogotune\fR دستور دهید فهرست کلمات خود را بسازد، از نیمی از ورودی یا ۲۰۰۰ پیام (هر کدام که بزرگ‌تر باشد) برای فهرست کلمات استفاده خواهد کرد\&. .PP فایل‌های پیام می‌توانند در قالب‌های mbox،‏ maildir یا پوشه MH یا هر ترکیبی از آن‌ها باشند\&. فایل‌های msg\-count نیز می‌توانند استفاده شوند، اما نباید با قالب‌های دیگر ترکیب شوند\&. .SH "گزینه‌ها (OPTIONS)" .PP گزینه .B \-h پیام راهنما را چاپ کرده و خارج می‌شود\&. .PP گزینه .B \-v سطح پرگویی (verbosity) را افزایش می‌دهد\&. سطح ۱ خروجی پویش را به جای استفاده از نوار پیشرفت، با جزئیات کامل نمایش می‌دهد\&. .PP گزینه .B \-c \fIfilename\fR به \fBbogofilter\fR می‌گوید فایل پیکربندی مشخص‌شده را بخواند\&. .PP گزینه .B \-C مانع از خواندن فایل پیکربندی توسط \fBbogotune\fR می‌شود\&. .PP گزینه .B \-d \fIdir\fR دایرکتوری پایگاه‌داده را مشخص می‌کند\&. برای سایر گزینه‌های تنظیم دایرکتوری، بخش «محیط (ENVIRONMENT)» را ببینید\&. .PP گزینه .B \-D به \fBbogotune\fR می‌گوید با استفاده از پیام‌های ورودی، یک فهرست کلمات در حافظه بسازد\&. پیام‌ها خوانده شده و به دو گروه تقسیم می‌شوند\&. گروه اول برای ساخت یک فهرست کلمات (در RAM) و گروه دوم برای بهینه‌سازی و تنظیم پارامترها (tuning) استفاده می‌شود\&. برای برآورده کردن حداقل الزاماتِ ۲۰۰۰ پیام در فهرست کلمات و ۵۰۰ پیام برای آزمایش، هنگامی که .B \-D استفاده می‌شود، باید ۲۵۰۰ پیام غیرهرزنامه و ۲۵۰۰ پیام هرزنامه در فایل‌های ورودی وجود داشته باشد\&. اگر پیام‌ها به اندازه کافی باشند (بیش از ۴۰۰۰)، به‌طور مساوی بین فهرست کلمات و آزمایش تقسیم خواهند شد؛ در غیر این صورت، به نسبت متناسب تقسیم می‌شوند\&. .PP گزینه .B \-n به \fBbogotune\fR می‌گوید که آرگومان بعدی یک فایل (یا پوشه) حاوی پیام‌های غیرهرزنامه است\&. از نسخه 1.0.3 به بعد، می‌توان چندین آرگومان به گزینه .B \-n داد\&. با تمامی آرگومان‌های غیرگزینه‌ای تا گزینه .B \-s بعدی، طوری رفتار خواهد شد که گویی پیش از آن‌ها .B \-n آمده است\&. .PP گزینه .B \-s به \fBbogotune\fR می‌گوید که آرگومان بعدی یک فایل (یا پوشه) حاوی هرزنامه است\&. این گزینه می‌تواند به هر تعداد که لازم باشد تکرار شود\&. از نسخه 1.0.3 به بعد، می‌توان چندین آرگومان به .B \-s داد\&. با تمامی آرگومان‌های غیرگزینه‌ای تا گزینه .B \-n بعدی، طوری رفتار خواهد شد که گویی پیش از آن‌ها .B \-s آمده است\&. .PP گزینه .BR \-r \ \fIvalue\fR به \fBbogotune\fR می‌گوید از پارامتر بعدی به عنوان مقدار robx استفاده کند\&. .PP گزینه .BR \-T \ \fIvalue\fR به \fBbogotune\fR می‌گوید از پارامتر بعدی به عنوان مقدار هدف مثبت کاذب (fp target) استفاده کند\&. .PP گزینه .BR \-M \ \fIfile\fR به \fBbogotune\fR می‌گوید فایل را به قالب تعداد پیام (message count format) تبدیل کند\&. این قالب فهرستی مرتب‌شده از توکن‌های یکتای هر پیام را همراه با تعداد تکرار آن‌ها در هرزنامه‌ها و پیام‌های غیرهرزنامه ارائه می‌دهد\&. مرتب‌سازی، مفهوم و محتوای پیام‌ها را به طور بسیار مؤثری پنهان می‌کند و بدین ترتیب حریم خصوصی را حفظ می‌نماید\&. قالب message\-count به \fBbogotune\fR و \fBbogofilter\fR امکان می‌دهد پیام‌ها را بدون نیاز به پایگاه‌داده اصلی توکن‌ها، با سرعت امتیازدهی کنند\&. .SH "محیط (ENVIRONMENT)" .PP برنامه \fBbogofilter\fR از یک دایرکتوری پایگاه‌داده استفاده می‌کند که می‌تواند در فایل پیکربندی تنظیم شود\&. اگر در آنجا تنظیم نشده باشد، \fBbogofilter\fR از مقدار متغیر \fBBOGOFILTER_DIR\fR استفاده خواهد کرد\&. هر دوی این‌ها می‌توانند توسط گزینه .BR \-d \ \fIdir\fR بازنویسی شوند\&. اگر هیچ‌یک از این‌ها در دسترس نباشد، \fBbogofilter\fR از دایرکتوری $HOME/\&.bogofilter استفاده خواهد کرد\&. .SH "اشکالات (BUGS)" .PP برنامه \fBbogotune\fR هنگامی که با ورودی‌های نامعتبر یا نامفهوم مواجه شود، پایداری چندانی ندارد\&. .SH "نویسندگان (AUTHORS)" .PP تیم توسعه‌دهندگان bogofilter\&. .PP برای به‌روزرسانی‌ها به \m[blue]\fBصفحه پروژه bogofilter\fR\m[]\&\s-2\u[1]\d\s+2 مراجعه فرمایید\&. .SH "همچنین ببینید (SEE ALSO)" .PP bogofilter(1), bogolexer(1), bogoupgrade(1), bogoutil(1) .SH "یادداشت‌ها (NOTES)" .IP " 1." 4 صفحه پروژه bogofilter .RS 4 \%http://bogofilter.sourceforge.net .RE