DBMAIL-UTIL(8)   DBMAIL-UTIL(8)

dbmail-util - یکپارچگی و پاکیزگی جدول‌های داده DBMail را حفظ می‌کند.

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

برنامه dbmail-util امکان پاک‌سازی پایگاه‌داده و بررسی یکپارچگی آن را فراهم می‌کند. تمامی پیام‌هایی که برای حذف نشانه‌گذاری شده‌اند (وضعیت ۲) برای حذف نهایی علامت‌گذاری می‌شوند (وضعیت ۳). تمامی پیام‌های نشانه‌گذاری‌شده برای حذف نهایی از پایگاه‌داده پاک خواهند شد. بررسی یکپارچگی، بخش‌های mime نامربوط (فاقد ارتباط)، مقادیر سربرگ‌ها، پیام‌ها و صندوق‌های پستی را بررسی می‌کند.

به‌طور پیش‌فرض، بررسی‌ها فقط‌خواندنی (read-only) هستند. با ارسال گزینه --no به تمامی پرسش‌ها پاسخ منفی داده می‌شود. با ارسال گزینه --yes تغییرات خواندنی-نوشتنی اعمال شده و به تمامی اعلان‌ها و پرسش‌ها پاسخ مثبت داده می‌شود.

-b, --check-body

بررسی و بازسازی جدول‌های حافظه پنهان (cache) بدنه/سربرگ/پاکت (envelope).

-d, --set-deleted

قرار دادن تمامی پیام‌های دارای وضعیت DELETE (2) در صف پاک‌سازی نهایی، از طریق تنظیم وضعیت آن‌ها به PURGE (3). مقدار این فیلد وضعیت توسط دستورهای IMAP-EXPUNGE یا POP3-DELE روی DELETE تنظیم می‌شود.

-p, --purge-deleted

حذف تمامی پیام‌هایی که مقدار وضعیت آن‌ها PURGE (3) است. برای پاک‌سازی پیام‌هایی که در حال حاضر وضعیت DELETE (2) دارند، این ابزار را دو بار با گزینه‌های -pd اجرا کنید. این کار توصیه نمی‌شود؛ بهتر است یک دوره مهلت برای پیام‌های قدیمی در نظر گرفته شود تا قبل از حذف دائمی آن‌ها از پایگاه‌داده فرصتی باقی بماند.

-s, --remove-invalid-aliases

حذف نام‌های مستعار (aliases) و بازارسال‌های (forwards) معلق یا نامعتبر.

-t, --test-integrity

بررسی و آزمایش یکپارچگی پیام‌ها.

-a, --all-checks

انجام تمامی بررسی‌های فوق: --check-body --set-deleted --purge-deleted --remove-invalid-aliases --test-integrity

-r, --clear-replycache time

پاک‌سازی حافظه پنهان پاسخ (reply cache) که برای پاسخ‌های خودکار و تعطیلات Sieve استفاده می‌شود. زمان به صورت <hours>h<minutes>m مشخص می‌شود (البته بدون علامت‌های بزرگ‌تر و کوچک‌تر!).

-l, --clear-iplog time

پاک‌سازی گزارش‌های IP استفاده‌شده برای IMAP/POP-before-SMTP. زمان به صورت <hours>h<minutes>m مشخص می‌شود (البته بدون علامت‌های بزرگ‌تر و کوچک‌تر!).

--rehash

بازسازی کلیدهای درهم‌سازی (hash keys) برای پیام‌های ذخیره‌شده.

--erase days

حذف پیام‌های قدیمی‌تر از تاریخ مشخص‌شده در INBOX/Trash.

--move days

انتقال پیام‌ها از INBOX به INBOX/Trash.

--inbox name

پوشه Inbox مبدأ برای انتقال، استفاده در ترکیب با --move.

--trash name

پوشه Trash مقصد برای انتقال، استفاده در ترکیب با --move.

گزینه‌های عمومی (Common options)

-n, --no

نمایش تعمیرات و تغییرات در نظر گرفته‌شده بدون اعمال هیچ تغییری، یعنی پاسخ «خیر» به همه.

-y, --yes

انجام تمامی عملیات‌های تعمیر، یعنی پاسخ «بله» به همه.

گزینه‌های نگهداری (Maintenance options)

--rehash

