DOVEADM-LOG(1) Dovecot DOVEADM-LOG(1)

doveadm-log - مکان‌یابی، آزمایش یا بازگشایی مجدد فایل‌های گزارش Dovecot

doveadm [GLOBAL OPTIONS] log errors [-s min_timestamp]

doveadm [GLOBAL OPTIONS] log find [directory]

doveadm [GLOBAL OPTIONS] log reopen

doveadm [GLOBAL OPTIONS] log test

دستورات doveadm log برای مکان‌یابی و بازگشایی مجدد فایل‌های گزارش (log) مربوط به dovecot(1) به کار می‌روند. همچنین امکان آزمایش مقصدهای پیکربندی‌شده در تنظیمات log_path نیز وجود دارد.

گزینه‌های سراسری doveadm(1):

-D

پیام‌های پرگویا (verbosity) و اشکال‌زدایی (debug) را فعال می‌کند.

-O

هیچ فایل پیکربندی‌ای خوانده نشود، صرفاً از مقادیر پیش‌فرض استفاده شود. مقدار پیش‌فرض تنظیم dovecot_storage_version برابر با آخرین نسخه است، اما می‌توان آن را با -o بازنویسی کرد.

-k

حفظ کل متغیرهای محیطی برای doveadm، نه فقط تنظیم import_environment.

-v

پرگویی را به همراه شمارنده پیشرفت فعال می‌کند.

-i instance-name

در صورت استفاده از چند نمونه (instance) از Dovecot، فایل پیکربندی را بر اساس این نام نمونه انتخاب می‌کند.

برای اطلاعات بیشتر به تنظیم instance_name مراجعه کنید.

-c config-file

پیکربندی را از config-file داده‌شده بخواند. به‌طور پیش‌فرض ابتدا سوکت پیکربندی خوانده می‌شود و در صورت عدم دسترسی، به /etc/dovecot/dovecot.conf رجوع می‌گردد. همچنین می‌توانید این مقدار را به سوکت پیکربندی نمونه‌ای که نسخه‌ای سازگار را اجرا می‌کند هدایت کنید.

-o setting=value

تنظیم پیکربندی (setting) را از /etc/dovecot/dovecot.conf و از userdb با value داده‌شده بازنویسی می‌کند. جهت بازنویسی چندین تنظیم، می‌توان گزینه -o را چندین بار مشخص کرد.

doveadm [GLOBAL OPTIONS] log errors [-s min_timestamp]

دستور log errors برای نمایش آخرین خطاها و هشدارها (حداکثر تا ۱۰۰۰ مورد) استفاده می‌شود. اگر خروجی تولید نشود، از زمان آخرین راه‌اندازی هیچ خطایی رخ نداده است.

-s min_timestamp

یک مقدار عدد صحیح که ثانیه‌های سپری‌شده از مبدأ زمان (epoch) - که با نام برچسب زمان یونیکس (Unix timestamp) نیز شناخته می‌شود - را مشخص می‌کند. هنگامی که یک min_timestamp ارائه شود، doveadm(1) تنها خطاهایی را نمایش می‌دهد که از آن نقطه زمانی به بعد رخ داده‌اند.

doveadm [GLOBAL OPTIONS] log find [directory]

دستور log find برای نمایش مکان فایل‌های گزارش استفاده می‌شود. اگر dovecot(1) پیام‌های خود را از طریق syslogd(8) ثبت می‌کند و doveadm(1) نتوانست هیچ فایل گزارشی بیابد، می‌توانید directory (پوشه‌ای) که syslogd فایل‌های گزارش خود را در آن می‌نویسد مشخص کنید.

doveadm [GLOBAL OPTIONS] log reopen

این دستور باعث می‌شود doveadm یک سیگنال SIGUSR1 به فرآیند اصلی (master process) ارسال کند، که این امر موجب بازگشایی مجدد تمامی فایل‌های گزارش پیکربندی‌شده در تنظیمات log_path، info_log_path و debug_log_path می‌گردد. این تنظیمات در /etc/dovecot/conf.d/10-logging.conf پیکربندی می‌شوند.

فرآیند اصلی همچنین به فرآیند ثبت گزارش (log process) سیگنال می‌دهد تا همین کار را انجام دهد. این امر عمدتاً پس از چرخش دستی فایل‌های گزارش (log rotation) کاربرد دارد.

doveadm [GLOBAL OPTIONS] log test

این دستور باعث می‌شود doveadm پیام «This is Dovecot's priority log (timestamp)» را در فایل‌های گزارش پیکربندی‌شده بنویسد. اولویت‌های استفاده‌شده عبارتند از: debug، info، warning، error و fatal.

این مثال نحوه مکان‌یابی فایل‌های گزارش استفاده‌شده توسط dovecot(1) را نشان می‌دهد:

doveadm log find
Looking for log files from /var/log
Debug: /var/log/dovecot.debug
Info: /var/log/mail.log
Warning: /var/log/mail.log
Error: /var/log/mail.log
Fatal: /var/log/mail.log

گزارش‌های باگ، از جمله خروجی doveconf -n را به فهرست پستی Dovecot به نشانی ⟨dovecot@dovecot.org⟩ ارسال کنید. اطلاعات درباره نحوه گزارش باگ‌ها در این نشانی در دسترس است: ⟨https://dovecot.org/bugreport.html⟩

doveadm(1)

May 2026 e5ac02a