@@ -27,17 +27,17 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
2727.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
2828.in \\n[ rst2man-indent\\n[ rst2man-indent-level ] ]u
2929..
30- .TH "OVS-APPCTL" "8" "Aug 15 , 2024" "3.4" "Open vSwitch"
30+ .TH "OVS-APPCTL" "8" "Nov 16 , 2024" "3.4" "Open vSwitch"
3131.SH NAME
3232ovs-appctl \- utility for configuring running Open vSwitch daemons
3333.SH SYNOPSIS
3434.sp
3535\fB ovs \- appctl \fP
36- [\fB \-\- target= \( ga \( ga <target> | \( ga \( ga \ -t \fP <target> ]
37- [\fB \-\- timeout= \( ga \( ga <secs> | \( ga \( ga \ -T \fP <secs> ]
38- [\fB \-\- format= \( ga \( ga <format> | \( ga \( ga \ -f \fP <format> ]
36+ [\fB \-\- target= \fP\fI target \fP | \fB \ -t \fP \fI target \fP ]
37+ [\fB \-\- timeout= \fP\fI secs \fP | \fB \ -T \fP \fI secs \fP ]
38+ [\fB \-\- format= \fP\fI format \fP | \fB \ -f \fP \fI format \fP ]
3939[\fB \-\- pretty \fP ]
40- <command> [<arg>… ]
40+ \fI command \fP [ \fI arg \fP \fB \& ... \fP ]
4141.sp
4242\fB ovs \- appctl \-\- help \fP
4343.sp
@@ -59,11 +59,11 @@ command and prints the daemon’s response on standard output.
5959In normal use only a single option is accepted:
6060.INDENT 0.0
6161.IP \(bu 2
62- \fB \- t \fP <target> or \fB \-\- target \fP <target>
62+ \fB \- t \fP \fI target \fP or \fB \-\- target= \fP\fI target \fP
6363.sp
6464Tells \fB ovs \- appctl \fP which daemon to contact.
6565.sp
66- If <target> begins with \fB / \fP it must name a Unix domain socket on
66+ If \fI target \fP begins with \fB / \fP it must name a Unix domain socket on
6767which an Open vSwitch daemon is listening for control channel
6868connections. By default, each daemon listens on a Unix domain socket
6969in the rundir (e.g. \fB /run \fP ) named \fB <program>.<pid>.ctl \fP , where
@@ -73,33 +73,33 @@ example, if \fBovs\-vswitchd\fP has PID 123, it would listen on
7373.sp
7474Otherwise, \fB ovs \- appctl \fP looks in the rundir for a pidfile, that is,
7575a file whose contents are the process ID of a running process as a
76- decimal number, named \fB <target> .pid\fP \& . (The \fB \-\- pidfile \fP option
76+ decimal number, named \fI target \fP\fB \& .pid \fP \& . (The \fB \-\- pidfile \fP option
7777makes an Open vSwitch daemon create a pidfile.) \fB ovs \- appctl \fP reads
7878the pidfile, then looks in the rundir for a Unix socket named
79- \fB <target> .<pid>.ctl\fP , where <pid> is replaced by the process ID read
79+ \fI target \fP\fB \& .<pid>.ctl \fP , where <pid> is replaced by the process ID read
8080from the pidfile, and uses that file as if it had been specified
8181directly as the target.
8282.sp
83- On Windows, <target> can be an absolute path to a file that contains a
83+ On Windows, \fI target \fP can be an absolute path to a file that contains a
8484localhost TCP port on which an Open vSwitch daemon is listening for
8585control channel connections. By default, each daemon writes the TCP
8686port on which it is listening for control connection into the file
87- \fB <program>.ctl \fP located inside the rundir. If <target> is not an
87+ \fB <program>.ctl \fP located inside the rundir. If \fI target \fP is not an
8888absolute path, \fB ovs \- appctl \fP looks in the rundir for a file named
89- \fB <target> .ctl\fP \& . The default target is \fB ovs \- vswitchd \fP \& .
89+ \fI target \fP\fB \& .ctl \fP \& . The default \fI target \fP is \fB ovs \- vswitchd \fP \& .
9090.IP \(bu 2
91- \fB \- T <secs> \ fP or \fB \-\- timeout=<secs> \fP
91+ \fB \- T \fP \fI secs \ fP or \fB \-\- timeout= \fP\fI secs \fP
9292.sp
93- By default, or with a <secs> of \fB 0 \fP , \fB ovs \- appctl \fP waits forever to
93+ By default, or with a \fI secs \fP of \fB 0 \fP , \fB ovs \- appctl \fP waits forever to
9494connect to the daemon and receive a response. This option limits
95- runtime to approximately <secs> seconds. If the timeout expires,
95+ runtime to approximately \fI secs \fP seconds. If the timeout expires,
9696\fB ovs \- appctl \fP exits with a \fB SIGALRM \fP signal.
9797.IP \(bu 2
98- \fB \- f <format> \ fP or \fB \-\- format=<format> \fP
98+ \fB \- f \fP \fI format \ fP or \fB \-\- format= \fP\fI format \fP
9999.sp
100100Tells \fB ovs \- appctl \fP which output format to use. By default, or with a
101- <format> of \fB text \fP , \fB ovs \- appctl \fP will print plain\- text for humans.
102- When <format> is \fB json \fP , \fB ovs \- appctl \fP will return a JSON document.
101+ \fI format \fP of \fB text \fP , \fB ovs \- appctl \fP will print plain\- text for humans.
102+ When \fI format \fP is \fB json \fP , \fB ovs \- appctl \fP will return a JSON document.
103103When \fB json \fP is requested, but a command has not implemented JSON
104104output, the plain\- text output will be wrapped in a provisional JSON
105105document with the following structure:
@@ -194,10 +194,10 @@ Lists the known logging modules and their current levels.
194194.sp
195195Lists logging pattern used for each destination.
196196.IP \(bu 2
197- \fB vlog/set \fP [<spec> ]
197+ \fB vlog/set \fP [\fI spec \fP ]
198198.sp
199- Sets logging levels. Without any <spec> , sets the log level for
200- every module and destination to \fB dbg \fP \& . Otherwise, <spec> is a
199+ Sets logging levels. Without any \fI spec \fP , sets the log level for
200+ every module and destination to \fB dbg \fP \& . Otherwise, \fI spec \fP is a
201201list of words separated by spaces or commas or colons, up to one from
202202each category below:
203203.INDENT 2.0
@@ -210,7 +210,7 @@ module.
210210change to only to the system log, to the console, or to a file,
211211respectively.
212212.sp
213- On Windows platform, \fB syslog \fP is only useful if <target> was
213+ On Windows platform, \fB syslog \fP is only useful if \fI target \fP was
214214started with the \fB \-\- syslog \- target \fP option (it has no effect
215215otherwise).
216216.IP \(bu 2
@@ -220,20 +220,20 @@ will be logged, and messages of lower severity will be filtered out.
220220\fB off \fP filters out all messages.
221221.UNINDENT
222222.sp
223- Case is not significant within <spec> .
223+ Case is not significant within \fI spec \fP \& .
224224.sp
225225Regardless of the log levels set for \fB file \fP , logging to a file
226226will not take place unless the target application was invoked with the
227227\fB \-\- log \- file \fP option.
228228.sp
229229For compatibility with older versions of OVS, \fB any \fP is accepted
230- within <spec> but it has no effect.
230+ within \fI spec \fP but it has no effect.
231231.IP \(bu 2
232- \fB vlog/set PATTERN:<destination>:<pattern> \fP
232+ \fB vlog/set PATTERN: \fP\fI destination \fP : \fI pattern \fP
233233.sp
234- Sets the log pattern for <destination> to <pattern> . Each time a
235- message is logged to <destination>, <pattern> determines the
236- message’s formatting. Most characters in <pattern> are copied
234+ Sets the log pattern for \fI destination \fP to \fI pattern \fP \& . Each time a
235+ message is logged to \fI destination \fP , \fI pattern \fP determines the
236+ message’s formatting. Most characters in \fI pattern \fP are copied
237237literally to the log, but special escapes beginning with \fB % \fP are
238238expanded as follows:
239239.INDENT 2.0
@@ -253,29 +253,29 @@ the message.
253253.IP \(bu 2
254254\fB %d \fP
255255.sp
256- The current date and time in ISO 8601 format (YYYY \ - MM\- DD HH:MM:SS).
256+ The current date and time in ISO 8601 format (\fB YYYY \ -MM \- DD HH:MM:SS \fP ).
257257.IP \(bu 2
258- \fB %d{<format> } \fP
258+ \fB %d{ \fP\fI format \fP\fB } \fP
259259.sp
260- The current date and time in the specified <format> , which takes
261- the same format as the <template> argument to \fB strftime(3) \fP \& . As
262- an extension, any \fB # \fP characters in <format> will be replaced by
260+ The current date and time in the specified \fI format \fP , which takes
261+ the same format as the \fB template \fP argument to \fB strftime(3) \fP \& . As
262+ an extension, any \fB # \fP characters in \fI format \fP will be replaced by
263263fractional seconds, e.g. use \fB %H:%M:%S.### \fP for the time to the
264264nearest millisecond. Sub\- second times are only approximate and
265265currently decimal places after the third will always be reported
266266as zero.
267267.IP \(bu 2
268268\fB %D \fP
269269.sp
270- The current UTC date and time in ISO 8601 format (YYYY \- MM \- DD
271- HH:MM:SS).
270+ The current UTC date and time in ISO 8601 format
271+ ( \fB YYYY \- MM \- DD HH:MM:SS \fP ).
272272.IP \(bu 2
273- \fB %D{<format> } \fP
273+ \fB %D{ \fP\fI format \fP\fB } \fP
274274.sp
275- The current UTC date and time in the specified <format> , which
276- takes the same format as the <template> argument to
277- \fB strftime \( ga \( ga (3) . Supports the same extension for sub \- second
278- resolution as \( ga \( ga %d{...} \fP \& .
275+ The current UTC date and time in the specified \fI format \fP , which
276+ takes the same format as the \fB template \fP argument to
277+ \fB strftime(3) \fP \& . Supports the same extension for sub\- second
278+ resolution as \fB %d{...} \fP \& .
279279.IP \(bu 2
280280\fB %E \fP
281281.sp
@@ -340,23 +340,24 @@ justification is the default.
340340Pad the field to the field width with \fB 0 \fP characters. Padding
341341with spaces is the default.
342342.IP \(bu 2
343- <width>
343+ \fI width \fP
344344.sp
345345A number specifies the minimum field width. If the escape expands
346- to fewer characters than <width> then it is padded to fill the
347- field width. (A field wider than <width> is not truncated to
346+ to fewer characters than \fI width \fP then it is padded to fill the
347+ field width. (A field wider than \fI width \fP is not truncated to
348348fit.)
349349.UNINDENT
350350.sp
351- The default pattern for console and file output is \fB %D{%Y \- %m \- %dT
352- %H:%M:%SZ}|%05N|%c|%p|%m \fP ; for syslog output, \fB %05N|%c|%p|%m \fP \& .
351+ The default pattern for console and file output is
352+ \fB %D{%Y \- %m \- %dT %H:%M:%SZ}|%05N|%c|%p|%m \fP ; for syslog output,
353+ \fB %05N|%c|%p|%m \fP \& .
353354.sp
354355Daemons written in Python (e.g. \fB ovs \- monitor \- ipsec \fP ) do not allow
355356control over the log pattern.
356357.IP \(bu 2
357- \fB vlog/set FACILITY:<facility> \fP
358+ \fB vlog/set FACILITY: \fP\fI facility \fP
358359.sp
359- Sets the RFC5424 facility of the log message. <facility> can be one
360+ Sets the RFC5424 facility of the log message. \fI facility \fP can be one
360361of \fB kern \fP , \fB user \fP , \fB mail \fP , \fB daemon \fP , \fB auth \fP , \fB syslog \fP ,
361362\fB lpr \fP , \fB news \fP , \fB uucp \fP , \fB clock \fP , \fB ftp \fP , \fB ntp \fP , \fB audit \fP ,
362363\fB alert \fP , \fB clock2 \fP , \fB local0 \fP , \fB local1 \fP , \fB local2 \fP ,
0 commit comments