debian: Synchronize debian/changelog with downstream Debian changelog.
[openvswitch] / lib / vlog-unixctl.man
1 .SS "VLOG COMMANDS"
2 These commands manage \fB\*(PN\fR's logging settings.
3 .IP "\fBvlog/set\fR [\fIspec\fR]"
4 Sets logging levels.  Without any \fIspec\fR, sets the log level for
5 every module and facility to \fBdbg\fR.  Otherwise, \fIspec\fR is a
6 list of words separated by spaces or commas or colons, up to one from
7 each category below:
8 .
9 .RS
10 .IP \(bu
11 A valid module name, as displayed by the \fBvlog/list\fR command on
12 \fBovs\-appctl\fR(8), limits the log level change to the specified
13 module.
14 .
15 .IP \(bu
16 \fBsyslog\fR, \fBconsole\fR, or \fBfile\fR, to limit the log level
17 change to only to the system log, to the console, or to a file,
18 respectively.
19 .
20 .IP \(bu 
21 \fBoff\fR, \fBemer\fR, \fBerr\fR, \fBwarn\fR, \fBinfo\fR, or
22 \fBdbg\fR, to control the log level.  Messages of the given severity
23 or higher will be logged, and messages of lower severity will be
24 filtered out.  \fBoff\fR filters out all messages.  See
25 \fBovs\-appctl\fR(8) for a definition of each log level.
26 .RE
27 .
28 .IP
29 Case is not significant within \fIspec\fR.
30 .IP
31 Regardless of the log levels set for \fBfile\fR, logging to a file
32 will not take place unless \fB\*(PN\fR was invoked with the
33 \fB\-\-log\-file\fR option.
34 .IP
35 For compatibility with older versions of OVS, \fBany\fR is accepted as
36 a word but has no effect.
37 .RE
38 .IP "\fBvlog/set PATTERN:\fIfacility\fB:\fIpattern\fR"
39 Sets the log pattern for \fIfacility\fR to \fIpattern\fR.  Refer to
40 \fBovs\-appctl\fR(8) for a description of the valid syntax for \fIpattern\fR.
41 .
42 .IP "\fBvlog/list\fR"
43 Lists the supported logging modules and their current levels.
44 .
45 .IP "\fBvlog/reopen\fR"
46 Causes \fB\*(PN\fR to close and reopen its log file.  (This is useful
47 after rotating log files, to cause a new log file to be used.)
48 .IP
49 This has no effect unless \fB\*(PN\fR was invoked with the
50 \fB\-\-log\-file\fR option.