X-Git-Url: https://pintos-os.org/cgi-bin/gitweb.cgi?a=blobdiff_plain;f=ovsdb%2Fovsdb-client.1.in;h=7607157339d52315dd2a54767a805239ae49a8b6;hb=a4230dedddd1909f84947b9c6cdf88a23e10a301;hp=716fcc2e338a790c1f95bca99b5df492b0cf6a3d;hpb=9467fe624698a9b72f81bb1ddfce33a5fc85281c;p=openvswitch diff --git a/ovsdb/ovsdb-client.1.in b/ovsdb/ovsdb-client.1.in index 716fcc2e..76071573 100644 --- a/ovsdb/ovsdb-client.1.in +++ b/ovsdb/ovsdb-client.1.in @@ -12,22 +12,25 @@ ovsdb\-client \- command-line interface to \fBovsdb-server\fR(1) . .SH SYNOPSIS -\fBovsdb\-client \fR[\fIoptions\fR] \fBget-schema\fI server\fR +\fBovsdb\-client \fR[\fIoptions\fR] \fBlist\-dbs\fI server\fR .br -\fBovsdb\-client \fR[\fIoptions\fR] \fBlist-tables\fI server\fR +\fBovsdb\-client \fR[\fIoptions\fR] \fBget-schema\fI server database\fR .br -\fBovsdb\-client \fR[\fIoptions\fR] \fBlist-columns\fI server \fR[\fItable\fR] +\fBovsdb\-client \fR[\fIoptions\fR] \fBlist-tables\fI server database\fR +.br +\fBovsdb\-client \fR[\fIoptions\fR] \fBlist-columns\fI server database \fR[\fItable\fR] .br \fBovsdb\-client \fR[\fIoptions\fR] \fBtransact\fI server transaction\fR .br -\fBovsdb\-client \fR[\fIoptions\fR] \fBmonitor\fI server table\fR +\fBovsdb\-client \fR[\fIoptions\fR] \fBdump\fI server database\fR +.br +\fBovsdb\-client \fR[\fIoptions\fR] \fBmonitor\fI server database table\fR [\fIcolumn\fR[\fB,\fIcolumn\fR]...] [\fIselect\fR[\fB,\fIselect\fR]...] .br \fBovsdb\-client help\fR .IP "Output formatting options:" [\fB--format=\fIformat\fR] -[\fB--wide\fR] [\fB--no-heading\fR] .so lib/daemon-syn.man .so lib/vlog-syn.man @@ -47,32 +50,41 @@ the following forms: . .SS "Commands" The following commands are implemented: -.IP "\fBget-schema\fI server\fR" -Connects to \fIserver\fR, retrieves the database schema, and prints it -in JSON format. +.IP "\fBlist-dbs\fI server\fR" +Connects to \fIserver\fR, retrieves the list of known databases, and +prints them one per line. These database names are the ones that may +be used for \fIdatabase\fR in the following commands. +. +.IP "\fBget-schema\fI server database\fR" +Connects to \fIserver\fR, retrieves the schema for \fIdatabase\fR, and +prints it in JSON format. . -.IP "\fBlist-tables\fI server\fR" -Connects to \fIserver\fR, retrieves the database schema, and prints -a table listing the names and comments (if any) on each table within -the database. +.IP "\fBlist-tables\fI server database\fR" +Connects to \fIserver\fR, retrieves the schema for \fIdatabase\fR, and +prints a table listing the name of each table +within the database. . -.IP "\fBlist-columns\fI server \fR[\fItable\fR]" -Connects to \fIserver\fR, retrieves the database schema, and prints -a table listing the names, type, and comment (if any) on each column. If -\fItable\fR is specified, only columns in that table are listed; -otherwise, the tables include columns in all tables. +.IP "\fBlist-columns\fI server database \fR[\fItable\fR]" +Connects to \fIserver\fR, retrieves the schema for \fIdatabase\fR, and +prints a table listing the name and type of each +column. If \fItable\fR is specified, only columns in that table are +listed; otherwise, the tables include columns in all tables. . .IP "\fBtransact\fI server transaction\fR" Connects to \fIserver\fR, sends it the specified \fItransaction\fR, which must be a JSON array containing one or more valid OVSDB operations, and prints the received reply on stdout. . -.IP "\fBmonitor\fI server table\fR [\fIcolumn\fR[\fB,\fIcolumn\fR]...] [\fIselect\fR[\fB,\fIselect\fR]...]" -Connects to \fIserver\fR and monitors the contents of \fItable\fR. By -default, the initial contents of \fItable\fR are printed, followed by -each change as it occurs. If at least one \fIcolumn\fR is specified, -only those columns are monitored. If at least one \fIselect\fR is -specified, they are interpreted as follows: +.IP "\fBdump\fI server database\fR" +Connects to \fIserver\fR, retrieves all of the data in \fIdatabase\fR, +and prints it on stdout as a series of tables. +. +.IP "\fBmonitor\fI server database table\fR [\fIcolumn\fR[\fB,\fIcolumn\fR]...] [\fIselect\fR[\fB,\fIselect\fR]...]" +Connects to \fIserver\fR and monitors the contents of \fItable\fR in +\fIdatabase\fR. By default, the initial contents of \fItable\fR are +printed, followed by each change as it occurs. If at least one +\fIcolumn\fR is specified, only those columns are monitored. If at +least one \fIselect\fR is specified, they are interpreted as follows: .RS .IP "\fBinitial\fR" Print the initial contents of the specified columns. @@ -94,7 +106,7 @@ The following options controlling output formatting: . .IP "\fB-f \fIformat\fR" .IQ "\fB--format=\fIformat\fR" -Sets the basic type of output formatting. The following types of +Sets the type of table formatting. The following types of \fIformat\fR are available: .RS .IP "\fBtable\fR (default)" @@ -105,10 +117,16 @@ HTML tables. Comma-separated values as defined in RFC 4180. .RE . -.IP "\fB--wide\fR" -In \fBtable\fR output (the default), when standard output is a -terminal device, by default lines are truncated at a width of 79 -characters. Specifying this option prevents line truncation. +.IP "\fB-d \fIformat\fR" +.IP "\fB--data=\fIformat\fR" +Sets the formatting for cells within output tables. The following +types of \fIformat\fR are available: +.RS +.IP "\fBstring\fR (default)" +The simple format described in \fBovs-vsctl\fR(8). +.IP "\fBjson\fR" +JSON. +.RE . .IP "\fB--no-heading\fR" This option suppresses the heading row that otherwise appears in the @@ -129,6 +147,7 @@ other command, they have no effect. .so lib/daemon.man .SS "Logging Options" .so lib/vlog.man +.SS "Public Key Infrastructure Options" .so lib/ssl.man .so lib/ssl-bootstrap.man .SS "Other Options"