'\" t
.\"     Title: bogoutil
.\"    Author: [see the "AUTHOR" section]
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net>
.\"      Date: 05/19/2019
.\"    Manual: Bogofilter Reference Manual
.\"    Source: Bogofilter
.\"  Language: Persian
.\"
.TH "BOGOUTIL" "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)"
bogoutil \- ابزار مدیریت و نمایش پایگاهدادههای کلمات bogofilter
.SH "خلاصه دستور (SYNOPSIS)"
.HP \w'\fBbogoutil\fR\ 'u
\fBbogoutil\fR {\-h | \-V}
.HP \w'\fBbogoutil\fR\ 'u
\fBbogoutil\fR [\fIگزینه‌ها\fR] {\-d\ \fIfile\fR | \-H\ \fIfile\fR | \-l\ \fIfile\fR | \-m\ \fIfile\fR | \-w\ \fIfile\fR | \-p\ \fIfile\fR}
.HP \w'\fBbogoutil\fR\ 'u
\fBbogoutil\fR {\-r\ \fIfile\fR | \-R\ \fIfile\fR}
.HP \w'\fBbogoutil\fR\ 'u
\fBbogoutil\fR {\-\-db\-print\-leafpage\-count\ \fIfile\fR | \-\-db\-print\-pagesize\ \fIfile\fR | \-\-db\-verify\ \fIfile\fR | \-\-db\-checkpoint\ \fIdirectory\fR\ [flag...]  | \-\-db\-list\-logfiles\ \fIdirectory\fR | \-\-db\-prune\ \fIdirectory\fR | \-\-db\-recover\ \fIdirectory\fR | \-\-db\-recover\-harder\ \fIdirectory\fR | \-\-db\-remove\-environment\ \fIdirectory\fR}
.PP
که در آن
\fBگزینه‌ها\fR
عبارت است از:
.HP \w'\fBbogoutil\fR\ 'u
\fBbogoutil\fR [\-v] [\-n] [\-C] [\-D] [\-a\ \fIage\fR] [\-c\ \fIcount\fR] [\-s\ \fImin,max\fR] [\-y\ \fIdate\fR] [\-I\ \fIfile\fR] [\-O\ \fIfile\fR] [\-x\ \fIflags\fR] [\-\-config\-file\ \fIfile\fR]
.SH "توضیحات (DESCRIPTION)"
.PP
دستور
Bogoutil
بخشی از بسته فیلتر هرزنامه بیزی
bogofilter
است.
.PP
این ابزار برای استخراج (dump) و بارگذاری (load) پایگاه‌داده‌های Berkeley DB مربوط به
bogofilter
به و از فایل‌های متنی، انجام عملیات نگهداری پایگاه‌داده، و نمایش مقادیر کلمات خاص استفاده می‌شود.
.SH "گزینه‌ها (OPTIONS)"
.PP
گزینه
\fB\-d \fR\fB\fIfile\fR\fR
به
bogoutil
دستور می‌دهد محتویات فایل پایگاه‌داده را در
\fBstdout\fR
چاپ کند.
.PP
گزینه
\fB\-H \fR\fB\fIfile\fR\fR
به
bogoutil
دستور می‌دهد یک هیستوگرام از فایل پایگاه‌داده را در
\fBstdout\fR
چاپ کند. خروجی مشابه خروجی
bogofilter \-vv
است. در نهایت، واژه‌های تک‌رخداد (hapaxes یا نشانه‌هایی که تنها یک بار دیده شده‌اند) و نشانه‌های خالص (نشانه‌هایی که تنها در هرزنامه یا پیام‌های سالم دیده شده‌اند) شمارش می‌شوند.
.PP
گزینه
\fB\-l \fR\fB\fIfile\fR\fR
به
bogoutil
دستور می‌دهد داده‌ها را از
\fBstdin\fR
در فایل پایگاه‌داده بارگذاری کند. اگر فایل پایگاه‌داده موجود باشد، داده‌های
\fBstdin\fR
با فایل پایگاه‌داده ادغام شده و شمارش‌ها با هم جمع می‌شوند.
.PP
گزینه
\fB\-m\fR
به
bogoutil
دستور می‌دهد عملیات نگهداری را روی پایگاه‌داده مشخص‌شده اجرا کند؛ به این معنی که نشانه‌های قدیمی‌تر از حد مطلوب، نشانه‌هایی با تعداد رخداد بسیار کم، یا نشانه‌هایی با اندازه (طول) بسیار کوتاه یا بسیار بلند را حذف نماید.
.PP
گزینه
\fB\-w \fR\fB\fIfile\fR\fR
به
bogoutil
دستور می‌دهد اطلاعات نشانه را از فایل پایگاه‌داده نمایش دهد. این گزینه یک آرگومان می‌گیرد که یا نام لیست کلمات (معمولاً wordlist.db) یا نام پوشه حاوی آن است. نشانه‌ها را می‌توان در خط فرمان مشخص کرد یا به
bogoutil
لوله (pipe) نمود. هنگامی که آرگومان‌های اضافی در خط فرمان وجود داشته باشد،
bogoutil
از آن‌ها به عنوان نشانه‌های مورد جستجو استفاده خواهد کرد. اگر آرگومان اضافی وجود نداشته باشد،
bogoutil
نشانه‌ها را از
\fBstdin\fR
می‌خواند.
.PP
گزینه
\fB\-p \fR\fB\fIfile\fR\fR
به
bogoutil
دستور می‌دهد اطلاعات پایگاه‌داده را برای یک یا چند نشانه نمایش دهد. این نمایش شامل ستون احتمال به همراه امتیاز هرزنامه نشانه است (که با مقادیر پیش‌فرض
bogofilter
محاسبه می‌شود). گزینه
\fB\-p\fR
همان آرگومان‌های گزینه
\fB\-w\fR
را دریافت می‌کند.
.PP
گزینه
\fB\-r \fR\fB\fIfile\fR\fR
به
bogoutil
دستور می‌دهد مقدار ROBX را مجدداً محاسبه کرده و آن را به عنوان یک کسر شش‌رقمی چاپ کند.
.PP
گزینه
\fB\-R \fR\fB\fIfile\fR\fR
همان کار
\fB\-r\fR
را انجام می‌دهد، اما نتیجه را بدون چاپ کردن در پایگاه‌داده آموزشی ذخیره می‌کند.
.PP
گزینه
\fB\-I \fR\fB\fIfile\fR\fR
به
bogoutil
دستور می‌دهد ورودی خود را به جای stdin از
\fIfile\fR
بخواند.
.PP
گزینه
\fB\-O \fR\fB\fIfile\fR\fR
به
bogoutil
دستور می‌دهد خروجی خود را به جای stdout در
\fIfile\fR
بنویسد.
.PP
گزینه
\fB\-v\fR
خروجی پرجزئیات (verbose) را در
\fBstderr\fR
تولید می‌کند. این گزینه اصولاً برای اشکال‌زدایی مفید است.
.PP
گزینه
\fB\-C\fR
از خواندن فایل‌های پیکربندی جلوگیری کرده و اجازه می‌دهد
bogoutil
با مقادیر پیش‌فرض اجرا شود.
.PP
گزینه
\fB\-\-config\-file \fR\fB\fIfile\fR\fR
به
bogoutil
دستور می‌دهد به جای فایل پیکربندی استاندارد،
\fIfile\fR
را بخواند.
.PP
گزینه
\fB\-D\fR
خروجی اشکال‌زدایی را به stdout هدایت می‌کند (به طور معمول به stderr می‌رود).
.PP
گزینه
\fB\-x \fR\fB\fIflags\fR\fR
فلگ‌های اشکال‌زدایی را تنظیم می‌کند.
.PP
گزینه
\fB\-n\fR
مخفف "جایگزینی نویسه‌های غیر اسکی" (replace non\-ascii characters) است. این گزینه نویسه‌هایی با بیت بالا (0x80) را با علامت سؤال جایگزین می‌کند. این قابلیت زمانی مفید است که لیست کلمات حاوی تعداد زیادی نشانه ناخوانا باشد، مثلاً از هرزنامه‌های آسیایی. در صورت استفاده به همراه
\fB\-m\fR
یا
\fB\-l\fR
(اما نه به همراه
\fB\-d\fR)،
نویسه‌های نامناسب به علامت سؤال تبدیل شده و نشانه‌های منطبق با یکدیگر ادغام می‌شوند.
.PP
گزینه
\fB\-a age\fR
سن قابل قبول نشانه را مشخص می‌کند و نشانه‌های قدیمی‌تر دور ریخته می‌شوند. سن می‌تواند یک تاریخ (به شکل YYYYMMDD) یا تعداد روز باشد، یعنی دور ریختن نشانه‌های قدیمی‌تر از
\fBage\fR
روز.
.PP
گزینه
\fB\-c value\fR
مشخص می‌کند که نشانه‌هایی با تعداد رخداد کمتر یا مساوی با
\fBvalue\fR
باید دور ریخته شوند.
.PP
گزینه
\fB\-s min,max\fR
برای دور ریختن نشانه‌ها بر اساس اندازه (طول) آن‌ها به کار می‌رود. تمام نشانه‌های کوتاه‌تر از
\fBmin\fR
یا طولانی‌تر از
\fBmax\fR
دور ریخته خواهند شد.
.PP
گزینه
\fB\-y date\fR
تاریخی را برای نشانه‌هایی که فاقد تاریخ هستند تعیین می‌کند. قالب آن به صورت YYYYMMDD است.
.PP
گزینه
\fB\-h\fR
پیام راهنما را چاپ کرده و خارج می‌شود.
.PP
گزینه
\fB\-V\fR
شماره نسخه را چاپ کرده و خارج می‌شود.
.SH "نگهداری محیط پایگاه‌داده (ENVIRONMENT MAINTENANCE)"
.PP
گزینه
\fB\-\-db\-checkpoint \fR\fB\fIdir\fR\fR
باعث می‌شود
bogoutil
حافظه‌های موقت (بافرها) را تخلیه کرده و یک نقطه بررسی (checkpoint) در محیط پایگاه‌داده ایجاد کند.
.PP
گزینه
\fB\-\-db\-list\-logfiles \fR\fB\fIdir\fR\fR
باعث می‌شود
bogoutil
فایل‌های لاگ موجود در محیط را فهرست کند. می‌توان صفر یا چند کلمه کلیدی را (با فاصله) برای تغییر رفتار این حالت اضافه یا ترکیب کرد. رفتار پیش‌فرض این است که فقط فایل‌های لاگ غیرفعال را با مسیرهای نسبی فهرست کند. می‌توانید
\fBall\fR
را برای فهرست کردن همه فایل‌های لاگ (غیرفعال و فعال) اضافه کنید. همچنین می‌توانید
\fBabsolute\fR
را اضافه کنید تا فهرست به مسیرهای مطلق تغییر یابد.
.PP
گزینه
\fB\-\-db\-prune \fR\fB\fIdir\fR\fR
باعث می‌شود
bogoutil
در محیط پایگاه‌داده نقطه بررسی ایجاد کند و فایل‌های لاگ غیرفعال را حذف نماید.
.PP
گزینه
\fB\-\-db\-recover \fR\fB\fIdir\fR\fR
یک بازیابی معمولی پایگاه‌داده را در پوشه پایگاه‌داده مشخص‌شده اجرا می‌کند. اگر این کار ناموفق باشد، مجدداً با یک بازیابی فاجعه (که معمولاً کندتر است) تلاش می‌کند. اگر این نیز با شکست مواجه شود، پایگاه‌داده شما قابل تعمیر نیست و باید از ابتدا بازسازی شود. این ویژگی تنها زمانی پشتیبانی می‌شود که با پشتیبانی Berkeley DB به همراه فعال بودن تراکنش‌ها کامپایل شده باشد. تلاش برای بازیابی با پشتیبانی QDBM یا SQLite3 با خطا مواجه خواهد شد.
.PP
گزینه
\fB\-\-db\-recover\-harder \fR\fB\fIdir\fR\fR
یک بازیابی بحرانی و سنگین (catastrophic) را در پوشه مشخص‌شده پایگاه‌داده اجرا می‌کند. در صورت شکست، پایگاه‌داده شما قابل تعمیر نیست و باید از ابتدا بازسازی شود. این ویژگی تنها زمانی پشتیبانی می‌شود که با پشتیبانی Berkeley DB همراه با تراکنش‌ها کامپایل شده باشد. تلاش برای بازیابی با پشتیبانی QDBM یا SQLite3 منجر به خطا خواهد شد.
.PP
گزینه
\fB\-\-db\-remove\-environment \fR\fB\fIdirectory\fR\fR
معادل گزینه کوتاه ندارد. این گزینه بازیابی را در دایرکتوری داده‌شده اجرا کرده و سپس محیط پایگاه‌داده را حذف می‌کند.
\fIقبل از\fR
ارتقا به نسخه جدید Berkeley DB، اگر نسخه جدید نیازمند به‌روزرسانی قالب فایل لاگ باشد، از این گزینه استفاده کنید.
.PP
گزینه
\fB\-\-db\-print\-leafpage\-count \fR\fB\fIfile\fR\fR
تعداد صفحات برگ (leaf pages) در فایل پایگاه‌داده
\fIfile\fR
را به عنوان یک عدد اعشاری (ده‌دهی) چاپ می‌کند، یا در صورتی که پایگاه‌داده از پرس‌وجوی این مقدار پشتیبانی نکند، عبارت UNKNOWN را برمی‌گرداند.
.PP
گزینه
\fB\-\-db\-print\-pagesize \fR\fB\fIfile\fR\fR
اندازه یک صفحه پایگاه‌داده در
\fIfile\fR
را به عنوان یک عدد اعشاری (ده‌دهی) چاپ می‌کند، یا برای پایگاه‌داده‌هایی با اندازه صفحه متغیر یا پایگاه‌داده‌هایی که اجازه پرس‌وجوی اندازه صفحه را نمی‌دهند، عبارت UNKNOWN را چاپ می‌کند.
.PP
گزینه
\fB\-\-db\-verify \fR\fB\fIfile\fR\fR
درخواست می‌کند که
bogofilter
صحت فایل پایگاه‌داده را بررسی و اعتبارسنجی کند. این گزینه فقط خطاها را چاپ می‌کند، مگر اینکه در حالت پرجزئیات (verbose) باشد.
.SH "قالب داده‌ها (DATA FORMAT)"
.PP
ابزار
Bogoutil
فایل‌های متنی را می‌خواند و می‌نویسد که در آن‌ها هر خط غیرخالی شامل یک کلمه، هر مقداری از فاصله‌های افقی، تعداد کلمات عددی، فاصله‌های بیشتر و (به صورت اختیاری) یک تاریخ به شکل YYYYMMDD است. خطوط خالی نادیده گرفته می‌شوند.
.SH "کدهای خروج (RETURN VALUES)"
.PP
مقدار 0 برای عملیات موفقیت‌آمیز. مقدار 1 برای بیشتر خطاها. مقدار 3 برای خطاهای ورودی/خروجی (I/O) یا سایر خطاها. خطای 3 معمولاً به این معنی است که مشکلی جدی در فایل‌های پایگاه‌داده وجود دارد.
.SH "نویسندگان (AUTHORS)"
.PP
Gyepi Sam
<gyepi@praxis\-sw\&.com>\&.
.PP
Matthias Andree
<matthias\&.andree@gmx\&.de>\&.
.PP
David Relson
<relson@osagesoftware\&.com>\&.
.PP
برای دریافت به‌روزرسانی‌ها، ببینید:
\m[blue]\fBصفحه پروژه bogofilter\fR\m[]\&\s-2\u[1]\d\s+2\&.
.SH "همچنین ببینید (SEE ALSO)"
.PP
bogofilter(1), bogolexer(1), bogotune(1), bogoupgrade(1)
.SH "یادداشت‌ها (NOTES)"
.IP " 1." 4
صفحه پروژه bogofilter
.RS 4
\%http://bogofilter.sourceforge.net
.RE