Mercurial > dovecot > core-2.2

comparison doc/man/doveadm-log.1.in @ 11644:be2b7d2901a0 HEAD

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
doc: added manual pages
author Pascal Volk <user@localhost.localdomain.org>
date Mon, 28 Jun 2010 13:56:39 +0000
parents
children a2bbd6c3624a
comparison
equal deleted inserted replaced
11643:9be162cc2c52 11644:be2b7d2901a0
1 .\" Copyright (c) 2010 Dovecot authors, see the included COPYING file
2 .TH DOVEADM\-LOG 1 "2010-06-13" "Dovecot v2.0" "Dovecot"
3 .SH NAME
4 doveadm\-log \- Locate, test or reopen Dovecot\(aqs log files
5 .\"------------------------------------------------------------------------
6 .SH SYNOPSIS
7 .BR doveadm " [" \-Dv "] " "log find"
8 .RI [ directory ]
9 .\"-------------------------------------
10 .br
11 .BR doveadm " [" \-Dv "] " "log reopen"
12 .\"-------------------------------------
13 .br
14 .BR doveadm " [" \-Dv "] " "log test"
15 .\"------------------------------------------------------------------------
16 .SH DESCRIPTION
17 The
18 .B doveadm log
19 .I commands
20 are used to locate and reopen the log files of
21 .BR dovecot (1).
22 It\(aqs also possible to test the configured targets of the
23 .I *log_path
24 settings.
25 .\"------------------------------------------------------------------------
26 @INCLUDE:global-options@
27 .\"------------------------------------------------------------------------
28 .SH COMMANDS
29 .SS log find
30 .B doveadm log find
31 .RI [ directory ]
32 .PP
33 The
34 .B log find
35 command is used to show the location of the log files, to which
36 .BR dovecot (1)
37 sends its log messages.
38 If
39 .BR dovecot (1)
40 logs its messages through
41 .BR syslogd (8)
42 and
43 .BR doveadm (1)
44 could not find any log files, you can specify the
45 .I directory
46 where your syslogd writes its log files.
47 .\"-------------------------------------
48 .SS log reopen
49 .B doveadm log reopen
50 .PP
51 This command causes
52 .B doveadm
53 to reopen all log files, configured in the
54 .IR log_path ,
55 .I info_log_path
56 and
57 .I debug_log_path
58 settings.
59 These settings are configured in
60 .IR @sysconfdir@/dovecot/conf.d/10\-logging.conf .
61 .br
62 This is for example useful after manually rotating the log files.
63 .\"-------------------------------------
64 .SS log test
65 .B doveadm log test
66 .PP
67 This command causes
68 .B doveadm
69 to write the message \(dqThis is Dovecot\(aqs
70 .I priority
71 log
72 .RI ( timestamp )\(dq
73 to the configured log files.
74 The used priorities are:
75 .BR debug ,
76 .BR info ,
77 .BR warning ,
78 .BR error
79 and
80 .BR fatal .
81 .\"------------------------------------------------------------------------
82 .SH EXAMPLE
83 This example shows how to locate the log files used by
84 .BR dovecot (1).
85 .sp
86 .nf
87 .B doveadm log find
88 Looking for log files from /var/log
89 Debug: /var/log/dovecot.debug
90 Info: /var/log/mail.log
91 Warning: /var/log/mail.log
92 Error: /var/log/mail.log
93 Fatal: /var/log/mail.log
94 .fi
95 .\"------------------------------------------------------------------------
96 @INCLUDE:reporting-bugs@
97 .\"------------------------------------------------------------------------
98 .SH SEE ALSO
99 .BR doveadm (1)