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

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

خلاصه دستور (SYNOPSIS)
       doveadm [GLOBAL OPTIONS] log errors [-s min_timestamp]

       doveadm [GLOBAL OPTIONS] log find [directory]

       doveadm [GLOBAL OPTIONS] log reopen

       doveadm [GLOBAL OPTIONS] log test

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

گزینه‌های سراسری (GLOBAL OPTIONS)
       گزینه‌های سراسری 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 را چندین بار مشخص کرد.



دستورات (COMMANDS)
   log errors
       doveadm [GLOBAL OPTIONS] log errors [-s min_timestamp]

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

       -s min_timestamp

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



   log find
       doveadm [GLOBAL OPTIONS] log find [directory]

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

   log reopen
       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) کاربرد دارد.

   log test
       doveadm [GLOBAL OPTIONS] log test

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

مثال‌ها (EXAMPLES)
       این مثال نحوه مکان‌یابی فایل‌های گزارش استفاده‌شده توسط 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

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

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

e5ac02a                            May 2026                     DOVEADM-LOG(1)