8 .TH ovsdb\-client 1 "@VERSION@" "Open vSwitch" "Open vSwitch Manual"
9 .\" This program's name:
13 ovsdb\-client \- command-line interface to \fBovsdb-server\fR(1)
16 \fBovsdb\-client \fR[\fIoptions\fR] \fBlist\-dbs \fR[\fIserver\fR]
18 \fBovsdb\-client \fR[\fIoptions\fR] \fBget\-schema \fR[\fIserver\fR] \fR[\fIdatabase\fR]
20 \fBovsdb\-client \fR[\fIoptions\fR] \fBget\-schema\-version\fI \fR[\fIserver\fR] \fR[\fIdatabase\fR]
22 \fBovsdb\-client \fR[\fIoptions\fR] \fBlist\-tables\fI \fR[\fIserver\fR] \fR[\fIdatabase\fR]
24 \fBovsdb\-client \fR[\fIoptions\fR] \fBlist\-columns\fI \fR[\fIserver\fR] \fR[\fIdatabase\fR] [\fItable\fR]
26 \fBovsdb\-client \fR[\fIoptions\fR] \fBtransact\fI \fR[\fIserver\fR] \fItransaction\fR
28 \fBovsdb\-client \fR[\fIoptions\fR] \fBdump\fI \fR[\fIserver\fR] \fR[\fIdatabase\fR]\fR
30 \fBovsdb\-client \fR[\fIoptions\fR] \fBmonitor\fI \fR[\fIserver\fR] \fR[\fIdatabase\fR] \fItable\fR
31 [\fIcolumn\fR[\fB,\fIcolumn\fR]...]...
33 \fBovsdb\-client \fR[\fIoptions\fR] \fBmonitor\fI \fR[\fIserver\fR] \fR[\fIdatabase\fR] \fBALL\fR
35 \fBovsdb\-client help\fR
36 .IP "Output formatting options:"
37 [\fB\-\-format=\fIformat\fR]
38 [\fB\-\-data=\fIformat\fR]
39 [\fB\-\-no-heading\fR]
42 [\fB\-\-no\-heading\fR]
44 .so lib/daemon-syn.man
47 .so lib/ssl-bootstrap-syn.man
48 .so lib/common-syn.man
51 The \fBovsdb\-client\fR program is a command-line client for
52 interacting with a running \fBovsdb\-server\fR process.
53 Each command connects to an OVSDB server, which is
54 \fBunix:@RUNDIR@/db.sock\fR by default, or may be specified as
55 \fIserver\fR in one of the following forms:
57 .so ovsdb/remote-active.man
58 .so ovsdb/remote-passive.man
61 The default \fIdatabase\fR is \fBOpen_vSwitch\fR.
64 The following commands are implemented:
65 .IP "\fBlist\-dbs \fR[\fIserver\fR]"
66 Connects to \fIserver\fR, retrieves the list of known databases, and
67 prints them one per line. These database names are the ones that may
68 be used for \fIdatabase\fR in the following commands.
70 .IP "\fBget\-schema \fR[\fIserver\fR] \fR[\fIdatabase\fR]"
71 Connects to \fIserver\fR, retrieves the schema for \fIdatabase\fR, and
72 prints it in JSON format.
74 .IP "\fBget\-schema\-version\fI \fR[\fIserver\fR] \fR[\fIdatabase\fR]"
75 Connects to \fIserver\fR, retrieves the schema for \fIdatabase\fR, and
76 prints its version number on stdout. A schema version number has the form
77 \fIx\fB.\fIy\fB.\fIz\fR. See \fBovs\-vswitchd.conf.db\fR(5) for
80 Schema version numbers and Open vSwitch version numbers are
83 If \fIdatabase\fR was created before schema versioning was introduced,
84 then it will not have a version number and this command will print a
87 .IP "\fBlist\-tables\fI \fR[\fIserver\fR] \fR[\fIdatabase\fR]"
88 Connects to \fIserver\fR, retrieves the schema for \fIdatabase\fR, and
89 prints a table listing the name of each table
92 .IP "\fBlist\-columns\fI \fR[\fIserver\fR] \fR[\fIdatabase\fR] \fItable\fR"
93 Connects to \fIserver\fR, retrieves the schema for \fIdatabase\fR, and
94 prints a table listing the name and type of each
95 column. If \fItable\fR is specified, only columns in that table are
96 listed; otherwise, the tables include columns in all tables.
98 .IP "\fBtransact\fI \fR[\fIserver\fR] \fItransaction\fR"
99 Connects to \fIserver\fR, sends it the specified \fItransaction\fR,
100 which must be a JSON array containing one or more valid OVSDB
101 operations, and prints the received reply on stdout.
103 .IP "\fBdump\fI \fR[\fIserver\fR] \fR[\fIdatabase\fR]\fR"
104 Connects to \fIserver\fR, retrieves all of the data in \fIdatabase\fR,
105 and prints it on stdout as a series of tables.
107 .IP "\fBmonitor\fI \fR[\fIserver\fR] \fR[\fIdatabase\fR] \fItable\fR [\fIcolumn\fR[\fB,\fIcolumn\fR]...]..."
108 Connects to \fIserver\fR and monitors the contents of \fItable\fR in
109 \fIdatabase\fR. By default, the initial contents of \fItable\fR are
110 printed, followed by each change as it occurs. If at least one
111 \fIcolumn\fR is specified, only those columns are monitored. The
112 following \fIcolumn\fR names have special meanings:
115 Do not print the initial contents of the specified columns.
117 Do not print newly inserted rows.
119 Do not print deleted rows.
121 Do not print modifications to existing rows.
124 Multiple [\fIcolumn\fR[\fB,\fIcolumn\fR]...] groups may be specified
125 as separate arguments, e.g. to apply different reporting parameters to
126 each group. Whether multiple groups or only a single group is
127 specified, any given column may only be mentioned once on the command
130 If \fB\-\-detach\fR is used with \fBmonitor\fR, then \fBovsdb\-client\fR
131 detaches after it has successfully received and printed the initial
132 contents of \fItable\fR.
134 .IP "\fBmonitor\fI \fR[\fIserver\fR] \fR[\fIdatabase\fR] \fBALL\fR"
135 Connects to \fIserver\fR and monitors the contents of all tables in
136 \fIdatabase\fR. Prints initial values and all kinds of changes to all
137 columns in the database. The \fB\-\-detach\fR option causes
138 \fBovsdb\-client\fR to detach after it successfully receives and
139 prints the initial database contents.
142 .SS "Output Formatting Options"
143 Much of the output from \fBovsdb\-client\fR is in the form of tables.
144 The following options controlling output formatting:
149 .IP "\fB\-\-timestamp\fR"
150 For the \fBmonitor\fR command, adds a timestamp to each table
151 update. Most output formats add the timestamp on a line of its own
152 just above the table. The JSON output format puts the timestamp in a
153 member of the top-level JSON object named \fBtime\fR.
156 The daemon options apply only to the \fBmonitor\fR command. With any
157 other command, they have no effect.
160 .SS "Logging Options"
162 .SS "Public Key Infrastructure Options"
164 .so lib/ssl-bootstrap.man
169 \fBovsdb\-server\fR(1),
170 \fBovsdb\-client\fR(1),
171 and the OVSDB specification.