.
.SH SYNOPSIS
\fBovs\-appctl\fR [\fB\-\-target=\fItarget\fR | \fB\-t\fR \fItarget\fR]
+[\fB\-T \fIsecs\fR | \fB\-\-timeout=\fIsecs\fR]
\fIcommand \fR[\fIarg\fR...]
.br
-\fBovs\-appctl\fR \-\-help
+\fBovs\-appctl \fB\-\-help\fR
.br
-\fBovs\-appctl\fR \-\-version
+\fBovs\-appctl \fB\-\-version\fR
.SH DESCRIPTION
Open vSwitch daemons accept certain commands at runtime to control their
behavior and query their settings. Every daemon accepts a common set of
.IP
The default target is \fBovs\-vswitchd\fR.
.
+.IP "\fB\-T \fIsecs\fR"
+.IQ "\fB\-\-timeout=\fIsecs\fR"
+By default, or with a \fIsecs\fR of \fB0\fR, \fBovs\-appctl\fR waits
+forever to connect to the daemon and receive a response. This option
+limits runtime to approximately \fIsecs\fR seconds. If the timeout
+expires, \fBovs\-appctl\fR exits with a \fBSIGALRM\fR signal.
+.
.SH COMMON COMMANDS
Every Open vSwitch daemon supports a common set of commands, which are
documented in this section.
\fB\-\-version\fR options that return information about the
\fBovs\-appctl\fR utility itself.
.
-.IP "\fBhelp\fR"
+.IP "\fBlist-commands\fR"
Lists the commands supported by the target.
.
.IP "\fBversion\fR"
.
.IP "\fBoff\fR"
No message is ever logged at this level, so setting a logging
-facility's log level to \fBoff\fR disables logging to that facility.
+destination's log level to \fBoff\fR disables logging to that destination.
.
.PP
The following log levels, in order of descending severity, are
.IP "\fBvlog/list\fR"
Lists the known logging modules and their current levels.
.
+.IP "\fBvlog/list-pattern\fR"
+Lists logging pattern used for each destination.
+.
.IP "\fBvlog/set\fR [\fIspec\fR]"
Sets logging levels. Without any \fIspec\fR, sets the log level for
-every module and facility to \fBdbg\fR. Otherwise, \fIspec\fR is a
+every module and destination to \fBdbg\fR. Otherwise, \fIspec\fR is a
list of words separated by spaces or commas or colons, up to one from
each category below:
.
For compatibility with older versions of OVS, \fBany\fR is accepted as
a word but has no effect.
.
-.IP "\fBvlog/set PATTERN:\fIfacility\fB:\fIpattern\fR"
-Sets the log pattern for \fIfacility\fR to \fIpattern\fR. Each time a
-message is logged to \fIfacility\fR, \fIpattern\fR determines the
+.IP "\fBvlog/set PATTERN:\fIdestination\fB:\fIpattern\fR"
+Sets the log pattern for \fIdestination\fR to \fIpattern\fR. Each time a
+message is logged to \fIdestination\fR, \fIpattern\fR determines the
message's formatting. Most characters in \fIpattern\fR are copied
literally to the log, but special escapes beginning with \fB%\fR are
expanded as follows:
%H:%M:%SZ}|%05N|%c|%p|%m\fR; for syslog output, \fB%05N|%c|%p|%m\fR.
.
.IP
-Daemons written in Python (e.g. \fBovs\-xapi\-sync\fR,
-\fBovs\-monitor\-ipsec) do not allow control over the log pattern.
+Daemons written in Python (e.g. \fBovs\-xapi\-sync\fR) do not allow
+control over the log pattern.
+.
+.IP "\fBvlog/set\fR FACILITY:\fIfacility\fR"
+Sets the RFC5424 facility of the log message. \fIfacility\fR can be one of
+\fBkern\fR, \fBuser\fR, \fBmail\fR, \fBdaemon\fR, \fBauth\fR, \fBsyslog\fR,
+\fBlpr\fR, \fBnews\fR, \fBuucp\fR, \fBclock\fR, \fBftp\fR, \fBntp\fR,
+\fBaudit\fR, \fBalert\fR, \fBclock2\fR, \fBlocal0\fR, \fBlocal1\fR,
+\fBlocal2\fR, \fBlocal3\fR, \fBlocal4\fR, \fBlocal5\fR, \fBlocal6\fR or
+\fBlocal7\fR.
+.
+.IP "\fBvlog/close\fR"
+Causes the daemon to close its log file, if it is open. (Use
+\fBvlog/reopen\fR to reopen it later.)
.
.IP "\fBvlog/reopen\fR"
-Causes the daemon to close and reopen its log file. (This
-is useful after rotating log files, to cause a new log file to be
-used.)
+Causes the daemon to close its log file, if it is open, and then
+reopen it. (This is useful after rotating log files, to cause a new
+log file to be used.)
.IP
This has no effect if the target application was not invoked with the
\fB\-\-log\-file\fR option.