بازسازی مقادیر هش (hash values) برای تمامی بخش‌های پیام در پایگاه‌داده. پس از تغییر گزینه پیکربندی hash_algorithm باید این دستور را اجرا کنید.

-e, --check-empty-cache

بررسی خالی بودن حافظه پنهان پاکت (envelope cache).

گزینه‌های مهاجرت (Migration options)

-M, --migrate-legacy limit

مهاجرت messageblkهای قدیمی نسخه 2.2.x به جدول mimeparts.

-m, --migrate-limit limit

محدود کردن مهاجرت به تعداد [limit] پیام فیزیکی (physmessages). پیش‌فرض ۱۰۰۰۰ در هر اجرا است.

-f, --config configfile

مشخص کردن یک فایل پیکربندی جایگزین.

برای نمایش مسیر پیش‌فرض، از dbmail-<utility> --help استفاده کنید.

-q, --quiet

رد کردن بی‌سر و صدای اعلان‌های تعاملی و پیام‌های وضعیت کمکی که در غیر این صورت در stdout چاپ می‌شدند. برای بی‌صدا کردن خطاهایی که در غیر این صورت در stderr چاپ می‌شدند، از دو -q استفاده کنید.

-v, --verbose

اجرا در حالت پرگو (verbose). برخی از ابزارهای مجموعه DBMail می‌توانند دو بار -v را برای پرگویی بیشتر دریافت کنند. ابزارهایی که این قاعده را پشتیبانی نمی‌کنند، خطایی برای -v اضافی نمایش نخواهند داد و با پرگویی عادی خود عمل می‌کنند.

-V, --version

نمایش نسخه و حق نشر، سپس خروج.

-h, --help

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

در صورتی که خطاها یافت شوند اما به دلیل شکست امکان رفع آن‌ها وجود نداشته باشد مقدار ۳، در صورتی که خطاها یافت شوند اما گزینه -y داده نشده باشد یا گزینه -n مشخص شده باشد مقدار ۲، در صورتی که خطاها یافت و با موفقیت رفع شوند مقدار ۱، و در صورتی که هیچ خطایی یافت نشود مقدار ۰ بازگردانده می‌شود.

عملیات نگهداری منظم را می‌توان به عنوان یک وظیفه زمان‌بندی‌شده دوره‌ای cron اجرا کرد:

dbmail-util --all --yes --verbose

برای تنظیم وضعیت تمامی پیام‌های با وضعیت DELETE به PURGE، و حذف دائمی تمامی پیام‌هایی که قبلاً وضعیت آن‌ها روی PURGE تنظیم شده است:

dbmail-util --set-deleted --purge-deleted -yes

برای دریافت فهرستی از تغییراتی که قرار است برای تمام عملیات‌ها انجام شود:

dbmail-util --all --no

برای حذف تمامی ورودی‌های لاگ IP قدیمی‌تر از سه روز:

dbmail-util --clear-iplog 72h --yes

پس از ارتقا از نسخه DBMail 2.0 یا خالی کردن (truncate) جدول‌های کش، این دستور را برای پر کردن مجدد حافظه پنهان اجرا کنید:

dbmail-util --check-body --yes

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)

برای دریافت جدیدترین اطلاعیه‌ها، لطفاً در DBMail announce mailing list[1] مشترک شوید.

برای گفتگوهای عمومی، لطفاً در DBMail general mailing list[2] مشترک شوید.

اگر مشکلی در DBMail مشاهده کردید، لطفاً آن را در DBMail Bug Tracker[3] گزارش دهید. ممکن است ارائه یک لاگ اشکال‌زدایی (debug log) مفید باشد.

نرم‌افزار DBMail و اجزای آن تحت شرایط مجوز عمومی همگانی گنو نسخه ۲ (GNU General Public License Version 2) توزیع می‌شوند. حقوق نشر به صورت گوناگون متعلق به نویسندگان فهرست‌شده در زیر است.

پروژه DBMail نتیجه تلاش مشترک میان توسعه‌دهندگان اصلی فهرست‌شده در زیر و کمک فوق‌العاده آزمون‌کنندگان، اصلاح‌کنندگان و شکارچیان باگ است که نام آن‌ها در فایل‌های AUTHORS و THANKS در توزیع منبع DBMail آمده است.

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

Alan Hicks <ahicks@p-o.co.uk>

نویسنده.

1.
DBMail announce mailing list
2.
DBMail general mailing list
3.
DBMail Bug Tracker
08/28/2026