[mirror_ovs.git] / lib / vlog-unixctl.man

.SS "VLOG COMMANDS"
These commands manage \fB\*(PN\fR's logging settings.
.IP "\fBvlog/set\fR \fImodule\fR[\fB:\fIfacility\fR[\fB:\fIlevel\fR]]"
Sets the logging level for \fImodule\fR in \fIfacility\fR to
\fIlevel\fR:
.
.RS
.IP \(bu
\fImodule\fR may be any valid module name (as displayed by the
\fB--list\fR action on \fBovs-appctl\fR(8)), or the special name
\fBANY\fR to set the logging levels for all modules.
.
.IP \(bu
\fIfacility\fR may be \fBsyslog\fR, \fBconsole\fR, or \fBfile\fR to
set the levels for logging to the system log, the console, or a file
respectively, or \fBANY\fR to set the logging levels for both
facilities.  If it is omitted, \fIfacility\fR defaults to \fBANY\fR.
.IP
The log level for the \fBfile\fR facility has no effect unless
\fB\*(PN\fR was invoked with the \fB--log-file\fR option.
.IP \(bu 
\fIlevel\fR must be one of \fBemer\fR, \fBerr\fR, \fBwarn\fR,
\fBinfo\fR, or
\fBdbg\fR, designating the minimum severity of a message for it to be
logged.  If it is omitted, \fIlevel\fR defaults to \fBdbg\fR.
.RE
.IP "\fBvlog/set PATTERN:\fIfacility\fB:\fIpattern\fR"
Sets the log pattern for \fIfacility\fR to \fIpattern\fR.  Refer to
\fBovs-appctl\fR(8) for a description of the valid syntax for \fIpattern\fR.
.
.IP "\fBvlog/list\fR"
Lists the supported logging modules and their current levels.
.
.IP "\fBvlog/reopen\fR"
Causes \fB\*(PN\fR to close and reopen its log file.  (This is useful
after rotating log files, to cause a new log file to be used.)
.IP
This has no effect unless \fB\*(PN\fR was invoked with the
\fB--log-file\fR option.
Commit	Line	Data
b16fdafe BP	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.