X-Git-Url: https://pintos-os.org/cgi-bin/gitweb.cgi?a=blobdiff_plain;f=utilities%2Fovs-appctl.8.in;h=3540693d2db7eabbb3b172eedef00480a2961f7d;hb=14622f22abd93ca464c9be1b6b58d6f0fb2bb186;hp=3248e2cd795838f8c258f2b1677b6076248ca9bf;hpb=5f55c39b21e69025045437ffbd3bb98fe6ce2e89;p=openvswitch diff --git a/utilities/ovs-appctl.8.in b/utilities/ovs-appctl.8.in index 3248e2cd..3540693d 100644 --- a/utilities/ovs-appctl.8.in +++ b/utilities/ovs-appctl.8.in @@ -11,19 +11,18 @@ ovs\-appctl \- utility for configuring running Open vSwitch daemons . .SH SYNOPSIS -\fBovs\-appctl\fR [\fB--target=\fItarget\fR | \fB-t\fR \fItarget\fR] +\fBovs\-appctl\fR [\fB\-\-target=\fItarget\fR | \fB\-t\fR \fItarget\fR] \fIcommand \fR[\fIarg\fR...] .br -\fBovs\-appctl\fR --help +\fBovs\-appctl\fR \-\-help .br -\fBovs\-appctl\fR --version +\fBovs\-appctl\fR \-\-version .SH DESCRIPTION -Open vSwitch daemons accept certain commands at runtime to control -their behavior and query their settings. Every daemon accepts the -commands for querying and adjusting its logging settings documented -under \fBLOGGING COMMANDS\fR below, and \fBovs\-vswitchd\fR in -particular accepts a number of additional commands documented in -\fBovs\-vswitchd\fR(8). +Open vSwitch daemons accept certain commands at runtime to control their +behavior and query their settings. Every daemon accepts a common set of +commands documented under \fBCOMMON COMMANDS\fR below, and +\fBovs\-vswitchd\fR in particular accepts a number of additional +commands documented in \fBovs\-vswitchd\fR(8). .PP The \fBovs\-appctl\fR program provides a simple way to invoke these commands. The command to be sent is specified on \fBovs\-appctl\fR's @@ -40,8 +39,8 @@ on which an Open vSwitch daemon is listening for control channel connections. By default, each daemon listens on a Unix domain socket named \fB@RUNDIR@/\fIprogram\fB.\fIpid\fB.ctl\fR, where \fIprogram\fR is the program's name and \fIpid\fR is its process ID. For example, -if \fBovs-vswitchd\fR has PID 123, it would listen on -\fB@RUNDIR@/ovs-vswitchd.123.ctl\fR. +if \fBovs\-vswitchd\fR has PID 123, it would listen on +\fB@RUNDIR@/ovs\-vswitchd.123.ctl\fR. .IP Otherwise, \fBovs\-appctl\fR looks for a pidfile, that is, a file whose contents are the process ID of a running process as a decimal @@ -54,23 +53,66 @@ as if it had been specified directly as the target. .IP The default target is \fBovs\-vswitchd\fR. . -.SH LOGGING COMMANDS -Every Open vSwitch daemon supports the following commands for -examining and adjusting log levels. +.SH COMMON COMMANDS +Every Open vSwitch daemon supports a common set of commands, which are +documented in this section. . +.SS GENERAL COMMANDS +These commands display daemon-specific commands and the running version. +Note that these commands are different from the \fB\-\-help\fR and +\fB\-\-version\fR options that return information about the +\fBovs\-appctl\fR utility itself. +. +.IP "\fBhelp\fR" +Lists the commands supported by the target. +. +.IP "\fBversion\fR" +Displays the version and compilation date of the target. +. +.SS LOGGING COMMANDS +Open vSwitch has several log levels. The highest-severity log level is: +. +.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. +. +.PP +The following log levels, in order of descending severity, are +available: +. +.IP "\fBEMER\fR" +A major failure forced a process to abort. +.IP "\fBERR\fR" +A high-level operation or a subsystem failed. Attention is +warranted. +.IP "\fBWARN\fR" +A low-level operation failed, but higher-level subsystems may be able +to recover. +.IP "\fBINFO\fR" +Information that may be useful in retrospect when investigating +a problem. +.IP "\fBDBG\fR" +Information useful only to someone with intricate knowledge of the +system, or that would commonly cause too-voluminous log output. Log +messages at this level are not logged by default. +. +.PP +Every Open vSwitch daemon supports the following commands for examining +and adjusting log levels. .IP "\fBvlog/list\fR" Lists the known logging modules and their current levels. . .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. The \fImodule\fR may be any valid module name (as -displayed by the \fB--list\fR option) or the special name \fBANY\fR to +displayed by the \fB\-\-list\fR option) or the special name \fBANY\fR to set the logging levels for all modules. The \fIfacility\fR may be \fBsyslog\fR or \fBconsole\fR to set the levels for logging to the system log or to the console, respectively, or \fBANY\fR to set the logging levels for both facilities. If it is omitted, \fIfacility\fR defaults to \fBANY\fR. The \fIlevel\fR must be one of -\fBemer\fR, \fBerr\fR, \fBwarn\fR, \fBinfo\fR, or \fBdbg\fR, designating the +\fBoff\fR, \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. . @@ -83,14 +125,14 @@ expanded as follows: . .RS .IP \fB%A\fR -The name of the application logging the message, e.g. \fBovs-vswitchd\fR. +The name of the application logging the message, e.g. \fBovs\-vswitchd\fR. . .IP \fB%c\fR -The name of the module (as shown by \fBovs\-appctl --list\fR) logging +The name of the module (as shown by \fBovs\-appctl \-\-list\fR) logging the message. . .IP \fB%d\fR -The current date and time in ISO 8601 format (YYYY-MM-DD HH:MM:SS). +The current date and time in ISO 8601 format (YYYY\-MM\-DD HH:MM:SS). . .IP \fB%d{\fIformat\fB}\fR The current date and time in the specified \fIformat\fR, which takes @@ -126,7 +168,7 @@ A few options may appear between the \fB%\fR and the format specifier character, in this order: . .RS -.IP \fB-\fR +.IP \fB\-\fR Left justify the escape's expansion within its field width. Right justification is the default. . @@ -150,7 +192,7 @@ 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. +\fB\-\-log\-file\fR option. . .SH OPTIONS . @@ -166,7 +208,5 @@ white space. . \fBovs\-appctl\fR can control the following daemons: .BR ovs\-vswitchd (8), -.BR ovs\-openflowd (8), .BR ovs\-controller (8), -.BR ovs\-brcompatd (8), -.BR ovs\-discover (8). +.BR ovs\-brcompatd (8).