]>
Commit | Line | Data |
---|---|---|
e7019d99 QM |
1 | .IP "\fB\-\-color\fR[\fB=\fR\fIwhen\fR] |
2 | . | |
3 | Colorize the output (for some commands); \fIwhen\fR can be \fBnever\fR, | |
4 | \fBalways\fR, or \fBauto\fR (the default). | |
5 | . | |
6 | .RS | |
7 | .PP | |
8 | Only some commands support output coloring. Color names and default | |
9 | colors may change in future releases. | |
10 | .PP | |
11 | The environment variable \fBOVS_COLORS\fR can be used to specify user-defined | |
12 | colors and other attributes used to highlight various parts of the output. If | |
13 | set, its value is a colon-separated list of capabilities that defaults to | |
14 | \fBac:01;31:dr=34:le=31:pm=36:pr=35:sp=33:vl=32\fR. Supported capabilities were | |
15 | initially designed for coloring flows from \fBovs-ofctl dump-flows\fR | |
16 | \fIswitch\fR command, and they are as follows. | |
17 | .RS | |
18 | .TP | |
19 | \fBac=01;31\fR | |
20 | SGR substring for \fBactions=\fR keyword in a flow. | |
21 | The default is a bold red text foreground. | |
22 | .TP | |
23 | \fBdr=34\fR | |
24 | SGR substring for \fBdrop\fR keyword. | |
25 | The default is a dark blue text foreground. | |
26 | .TP | |
27 | \fBle=31\fR | |
28 | SGR substring for \fBlearn=\fR keyword in a flow. | |
29 | The default is a red text foreground. | |
30 | .TP | |
31 | \fBpm=36\fR | |
32 | SGR substring for flow match attribute names. | |
33 | The default is a cyan text foreground. | |
34 | .TP | |
35 | \fBpr=35\fR | |
36 | SGR substring for keywords in a flow that are followed by arguments inside | |
37 | parenthesis. | |
38 | The default is a magenta text foreground. | |
39 | .TP | |
40 | \fBsp=33\fR | |
41 | SGR substring for some special keywords in a flow, notably: \fBtable=\fR, | |
42 | \fBpriority=\fR, \fBload:\fR, \fBoutput:\fR, \fBmove:\fR, \fBgroup:\fR, | |
43 | \fBCONTROLLER:\fR, \fBset_field:\fR, \fBresubmit:\fR, \fBexit\fR. | |
44 | The default is a yellow text foreground. | |
45 | .TP | |
46 | \fBvl=32\fR | |
47 | SGR substring for a lone flow match attribute with no field name. | |
48 | The default is a green text foreground. | |
49 | .RE | |
50 | .PP | |
51 | See the Select Graphic Rendition (SGR) section in the documentation of the text | |
52 | terminal that is used for permitted values and their meaning as character | |
53 | attributes. | |
54 | .RE |