نام (NAME)

bogoutil - ابزار مدیریت و نمایش پایگاهدادههای کلمات bogofilter

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

bogoutil {-h | -V}

bogoutil [گزینه‌ها] {-d file | -H file | -l file | -m file | -w file | -p file}

bogoutil {-r file | -R file}

bogoutil {--db-print-leafpage-count file | --db-print-pagesize file | --db-verify file | --db-checkpoint directory [flag...] | --db-list-logfiles directory | --db-prune directory | --db-recover directory | --db-recover-harder directory | --db-remove-environment directory}

که در آن گزینه‌ها عبارت است از:

bogoutil [-v] [-n] [-C] [-D] [-a age] [-c count] [-s min,max] [-y date] [-I file] [-O file] [-x flags] [--config-file file]

توضیحات (DESCRIPTION)

دستور Bogoutil بخشی از بسته فیلتر هرزنامه بیزی bogofilter است.

این ابزار برای استخراج (dump) و بارگذاری (load) پایگاه‌داده‌های Berkeley DB مربوط به bogofilter به و از فایل‌های متنی، انجام عملیات نگهداری پایگاه‌داده، و نمایش مقادیر کلمات خاص استفاده می‌شود.

گزینه‌ها (OPTIONS)

گزینه -d file به bogoutil دستور می‌دهد محتویات فایل پایگاه‌داده را در stdout چاپ کند.

گزینه -H file به bogoutil دستور می‌دهد یک هیستوگرام از فایل پایگاه‌داده را در stdout چاپ کند. خروجی مشابه خروجی bogofilter -vv است. در نهایت، واژه‌های تک‌رخداد (hapaxes یا نشانه‌هایی که تنها یک بار دیده شده‌اند) و نشانه‌های خالص (نشانه‌هایی که تنها در هرزنامه یا پیام‌های سالم دیده شده‌اند) شمارش می‌شوند.

گزینه -l file به bogoutil دستور می‌دهد داده‌ها را از stdin در فایل پایگاه‌داده بارگذاری کند. اگر فایل پایگاه‌داده موجود باشد، داده‌های stdin با فایل پایگاه‌داده ادغام شده و شمارش‌ها با هم جمع می‌شوند.

گزینه -m به bogoutil دستور می‌دهد عملیات نگهداری را روی پایگاه‌داده مشخص‌شده اجرا کند؛ به این معنی که نشانه‌های قدیمی‌تر از حد مطلوب، نشانه‌هایی با تعداد رخداد بسیار کم، یا نشانه‌هایی با اندازه (طول) بسیار کوتاه یا بسیار بلند را حذف نماید.

گزینه -w file به bogoutil دستور می‌دهد اطلاعات نشانه را از فایل پایگاه‌داده نمایش دهد. این گزینه یک آرگومان می‌گیرد که یا نام لیست کلمات (معمولاً wordlist.db) یا نام پوشه حاوی آن است. نشانه‌ها را می‌توان در خط فرمان مشخص کرد یا به bogoutil لوله (pipe) نمود. هنگامی که آرگومان‌های اضافی در خط فرمان وجود داشته باشد، bogoutil از آن‌ها به عنوان نشانه‌های مورد جستجو استفاده خواهد کرد. اگر آرگومان اضافی وجود نداشته باشد، bogoutil نشانه‌ها را از stdin می‌خواند.

گزینه -p file به bogoutil دستور می‌دهد اطلاعات پایگاه‌داده را برای یک یا چند نشانه نمایش دهد. این نمایش شامل ستون احتمال به همراه امتیاز هرزنامه نشانه است (که با مقادیر پیش‌فرض bogofilter محاسبه می‌شود). گزینه -p همان آرگومان‌های گزینه -w را دریافت می‌کند.

گزینه -r file به bogoutil دستور می‌دهد مقدار ROBX را مجدداً محاسبه کرده و آن را به عنوان یک کسر شش‌رقمی چاپ کند.

