5c60a855d0c795987cb04710300c203c6a7d5bd7
[sliver-openvswitch.git] / lib / vlog-unixctl.man
1 .SS "VLOG COMMANDS"
2 These commands manage \fB\*(PN\fR's logging settings.
3 .IP "\fBvlog/set\fR \fImodule\fR[\fB:\fIfacility\fR[\fB:\fIlevel\fR]]"
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 The log level for the \fBfile\fR facility has no effect unless
20 \fB\*(PN\fR was invoked with the \fB\-\-log\-file\fR option.
21 .IP \(bu 
22 \fIlevel\fR must be one of \fBemer\fR, \fBerr\fR, \fBwarn\fR,
23 \fBinfo\fR, or
24 \fBdbg\fR, designating the minimum severity of a message for it to be
25 logged.  If it is omitted, \fIlevel\fR defaults to \fBdbg\fR.
26 .RE
27 .IP "\fBvlog/set PATTERN:\fIfacility\fB:\fIpattern\fR"
28 Sets the log pattern for \fIfacility\fR to \fIpattern\fR.  Refer to
29 \fBovs\-appctl\fR(8) for a description of the valid syntax for \fIpattern\fR.
30 .
31 .IP "\fBvlog/list\fR"
32 Lists the supported logging modules and their current levels.
33 .
34 .IP "\fBvlog/reopen\fR"
35 Causes \fB\*(PN\fR to close and reopen its log file.  (This is useful
36 after rotating log files, to cause a new log file to be used.)
37 .IP
38 This has no effect unless \fB\*(PN\fR was invoked with the
39 \fB\-\-log\-file\fR option.