utilities/vlogconf.8

   1 .TH vlogconf 8 "March 2008" "OpenFlow" "OpenFlow Manual"
   2
   3 .SH NAME
   4 vlogconf \- configuration utility for OpenFlow logging in userspace
   5
   6 .SH SYNOPSIS
   7 \fBvlogconf\fR [\fB-h\fR | \fB--help\fR] [TARGET...] [ACTION...]
   8 .sp 1
   9 The available TARGET options are:
  10 .br
  11 [\fB-a\fR | \fB--all\fR] [\fB-t\fR PID | \fB--target=\fIPID\fR]
  12 .sp 1
  13 The available ACTION options are:
  14 .br
  15 [\fB-l\fR | \fB--list\fR] [\fB-s\fR
  16 \fIMODULE\fB:\fIFACILITY\fB:\fILEVEL\fR |
  17 \fB--set=\fIMODULE\fB:\fIFACILITY\fB:\fILEVEL\fR]
  18
  19 .SH DESCRIPTION
  20 The \fBvlogconf\fR program configures the logging system used by the
  21 OpenFlow userspace programs.  The logging configuration may be modified
  22 while OpenFlow programs are running.
  23
  24 \fBvlogconf\fR applies one or more actions to each of one or more
  25 target processes.  Targets may be specified as:
  26
  27 .TP
  28 \fB-a\fR, \fB--all\fR
  29 All running processes that \fBvlogconf\fR can control.
  30
  31 .TP
  32 \fB-t \fIPID\fR, \fB--target=\fIPID\fR
  33 The process with the specified \fIPID\fR.  \fIPID\fR may also specify
  34 an absolute path (beginning with `/') to the Unix domain socket for a
  35 \fBvlogconf\fR-controllable process.
  36
  37 .PP
  38 The available actions are:
  39
  40 .TP
  41 \fB-l\fR, \fB--list\fR
  42 Print the list of known modules and their current logging levels to
  43 stdout.
  44
  45 .TP
  46 \fB-s\fR \fIMODULE\fB:\fIFACILITY\fB:\fILEVEL\fR, \fB--set=\fIMODULE\fB:\fIFACILITY\fB:\fILEVEL\fR
  47
  48 Sets the logging level for \fIMODULE\fR in \fIFACILITY\fR to
  49 \fILEVEL\fR.  \fIMODULE\fR may be any valid module name (as displayed
  50 by the \fB--list\fR option) or the special name \fBANY\fR to set all
  51 modules logging level.  \fIFACILITY\fR may be \fBsyslog\fR or
  52 \fBconsole\fR to set the levels for logging to the system log or to
  53 the console, respectively, or \fBANY\fR to set the logging levels for
  54 both modules.  \fILEVEL\fR must be one of \fBemer\fR, \fBerr\fR,
  55 \fBwarn\fR, or \fBdbg\fR, designating the minimum severity of a
  56 message for it to be logged.
  57
  58 .SH OPTIONS
  59 .TP
  60 \fB\-h\fR, \fB\-\^\-help\fR
  61 Prints a brief help message to the console and exits.
  62
  63
  64 .SH "SEE ALSO"
  65
  66 .BR dpctl (8),
  67 .BR secchan (8),
  68 .BR controller (8)