.TH "DOVEADM-LOG" "1" "May 2026" "e5ac02a" "Dovecot"
.SH "نام (NAME)"
doveadm-log \- مکان‌یابی، آزمایش یا بازگشایی مجدد فایل‌های گزارش Dovecot
.SH "خلاصه دستور (SYNOPSIS)"
.P
\fBdoveadm\fR \[lB]\fIGLOBAL OPTIONS\fR\[rB] \fBlog errors\fR \[lB]\fB-s\fR \fImin_timestamp\fR\[rB]
.P
\fBdoveadm\fR \[lB]\fIGLOBAL OPTIONS\fR\[rB] \fBlog find\fR \[lB]\fIdirectory\fR\[rB]
.P
\fBdoveadm\fR \[lB]\fIGLOBAL OPTIONS\fR\[rB] \fBlog reopen\fR
.P
\fBdoveadm\fR \[lB]\fIGLOBAL OPTIONS\fR\[rB] \fBlog test\fR
.SH "توضیحات (DESCRIPTION)"
.P
دستورات \fBdoveadm log\fR برای مکان‌یابی و بازگشایی مجدد فایل‌های گزارش (log) مربوط به dovecot(1) به کار می‌روند. همچنین امکان آزمایش مقصدهای پیکربندی‌شده در تنظیمات \fIlog_path\fR نیز وجود دارد.
.SH "گزینه‌های سراسری (GLOBAL OPTIONS)"
.P
گزینه‌های سراسری doveadm(1):
.P
\fB-D\fR
.RS 0
.RS 4
.P
پیام‌های پرگویا (\fIverbosity\fR) و اشکال‌زدایی (debug) را فعال می‌کند.
.RE 0

.RE 0

.P
\fB-O\fR
.RS 0
.RS 4
.P
هیچ فایل پیکربندی‌ای خوانده نشود، صرفاً از مقادیر پیش‌فرض استفاده شود. مقدار پیش‌فرض تنظیم \fBdovecot_storage_version\fR برابر با آخرین نسخه است، اما می‌توان آن را با \fB-o\fR بازنویسی کرد.
.RE 0

.RE 0

.P
\fB-k\fR
.RS 0
.RS 4
.P
حفظ کل متغیرهای محیطی برای doveadm، نه فقط تنظیم \fBimport_environment\fR.
.RE 0

.RE 0

.P
\fB-v\fR
.RS 0
.RS 4
.P
پرگویی را به همراه شمارنده پیشرفت فعال می‌کند.
.RE 0

.RE 0

.P
\fB-i\fR \fIinstance-name\fR
.RS 0
.RS 4
.P
در صورت استفاده از چند نمونه (instance) از Dovecot، فایل پیکربندی را بر اساس این نام نمونه انتخاب می‌کند.
.P
برای اطلاعات بیشتر به تنظیم \fBinstance_name\fR مراجعه کنید.
.RE 0

.RE 0

.P
\fB-c\fR \fIconfig-file\fR
.RS 0
.RS 4
.P
پیکربندی را از \fIconfig-file\fR داده‌شده بخواند. به‌طور پیش‌فرض ابتدا سوکت پیکربندی خوانده می‌شود و در صورت عدم دسترسی، به \fI/etc/dovecot/dovecot.conf\fR رجوع می‌گردد. همچنین می‌توانید این مقدار را به سوکت پیکربندی نمونه‌ای که نسخه‌ای سازگار را اجرا می‌کند هدایت کنید.
.RE 0

.RE 0

.P
\fB-o\fR \fIsetting\fR\fB=\fR\fIvalue\fR
.RS 0
.RS 4
.P
تنظیم پیکربندی (\fIsetting\fR) را از \fI/etc/dovecot/dovecot.conf\fR و از userdb با \fIvalue\fR داده‌شده بازنویسی می‌کند. جهت بازنویسی چندین تنظیم، می‌توان گزینه \fB-o\fR را چندین بار مشخص کرد.
.RE 0

.RE 0

