نام (NAME)

bogotune - ابزار بهینه‌سازی پارامترهای bogofilter

خلاصه دستور (SYNOPSIS)

bogotune [-v] [-c config] [-C] [-d dir] [-D] [-r value] [-T value] -n okfile [[-n] okfile [...]] -s spamfile [[-s] spamfile [...]] [-M file]

bogotune [-h]

توضیحات (DESCRIPTION)

برنامه bogotune تلاش می‌کند تا تنظیمات بهینه پارامترها را برای bogofilter بیابد. این برنامه حداقل به یک مجموعه از هر یک از پیام‌های هرزنامه و غیرهرزنامه نیاز دارد. معمولاً از فهرست کلمات عملیاتی استفاده می‌شود، اما می‌توان آن را هدایت کرد تا فهرست کلمات متفاوتی را بخواند، یا فهرست کلمات خود را از نیمی از پیام‌های ارائه‌شده بسازد.

به منظور تولید نتایج مفید، bogotune حداقل الزاماتی برای تعداد پیام‌ها دارد. فهرست کلماتی که استفاده می‌کند باید حداقل دارای ۲٬۰۰۰ هرزنامه و ۲٬۰۰۰ غیرهرزنامه باشد و فایل‌های پیام باید حداقل شامل ۵۰۰ پیام هرزنامه و ۵۰۰ پیام غیرهرزنامه باشند. همچنین، نسبت هرزنامه به غیرهرزنامه باید در محدوده ۰٫۲ تا ۵ باشد. اگر به bogotune دستور دهید فهرست کلمات خود را بسازد، از نیمی از ورودی یا ۲۰۰۰ پیام (هر کدام که بزرگ‌تر باشد) برای فهرست کلمات استفاده خواهد کرد.

فایل‌های پیام می‌توانند در قالب‌های mbox،‏ maildir یا پوشه MH یا هر ترکیبی از آن‌ها باشند. فایل‌های msg-count نیز می‌توانند استفاده شوند، اما نباید با قالب‌های دیگر ترکیب شوند.

گزینه‌ها (OPTIONS)

گزینه -h پیام راهنما را چاپ کرده و خارج می‌شود.

گزینه -v سطح پرگویی (verbosity) را افزایش می‌دهد. سطح ۱ خروجی پویش را به جای استفاده از نوار پیشرفت، با جزئیات کامل نمایش می‌دهد.

گزینه -c filename به bogofilter می‌گوید فایل پیکربندی مشخص‌شده را بخواند.

گزینه -C مانع از خواندن فایل پیکربندی توسط bogotune می‌شود.

گزینه -d dir دایرکتوری پایگاه‌داده را مشخص می‌کند. برای سایر گزینه‌های تنظیم دایرکتوری، بخش «محیط (ENVIRONMENT)» را ببینید.

گزینه -D به bogotune می‌گوید با استفاده از پیام‌های ورودی، یک فهرست کلمات در حافظه بسازد. پیام‌ها خوانده شده و به دو گروه تقسیم می‌شوند. گروه اول برای ساخت یک فهرست کلمات (در RAM) و گروه دوم برای بهینه‌سازی و تنظیم پارامترها (tuning) استفاده می‌شود. برای برآورده کردن حداقل الزاماتِ ۲۰۰۰ پیام در فهرست کلمات و ۵۰۰ پیام برای آزمایش، هنگامی که -D استفاده می‌شود، باید ۲۵۰۰ پیام غیرهرزنامه و ۲۵۰۰ پیام هرزنامه در فایل‌های ورودی وجود داشته باشد. اگر پیام‌ها به اندازه کافی باشند (بیش از ۴۰۰۰)، به‌طور مساوی بین فهرست کلمات و آزمایش تقسیم خواهند شد؛ در غیر این صورت، به نسبت متناسب تقسیم می‌شوند.

گزینه -n به bogotune می‌گوید که آرگومان بعدی یک فایل (یا پوشه) حاوی پیام‌های غیرهرزنامه است. از نسخه 1.0.3 به بعد، می‌توان چندین آرگومان به گزینه -n داد. با تمامی آرگومان‌های غیرگزینه‌ای تا گزینه -s بعدی، طوری رفتار خواهد شد که گویی پیش از آن‌ها -n آمده است.

گزینه -s به bogotune می‌گوید که آرگومان بعدی یک فایل (یا پوشه) حاوی هرزنامه است. این گزینه می‌تواند به هر تعداد که لازم باشد تکرار شود. از نسخه 1.0.3 به بعد، می‌توان چندین آرگومان به -s داد. با تمامی آرگومان‌های غیرگزینه‌ای تا گزینه -n بعدی، طوری رفتار خواهد شد که گویی پیش از آن‌ها -s آمده است.

گزینه -r value به bogotune می‌گوید از پارامتر بعدی به عنوان مقدار robx استفاده کند.

گزینه -T value به bogotune می‌گوید از پارامتر بعدی به عنوان مقدار هدف مثبت کاذب (fp target) استفاده کند.

گزینه -M file به bogotune می‌گوید فایل را به قالب تعداد پیام (message count format) تبدیل کند. این قالب فهرستی مرتب‌شده از توکن‌های یکتای هر پیام را همراه با تعداد تکرار آن‌ها در هرزنامه‌ها و پیام‌های غیرهرزنامه ارائه می‌دهد. مرتب‌سازی، مفهوم و محتوای پیام‌ها را به طور بسیار مؤثری پنهان می‌کند و بدین ترتیب حریم خصوصی را حفظ می‌نماید. قالب message-count به bogotune و bogofilter امکان می‌دهد پیام‌ها را بدون نیاز به پایگاه‌داده اصلی توکن‌ها، با سرعت امتیازدهی کنند.

محیط (ENVIRONMENT)

برنامه bogofilter از یک دایرکتوری پایگاه‌داده استفاده می‌کند که می‌تواند در فایل پیکربندی تنظیم شود. اگر در آنجا تنظیم نشده باشد، bogofilter از مقدار متغیر BOGOFILTER_DIR استفاده خواهد کرد. هر دوی این‌ها می‌توانند توسط گزینه -d dir بازنویسی شوند. اگر هیچ‌یک از این‌ها در دسترس نباشد، bogofilter از دایرکتوری $HOME/.bogofilter استفاده خواهد کرد.

اشکالات (BUGS)

برنامه bogotune هنگامی که با ورودی‌های نامعتبر یا نامفهوم مواجه شود، پایداری چندانی ندارد.

نویسندگان (AUTHORS)

تیم توسعه‌دهندگان bogofilter.

برای به‌روزرسانی‌ها به صفحه پروژه bogofilter[1] مراجعه فرمایید.

همچنین ببینید (SEE ALSO)

bogofilter(1), bogolexer(1), bogoupgrade(1), bogoutil(1)

یادداشت‌ها (NOTES)

1.

صفحه پروژه bogofilter