گزینه -R file همان کار -r را انجام می‌دهد، اما نتیجه را بدون چاپ کردن در پایگاه‌داده آموزشی ذخیره می‌کند.

گزینه -I file به bogoutil دستور می‌دهد ورودی خود را به جای stdin از file بخواند.

گزینه -O file به bogoutil دستور می‌دهد خروجی خود را به جای stdout در file بنویسد.

گزینه -v خروجی پرجزئیات (verbose) را در stderr تولید می‌کند. این گزینه اصولاً برای اشکال‌زدایی مفید است.

گزینه -C از خواندن فایل‌های پیکربندی جلوگیری کرده و اجازه می‌دهد bogoutil با مقادیر پیش‌فرض اجرا شود.

گزینه --config-file file به bogoutil دستور می‌دهد به جای فایل پیکربندی استاندارد، file را بخواند.

گزینه -D خروجی اشکال‌زدایی را به stdout هدایت می‌کند (به طور معمول به stderr می‌رود).

گزینه -x flags فلگ‌های اشکال‌زدایی را تنظیم می‌کند.

گزینه -n مخفف "جایگزینی نویسه‌های غیر اسکی" (replace non-ascii characters) است. این گزینه نویسه‌هایی با بیت بالا (0x80) را با علامت سؤال جایگزین می‌کند. این قابلیت زمانی مفید است که لیست کلمات حاوی تعداد زیادی نشانه ناخوانا باشد، مثلاً از هرزنامه‌های آسیایی. در صورت استفاده به همراه -m یا -l (اما نه به همراه -d)، نویسه‌های نامناسب به علامت سؤال تبدیل شده و نشانه‌های منطبق با یکدیگر ادغام می‌شوند.

گزینه -a age سن قابل قبول نشانه را مشخص می‌کند و نشانه‌های قدیمی‌تر دور ریخته می‌شوند. سن می‌تواند یک تاریخ (به شکل YYYYMMDD) یا تعداد روز باشد، یعنی دور ریختن نشانه‌های قدیمی‌تر از age روز.

گزینه -c value مشخص می‌کند که نشانه‌هایی با تعداد رخداد کمتر یا مساوی با value باید دور ریخته شوند.

گزینه -s min,max برای دور ریختن نشانه‌ها بر اساس اندازه (طول) آن‌ها به کار می‌رود. تمام نشانه‌های کوتاه‌تر از min یا طولانی‌تر از max دور ریخته خواهند شد.

گزینه -y date تاریخی را برای نشانه‌هایی که فاقد تاریخ هستند تعیین می‌کند. قالب آن به صورت YYYYMMDD است.

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

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

نگهداری محیط پایگاه‌داده (ENVIRONMENT MAINTENANCE)

گزینه --db-checkpoint dir باعث می‌شود bogoutil حافظه‌های موقت (بافرها) را تخلیه کرده و یک نقطه بررسی (checkpoint) در محیط پایگاه‌داده ایجاد کند.

گزینه --db-list-logfiles dir باعث می‌شود bogoutil فایل‌های لاگ موجود در محیط را فهرست کند. می‌توان صفر یا چند کلمه کلیدی را (با فاصله) برای تغییر رفتار این حالت اضافه یا ترکیب کرد. رفتار پیش‌فرض این است که فقط فایل‌های لاگ غیرفعال را با مسیرهای نسبی فهرست کند. می‌توانید all را برای فهرست کردن همه فایل‌های لاگ (غیرفعال و فعال) اضافه کنید. همچنین می‌توانید absolute را اضافه کنید تا فهرست به مسیرهای مطلق تغییر یابد.

گزینه --db-prune dir باعث می‌شود bogoutil در محیط پایگاه‌داده نقطه بررسی ایجاد کند و فایل‌های لاگ غیرفعال را حذف نماید.

