'\" t .\" Title: dbmail-util .\" Author: Alan Hicks .\" Generator: DocBook XSL Stylesheets vsnapshot .\" Date: 08/28/2026 .\" Manual: \ \& .\" Source: \ \& .\" Language: Persian .\" .TH "DBMAIL\-UTIL" "8" "08/28/2026" "\ \&" "\ \&" .\" ----------------------------------------------------------------- .\" * 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)" dbmail-util \- یکپارچگی و پاکیزگی جدول‌های داده DBMail را حفظ می‌کند\&. .SH "خلاصه دستور (SYNOPSIS)" .sp .nf dbmail\-util [options] \-\-all\-checks dbmail\-util [options] \-\-test\-integrity dbmail\-util [options] \-\-check\-body dbmail\-util [options] \-\-purge\-deleted dbmail\-util [options] \-\-set\-deleted dbmail\-util [options] \-\-clear\-replycache time dbmail\-util [options] \-\-clear\-iplog time dbmail\-util [options] \-\-rehash .fi .SH "توضیحات (DESCRIPTION)" .sp برنامه .B dbmail\-util امکان پاک‌سازی پایگاه‌داده و بررسی یکپارچگی آن را فراهم می‌کند\&. تمامی پیام‌هایی که برای حذف نشانه‌گذاری شده‌اند (وضعیت ۲) برای حذف نهایی علامت‌گذاری می‌شوند (وضعیت ۳)\&. تمامی پیام‌های نشانه‌گذاری‌شده برای حذف نهایی از پایگاه‌داده پاک خواهند شد\&. بررسی یکپارچگی، بخش‌های mime نامربوط (فاقد ارتباط)، مقادیر سربرگ‌ها، پیام‌ها و صندوق‌های پستی را بررسی می‌کند\&. .sp به‌طور پیش‌فرض، بررسی‌ها فقط‌خواندنی (read\-only) هستند\&. با ارسال گزینه \-\-no به تمامی پرسش‌ها پاسخ منفی داده می‌شود\&. با ارسال گزینه \-\-yes تغییرات خواندنی\-نوشتنی اعمال شده و به تمامی اعلان‌ها و پرسش‌ها پاسخ مثبت داده می‌شود\&. .SH "گزینه‌ها (OPTIONS)" .PP \-b, \-\-check\-body .RS 4 بررسی و بازسازی جدول‌های حافظه پنهان (cache) بدنه/سربرگ/پاکت (envelope)\&. .RE .PP \-d, \-\-set\-deleted .RS 4 قرار دادن تمامی پیام‌های دارای وضعیت DELETE (2) در صف پاک‌سازی نهایی، از طریق تنظیم وضعیت آن‌ها به PURGE (3)\&. مقدار این فیلد وضعیت توسط دستورهای IMAP\-EXPUNGE یا POP3\-DELE روی DELETE تنظیم می‌شود\&. .RE .PP \-p, \-\-purge\-deleted .RS 4 حذف تمامی پیام‌هایی که مقدار وضعیت آن‌ها PURGE (3) است\&. برای پاک‌سازی پیام‌هایی که در حال حاضر وضعیت DELETE (2) دارند، این ابزار را دو بار با گزینه‌های \-pd اجرا کنید\&. این کار توصیه نمی‌شود؛ بهتر است یک دوره مهلت برای پیام‌های قدیمی در نظر گرفته شود تا قبل از حذف دائمی آن‌ها از پایگاه‌داده فرصتی باقی بماند\&. .RE .PP \-s, \-\-remove\-invalid\-aliases .RS 4 حذف نام‌های مستعار (aliases) و بازارسال‌های (forwards) معلق یا نامعتبر\&. .RE .PP \-t, \-\-test\-integrity .RS 4 بررسی و آزمایش یکپارچگی پیام‌ها\&. .RE .PP \-a, \-\-all\-checks .RS 4 انجام تمامی بررسی‌های فوق: \-\-check\-body \-\-set\-deleted \-\-purge\-deleted \-\-remove\-invalid\-aliases \-\-test\-integrity .RE .PP \-r, \-\-clear\-replycache time .RS 4 پاک‌سازی حافظه پنهان پاسخ (reply cache) که برای پاسخ‌های خودکار و تعطیلات Sieve استفاده می‌شود\&. زمان به صورت hm مشخص می‌شود (البته بدون علامت‌های بزرگ‌تر و کوچک‌تر!)\&. .RE .PP \-l, \-\-clear\-iplog time .RS 4 پاک‌سازی گزارش‌های IP استفاده‌شده برای IMAP/POP\-before\-SMTP\&. زمان به صورت hm مشخص می‌شود (البته بدون علامت‌های بزرگ‌تر و کوچک‌تر!)\&. .RE .PP \-\-rehash .RS 4 بازسازی کلیدهای درهم‌سازی (hash keys) برای پیام‌های ذخیره‌شده\&. .RE .PP \-\-erase days .RS 4 حذف پیام‌های قدیمی‌تر از تاریخ مشخص‌شده در INBOX/Trash\&. .RE .PP \-\-move days .RS 4 انتقال پیام‌ها از INBOX به INBOX/Trash\&. .RE .PP \-\-inbox name .RS 4 پوشه Inbox مبدأ برای انتقال، استفاده در ترکیب با \-\-move\&. .RE .PP \-\-trash name .RS 4 پوشه Trash مقصد برای انتقال، استفاده در ترکیب با \-\-move\&. .RE .sp \fBگزینه‌های عمومی (Common options)\fR .PP \-n, \-\-no .RS 4 نمایش تعمیرات و تغییرات در نظر گرفته‌شده بدون اعمال هیچ تغییری، یعنی پاسخ «خیر» به همه\&. .RE .PP \-y, \-\-yes .RS 4 انجام تمامی عملیات‌های تعمیر، یعنی پاسخ «بله» به همه\&. .RE .sp \fBگزینه‌های نگهداری (Maintenance options)\fR .PP \-\-rehash .RS 4 بازسازی مقادیر هش (hash values) برای تمامی بخش‌های پیام در پایگاه‌داده\&. پس از تغییر گزینه پیکربندی hash_algorithm باید این دستور را اجرا کنید\&. .RE .PP \-e, \-\-check\-empty\-cache .RS 4 بررسی خالی بودن حافظه پنهان پاکت (envelope cache)\&. .RE .sp \fBگزینه‌های مهاجرت (Migration options)\fR .PP \-M, \-\-migrate\-legacy limit .RS 4 مهاجرت messageblkهای قدیمی نسخه 2\&.2\&.x به جدول mimeparts\&. .RE .PP \-m, \-\-migrate\-limit limit .RS 4 محدود کردن مهاجرت به تعداد [limit] پیام فیزیکی (physmessages)\&. پیش‌فرض ۱۰۰۰۰ در هر اجرا است\&. .RE .SH "گزینه‌های عمومی (COMMON OPTIONS)" .PP \-f, \-\-config configfile .RS 4 مشخص کردن یک فایل پیکربندی جایگزین\&. .sp برای نمایش مسیر پیش‌فرض، از dbmail\- \-\-help استفاده کنید\&. .RE .PP \-q, \-\-quiet .RS 4 رد کردن بی‌سر و صدای اعلان‌های تعاملی و پیام‌های وضعیت کمکی که در غیر این صورت در stdout چاپ می‌شدند\&. برای بی‌صدا کردن خطاهایی که در غیر این صورت در stderr چاپ می‌شدند، از دو \-q استفاده کنید\&. .RE .PP \-v, \-\-verbose .RS 4 اجرا در حالت پرگو (verbose)\&. برخی از ابزارهای مجموعه DBMail می‌توانند دو بار \-v را برای پرگویی بیشتر دریافت کنند\&. ابزارهایی که این قاعده را پشتیبانی نمی‌کنند، خطایی برای \-v اضافی نمایش نخواهند داد و با پرگویی عادی خود عمل می‌کنند\&. .RE .PP \-V, \-\-version .RS 4 نمایش نسخه و حق نشر، سپس خروج\&. .RE .PP \-h, \-\-help .RS 4 نمایش چکیده کوتاهی از گزینه‌ها، سپس خروج\&. .RE .SH "مقادیر بازگشتی (RETURN VALUES)" .sp در صورتی که خطاها یافت شوند اما به دلیل شکست امکان رفع آن‌ها وجود نداشته باشد مقدار ۳، در صورتی که خطاها یافت شوند اما گزینه \fI\-y\fR داده نشده باشد یا گزینه \fI\-n\fR مشخص شده باشد مقدار ۲، در صورتی که خطاها یافت و با موفقیت رفع شوند مقدار ۱، و در صورتی که هیچ خطایی یافت نشود مقدار ۰ بازگردانده می‌شود\&. .SH "مثال‌ها (EXAMPLES)" .sp عملیات نگهداری منظم را می‌توان به عنوان یک وظیفه زمان‌بندی‌شده دوره‌ای cron اجرا کرد: .sp .if n \{\ .RS 4 .\} .nf dbmail\-util \-\-all \-\-yes \-\-verbose .fi .if n \{\ .RE .\} .sp برای تنظیم وضعیت تمامی پیام‌های با وضعیت DELETE به PURGE، و حذف دائمی تمامی پیام‌هایی که قبلاً وضعیت آن‌ها روی PURGE تنظیم شده است: .sp .if n \{\ .RS 4 .\} .nf dbmail\-util \-\-set\-deleted \-\-purge\-deleted \-yes .fi .if n \{\ .RE .\} .sp برای دریافت فهرستی از تغییراتی که قرار است برای تمام عملیات‌ها انجام شود: .sp .if n \{\ .RS 4 .\} .nf dbmail\-util \-\-all \-\-no .fi .if n \{\ .RE .\} .sp برای حذف تمامی ورودی‌های لاگ IP قدیمی‌تر از سه روز: .sp .if n \{\ .RS 4 .\} .nf dbmail\-util \-\-clear\-iplog 72h \-\-yes .fi .if n \{\ .RE .\} .sp پس از ارتقا از نسخه DBMail 2\&.0 یا خالی کردن (truncate) جدول‌های کش، این دستور را برای پر کردن مجدد حافظه پنهان اجرا کنید: .sp .if n \{\ .RS 4 .\} .nf dbmail\-util \-\-check\-body \-\-yes .fi .if n \{\ .RE .\} .SH "همچنین ببینید (SEE ALSO)" .sp dbmail(1), dbmail\&.conf(5), dbmail\-deliver(1), dbmail\-export(8), dbmail\-httpd(8), dbmail\-imapd(8), dbmail\-lmtpd(8), dbmail\-pop3d(8), dbmail\-sieved(8), dbmail\-sievecmd(8), dbmail\-users(8), dbmail\-util(8) .SH "اشکالات (BUGS)" .sp برای دریافت جدیدترین اطلاعیه‌ها، لطفاً در \m[blue]\fBDBMail announce mailing list\fR\m[]\&\s-2\u[1]\d\s+2 مشترک شوید\&. .sp برای گفتگوهای عمومی، لطفاً در \m[blue]\fBDBMail general mailing list\fR\m[]\&\s-2\u[2]\d\s+2 مشترک شوید\&. .sp اگر مشکلی در DBMail مشاهده کردید، لطفاً آن را در \m[blue]\fBDBMail Bug Tracker\fR\m[]\&\s-2\u[3]\d\s+2 گزارش دهید\&. ممکن است ارائه یک لاگ اشکال‌زدایی (debug log) مفید باشد\&. .SH "مجوز (LICENSE)" .sp نرم‌افزار DBMail و اجزای آن تحت شرایط مجوز عمومی همگانی گنو نسخه ۲ (GNU General Public License Version 2) توزیع می‌شوند\&. حقوق نشر به صورت گوناگون متعلق به نویسندگان فهرست‌شده در زیر است\&. .SH "نویسندگان (AUTHOR(S))" .sp پروژه DBMail نتیجه تلاش مشترک میان توسعه‌دهندگان اصلی فهرست‌شده در زیر و کمک فوق‌العاده آزمون‌کنندگان، اصلاح‌کنندگان و شکارچیان باگ است که نام آن‌ها در فایل‌های AUTHORS و THANKS در توزیع منبع DBMail آمده است\&. .sp .if n \{\ .RS 4 .\} .nf Alan Hicks Persistent Objects Ltd https://p\-o\&.co\&.uk Eelco van Beek Aaron Stone Paul J Stevens Roel Rozendaal Open Source Engineer NFG Net Facilities Group BV Ilja Booij Palo Alto, CA USA http://www\&.nfg\&.nl IC&S http://www\&.ic\-s\&.nl .fi .if n \{\ .RE .\} .SH "نویسنده (AUTHOR)" .PP \fBAlan Hicks\fR <\&ahicks@p\-o\&.co\&.uk\&> .RS 4 نویسنده. .RE .SH "نکات (NOTES)" .IP " 1." 4 DBMail announce mailing list .RS 4 \%https://dbmail.org/wws/info/dbmail-announce/ .RE .IP " 2." 4 DBMail general mailing list .RS 4 \%https://dbmail.org/wws/info/dbmail-general/ .RE .IP " 3." 4 DBMail Bug Tracker .RS 4 \%https://github.com/dbmail/dbmail/issues .RE