vlog: Add a new log level "off".
[sliver-openvswitch.git] / lib / vlog.man
1 .TP
2 \fB\-v\fImodule\fR[\fB:\fIfacility\fR[\fB:\fIlevel\fR]], \fB\-\-verbose=\fImodule\fR[\fB:\fIfacility\fR[\fB:\fIlevel\fR]]
3 .
4 Sets the logging level for \fImodule\fR in \fIfacility\fR to
5 \fIlevel\fR:
6 .
7 .RS
8 .IP \(bu
9 \fImodule\fR may be any valid module name (as displayed by the
10 \fB\-\-list\fR action on \fBovs\-appctl\fR(8)), or the special name
11 \fBANY\fR to set the logging levels for all modules.
12 .
13 .IP \(bu
14 \fIfacility\fR may be \fBsyslog\fR, \fBconsole\fR, or \fBfile\fR to
15 set the levels for logging to the system log, the console, or a file
16 respectively, or \fBANY\fR to set the logging levels for both
17 facilities.  If it is omitted, \fIfacility\fR defaults to \fBANY\fR.
18 .IP
19 Regardless of the log levels set for \fBfile\fR, logging to a file
20 will not take place unless \fB\-\-log\-file\fR is also specified (see
21 below).
22 .
23 .IP \(bu 
24 \fIlevel\fR must be one of \fBoff\fR, \fBemer\fR, \fBerr\fR, \fBwarn\fR,
25 \fBinfo\fR, or
26 \fBdbg\fR, designating the minimum severity of a message for it to be
27 logged.  If it is omitted, \fIlevel\fR defaults to \fBdbg\fR.
28 .RE
29 .
30 .TP
31 \fB\-v\fR, \fB\-\-verbose\fR
32 Sets the maximum logging verbosity level, equivalent to
33 \fB\-\-verbose=ANY:ANY:dbg\fR.
34 .
35 .TP
36 \fB\-vPATTERN:\fIfacility\fB:\fIpattern\fR, \fB\-\-verbose=PATTERN:\fIfacility\fB:\fIpattern\fR
37 Sets the log pattern for \fIfacility\fR to \fIpattern\fR.  Refer to
38 \fBovs\-appctl\fR(8) for a description of the valid syntax for \fIpattern\fR.
39 .
40 .TP
41 \fB\-\-log\-file\fR[\fB=\fIfile\fR]
42 Enables logging to a file.  If \fIfile\fR is specified, then it is
43 used as the exact name for the log file.  The default log file name
44 used if \fIfile\fR is omitted is \fB@LOGDIR@/\*(PN.log\fR.