گزینه --db-recover dir یک بازیابی معمولی پایگاه‌داده را در پوشه پایگاه‌داده مشخص‌شده اجرا می‌کند. اگر این کار ناموفق باشد، مجدداً با یک بازیابی فاجعه (که معمولاً کندتر است) تلاش می‌کند. اگر این نیز با شکست مواجه شود، پایگاه‌داده شما قابل تعمیر نیست و باید از ابتدا بازسازی شود. این ویژگی تنها زمانی پشتیبانی می‌شود که با پشتیبانی Berkeley DB به همراه فعال بودن تراکنش‌ها کامپایل شده باشد. تلاش برای بازیابی با پشتیبانی QDBM یا SQLite3 با خطا مواجه خواهد شد.

گزینه --db-recover-harder dir یک بازیابی بحرانی و سنگین (catastrophic) را در پوشه مشخص‌شده پایگاه‌داده اجرا می‌کند. در صورت شکست، پایگاه‌داده شما قابل تعمیر نیست و باید از ابتدا بازسازی شود. این ویژگی تنها زمانی پشتیبانی می‌شود که با پشتیبانی Berkeley DB همراه با تراکنش‌ها کامپایل شده باشد. تلاش برای بازیابی با پشتیبانی QDBM یا SQLite3 منجر به خطا خواهد شد.

گزینه --db-remove-environment directory معادل گزینه کوتاه ندارد. این گزینه بازیابی را در دایرکتوری داده‌شده اجرا کرده و سپس محیط پایگاه‌داده را حذف می‌کند. قبل از ارتقا به نسخه جدید Berkeley DB، اگر نسخه جدید نیازمند به‌روزرسانی قالب فایل لاگ باشد، از این گزینه استفاده کنید.

گزینه --db-print-leafpage-count file تعداد صفحات برگ (leaf pages) در فایل پایگاه‌داده file را به عنوان یک عدد اعشاری (ده‌دهی) چاپ می‌کند، یا در صورتی که پایگاه‌داده از پرس‌وجوی این مقدار پشتیبانی نکند، عبارت UNKNOWN را برمی‌گرداند.

گزینه --db-print-pagesize file اندازه یک صفحه پایگاه‌داده در file را به عنوان یک عدد اعشاری (ده‌دهی) چاپ می‌کند، یا برای پایگاه‌داده‌هایی با اندازه صفحه متغیر یا پایگاه‌داده‌هایی که اجازه پرس‌وجوی اندازه صفحه را نمی‌دهند، عبارت UNKNOWN را چاپ می‌کند.

گزینه --db-verify file درخواست می‌کند که bogofilter صحت فایل پایگاه‌داده را بررسی و اعتبارسنجی کند. این گزینه فقط خطاها را چاپ می‌کند، مگر اینکه در حالت پرجزئیات (verbose) باشد.

قالب داده‌ها (DATA FORMAT)

ابزار Bogoutil فایل‌های متنی را می‌خواند و می‌نویسد که در آن‌ها هر خط غیرخالی شامل یک کلمه، هر مقداری از فاصله‌های افقی، تعداد کلمات عددی، فاصله‌های بیشتر و (به صورت اختیاری) یک تاریخ به شکل YYYYMMDD است. خطوط خالی نادیده گرفته می‌شوند.

کدهای خروج (RETURN VALUES)

مقدار 0 برای عملیات موفقیت‌آمیز. مقدار 1 برای بیشتر خطاها. مقدار 3 برای خطاهای ورودی/خروجی (I/O) یا سایر خطاها. خطای 3 معمولاً به این معنی است که مشکلی جدی در فایل‌های پایگاه‌داده وجود دارد.

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

Gyepi Sam <gyepi@praxis-sw.com>.

Matthias Andree <matthias.andree@gmx.de>.

David Relson <relson@osagesoftware.com>.

برای دریافت به‌روزرسانی‌ها، ببینید: صفحه پروژه bogofilter[1].

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

bogofilter(1), bogolexer(1), bogotune(1), bogoupgrade(1)

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

1.

صفحه پروژه bogofilter