.SH "دستورات (COMMANDS)"
.SS "log errors"
.P
\fBdoveadm\fR \[lB]\fIGLOBAL OPTIONS\fR\[rB] log errors \[lB]\fB-s\fR \fImin_timestamp\fR\[rB]
.P
دستور \fBlog errors\fR برای نمایش آخرین خطاها و هشدارها (حداکثر تا ۱۰۰۰ مورد) استفاده می‌شود. اگر خروجی تولید نشود، از زمان آخرین راه‌اندازی هیچ خطایی رخ نداده است.
.P
\fB-s\fR \fImin_timestamp\fR
.RS 0
.RS 4
.P
یک مقدار عدد صحیح که ثانیه‌های سپری‌شده از مبدأ زمان (epoch) - که با نام برچسب زمان یونیکس (Unix timestamp) نیز شناخته می‌شود - را مشخص می‌کند. هنگامی که یک min_timestamp ارائه شود، doveadm(1) تنها خطاهایی را نمایش می‌دهد که از آن نقطه زمانی به بعد رخ داده‌اند.
.RE 0

.RE 0

.SS "log find"
.P
\fBdoveadm\fR \[lB]\fIGLOBAL OPTIONS\fR\[rB] log find \[lB]\fIdirectory\fR\[rB]
.P
دستور \fBlog find\fR برای نمایش مکان فایل‌های گزارش استفاده می‌شود. اگر dovecot(1) پیام‌های خود را از طریق \fBsyslogd\fR(8) ثبت می‌کند و doveadm(1) نتوانست هیچ فایل گزارشی بیابد، می‌توانید \fIdirectory\fR (پوشه‌ای) که syslogd فایل‌های گزارش خود را در آن می‌نویسد مشخص کنید.
.SS "log reopen"
.P
\fBdoveadm\fR \[lB]\fIGLOBAL OPTIONS\fR\[rB] log reopen
.P
این دستور باعث می‌شود \fBdoveadm\fR یک سیگنال SIGUSR1 به فرآیند اصلی (master process) ارسال کند، که این امر موجب بازگشایی مجدد تمامی فایل‌های گزارش پیکربندی‌شده در تنظیمات \fIlog_path\fR، \fIinfo_log_path\fR و \fIdebug_log_path\fR می‌گردد. این تنظیمات در \fI/etc/dovecot/conf.d/10-logging.conf\fR پیکربندی می‌شوند.
.P
فرآیند اصلی همچنین به فرآیند ثبت گزارش (log process) سیگنال می‌دهد تا همین کار را انجام دهد. این امر عمدتاً پس از چرخش دستی فایل‌های گزارش (log rotation) کاربرد دارد.
.SS "log test"
.P
\fBdoveadm\fR \[lB]\fIGLOBAL OPTIONS\fR\[rB] log test
.P
این دستور باعث می‌شود \fBdoveadm\fR پیام «This is Dovecot's \fIpriority\fR log (\fItimestamp\fR)» را در فایل‌های گزارش پیکربندی‌شده بنویسد. اولویت‌های استفاده‌شده عبارتند از: \fBdebug\fR، \fBinfo\fR، \fBwarning\fR، \fBerror\fR و \fBfatal\fR.
.SH "مثال‌ها (EXAMPLES)"
.P
این مثال نحوه مکان‌یابی فایل‌های گزارش استفاده‌شده توسط dovecot(1) را نشان می‌دهد:
.P
.RS 2
.nf
doveadm log find
.fi
.RE
.P
.RS 2
.nf
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
.fi
.RE
.SH "گزارش باگ‌ها (BUGS)"
.P
گزارش‌های باگ، از جمله خروجی \fIdoveconf -n\fR را به فهرست پستی Dovecot به نشانی \fI\(ladovecot@dovecot.org\(ra\fR ارسال کنید. اطلاعات درباره نحوه گزارش باگ‌ها در این نشانی در دسترس است: \fI\(lahttps://dovecot.org/bugreport.html\(ra\fR
.SH "همچنین ببینید (SEE ALSO)"
.P
doveadm(1)