.\" Copyright (c) 2010-2013 Dovecot authors, see the included COPYING file .TH DOVEADM\-LOG 1M "2013-11-24" "Dovecot v2.2" "Dovecot" .SH NAME doveadm log \- Locate, test or reopen dovecot\'s log files .\"------------------------------------------------------------------------ .SH SYNOPSIS .nh .na .HP \" ./global-options-short.inc \" ./master-options-short.inc \fBdoveadm log errors\fR [\-D] [\-F\ \fIformatter\fR] [\-v] [\-c\ \fIfile\fR|\-i\ \fIinstance\fR] [\-k] [\-L] [\-O] [\-o\ \fIsetting\fB=\fIvalue\fR]... [\-s \fImin_timestamp\fR] .\"------------------------------------- .HP \" ./global-options-short.inc \" ./master-options-short.inc \fBdoveadm log find\fR [\-D] [\-F\ \fIformatter\fR] [\-v] [\-c\ \fIfile\fR|\-i\ \fIinstance\fR] [\-k] [\-L] [\-O] [\-o\ \fIsetting\fB=\fIvalue\fR]... [\fIdirectory\fR] .\"------------------------------------- .HP \" ./global-options-short.inc \" ./master-options-short.inc \fBdoveadm log reopen\fR [\-D] [\-F\ \fIformatter\fR] [\-v] [\-c\ \fIfile\fR|\-i\ \fIinstance\fR] [\-k] [\-L] [\-O] [\-o\ \fIsetting\fB=\fIvalue\fR]... .\"------------------------------------- .HP \" ./global-options-short.inc \" ./master-options-short.inc \fBdoveadm log test\fR [\-D] [\-F\ \fIformatter\fR] [\-v] [\-c\ \fIfile\fR|\-i\ \fIinstance\fR] [\-k] [\-L] [\-O] [\-o\ \fIsetting\fB=\fIvalue\fR]... .ad .hy .\"------------------------------------------------------------------------ .SH DESCRIPTION These commands are used to locate and reopen the log files of .BR dovecot (1M). It\'s also possible to test the configured targets of the \fI*log_path\fR settings. .\"------------------------------------------------------------------------ .SH OPTIONS Common options: \" ./global-options.inc \" vim: ts=4 sw=4 filetype=nroff .TP .B \-D Enables verbosity and debug messages. .TP .BI \-F\ formatter Specifies the \fIformatter\fR for formatting the output. Supported formatters are: .RS .TP 2 .B flow Prints each line with .IB key = value pairs. .TP .B pager Prints each .IB key = value pair on its own line and separates records with form feed character (\fB^L\fR). .TP .B tab Prints a table header followed by tab separated value lines. .TP .B table Prints a table header followed by adjusted value lines. .RE .TP .B \-v Enables verbosity, including progress counter. \" ./master-options.inc \" vim: ts=4 sw=4 filetype=nroff .TP .BI \-c\ file Read configuration from the given \fIfile\fR. By default \fI/etc/dovecot/dovecot.conf\fR will be used. .TP .BI \-i\ instance Get the configuration from the instance with the name \fIinstance\fR. .TP .B \-k Keep environment, i.e. when executing a new process do not explicitly set the environment variables HOME, USER and when reading configurations, don\'t overwrite currently set environment variables with corresponding settings. Usually used internally, only. .TP .B \-L Log directly. .TP .B \-O Don\'t read settings, but use whatever is in the environment. .TP .BI \-o\ setting = value Overrides the \fIsetting\fR from the current configuration with the given \fIvalue\fR (can be specified multiple times). E.g. with \-o dsync_alt_char=c one is able to overwrite the character to use as an replacement for all invalid characters encountered within a mailbox name (per default \'\fB_\fR'). .P Command specific options: .TP .BI \-s \ min_timestamp An integer value, representing seconds since the epoch \- also known as Unix timestamp. When a min_timestamp was given, .BR doveadm (1M) will only show errors occurred since that point in time. .\"------------------------------------------------------------------------ .SH SUBCOMMANDS .na .HP \" ./global-options-short.inc \" ./master-options-short.inc \fBlog errors\fR [\-D] [\-F\ \fIformatter\fR] [\-v] [\-c\ \fIfile\fR|\-i\ \fIinstance\fR] [\-k] [\-L] [\-O] [\-o\ \fIsetting\fB=\fIvalue\fR]... [\-s \fImin_timestamp\fR] .ad .RS 3 .P This command is used to show the last \- up to 1,000 \- errors and warnings. If no output is generated, no errors have occurred since the last start. The \-s \fImin_timestamp\fR can be used to set the starting point in seconds since 01.01.1970 00:00.00 for the lookup. .RE .sp 2 .\"------------------------------------- .na .HP \" ./global-options-short.inc \" ./master-options-short.inc \fBlog find\fR [\-D] [\-F\ \fIformatter\fR] [\-v] [\-c\ \fIfile\fR|\-i\ \fIinstance\fR] [\-k] [\-L] [\-O] [\-o\ \fIsetting\fB=\fIvalue\fR]... [\fIdirectory\fR] .ad .RS 3 .P This command is used to show the location of the log files, to which .BR dovecot (1M) sends its log messages. If .BR dovecot (1M) logs its messages through .BR syslogd (1M) and is unable to find any log files, you can specify the \fIdirectory\fR where your syslogd writes its log files. .RE .sp 2 .\"------------------------------------- .na .HP \" ./global-options-short.inc \" ./master-options-short.inc \fBlog reopen\fR [\-D] [\-F\ \fIformatter\fR] [\-v] [\-c\ \fIfile\fR|\-i\ \fIinstance\fR] [\-k] [\-L] [\-O] [\-o\ \fIsetting\fB=\fIvalue\fR]... .ad .RS 3 .P This command causes .B doveadm to reopen all log files, configured in the .IR log_path , .I info_log_path and .I debug_log_path settings. These settings are configured in .IR /etc/dovecot/conf.d/10\-logging.conf . This is for example useful after manually rotating the log files. .RE .sp 2 .\"------------------------------------- .na .HP \" ./global-options-short.inc \" ./master-options-short.inc \fBlog test\fR [\-D] [\-F\ \fIformatter\fR] [\-v] [\-c\ \fIfile\fR|\-i\ \fIinstance\fR] [\-k] [\-L] [\-O] [\-o\ \fIsetting\fB=\fIvalue\fR]... .ad .RS 3 .P This command causes doveadm to write the message 'This is Dovecot\'s \fIpriority\fR log (\fItimestamp\fR)' to the configured log files. The used priorities are: .BR debug , .BR info , .BR warning , .BR error and .BR fatal . .RE .\"------------------------------------------------------------------------ .SH EXAMPLES This example shows how to locate the log files used by .BR dovecot (1M): .RS 3 .nf .B 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 .fi .RE .\"------------------------------------------------------------------------ .SH SEE ALSO .BR doveadm (1M) .\"------------------------------------------------------------------------ \" ./reporting-bugs.inc .SH REPORTING BUGS Report bugs, including \fBdoveconf \-n\fR output, to the dovecot Mailing List . Information about reporting bugs is available at: http://dovecot.org/bugreport.html