ovs-appctl: Document the facility "file" option.
authorGurucharan Shetty <gshetty@nicira.com>
Fri, 27 Jan 2012 18:26:24 +0000 (10:26 -0800)
committerGurucharan Shetty <gshetty@nicira.com>
Sat, 28 Jan 2012 00:55:52 +0000 (16:55 -0800)
The ovs-appctl man page has missing information about the
facility - "file". This patch adds that information.

Signed-off-by: Gurucharan Shetty <gshetty@nicira.com>
utilities/ovs-appctl.8.in

index fc5c885c5e4de04951747c8b88c917cb31059e4b..d851ea1011ed92be3ca02eb4e242f6091f224c71 100644 (file)
@@ -107,14 +107,15 @@ 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
 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
+\fBsyslog\fR, \fBconsole\fR or \fBfile\fR to set the levels for logging to
+the system log, console or a file, respectively, or \fBANY\fR to set the
+logging levels for all facilities.  If it is omitted,
+\fIfacility\fR defaults to \fBANY\fR. Regardless of the log levels set for
+\fBfile\fR, logging to a file will not take place unless the target application
+was invoked with the \fB\-\-logfile\fR option. The \fIlevel\fR must be one of
 \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.
+\fBdbg\fR, designating the minimum severity of a message for it to be logged.
+If it is omitted, \fIlevel\fR defaults to \fBdbg\fR.
 .
 .IP "\fBvlog/set PATTERN:\fIfacility\fB:\fIpattern\fR"
 Sets the log pattern for \fIfacility\fR to \fIpattern\fR.  Each time a
@@ -183,7 +184,7 @@ width.  (A field wider than \fIwidth\fR is not truncated to fit.)
 .RE
 .
 .IP
-The default pattern for console output is \fB%d{%b %d
+The default pattern for console and file output is \fB%d{%b %d
 %H:%M:%S}|%05N|%c|%p|%m\fR; for syslog output, \fB%05N|%c|%p|%m\fR.
 .
 .IP "\fBvlog/reopen\fR"