X-Git-Url: https://pintos-os.org/cgi-bin/gitweb.cgi?a=blobdiff_plain;f=ovsdb%2Fovsdb-tool.1.in;h=069ab1a4da06141294cab7a61fd7ab15016fbb75;hb=e20d7fc6504493b9b0654e1b8272a9d21dfdfbb9;hp=c2c2ce32d7452d9ca0cafb58ef004bc5e2953890;hpb=a0bc29a541fc7dc6e20137d5558e2094d614e6ab;p=openvswitch diff --git a/ovsdb/ovsdb-tool.1.in b/ovsdb/ovsdb-tool.1.in index c2c2ce32..069ab1a4 100644 --- a/ovsdb/ovsdb-tool.1.in +++ b/ovsdb/ovsdb-tool.1.in @@ -14,11 +14,20 @@ ovsdb\-tool \- Open vSwitch database management utility .SH SYNOPSIS \fBovsdb\-tool \fR[\fIoptions\fR] \fBcreate\fI db schema\fR .br +\fBovsdb\-tool \fR[\fIoptions\fR] \fBcompact \fIdb \fR[\fItarget\fR] +.br +\fBovsdb\-tool \fR[\fIoptions\fR] \fBconvert\fI db schema +\fR[\fItarget\fR] +.br +\fBovsdb\-tool \fR[\fIoptions\fR] \fBdb\-version\fI db\fR +.br +\fBovsdb\-tool \fR[\fIoptions\fR] \fBschema\-version\fI schema\fR +.br \fBovsdb\-tool \fR[\fIoptions\fR] \fBquery\fI db transaction\fR .br \fBovsdb\-tool \fR[\fIoptions\fR] \fBtransact\fI db transaction\fR .br -\fBovsdb\-tool \fR[\fIoptions\fR] [\fB-m\fR | \fB--more\fR]... \fBshow\-log\fI db\fR +\fBovsdb\-tool \fR[\fIoptions\fR] [\fB\-m\fR | \fB\-\-more\fR]... \fBshow\-log\fI db\fR .br \fBovsdb\-tool help\fR .so lib/vlog-syn.man @@ -63,6 +72,26 @@ ignored. Columns that exist in \fIschema\fR but not in \fIdb\fR are set to their default values. All of \fIschema\fR's constraints apply in full. . +.IP "\fBdb\-version\fI db\fR" +Reads \fIdb\fR and prints the version number of the schema embedded +within the database on stdout. A schema version number has the form +\fIx\fB.\fIy\fB.\fIz\fR. See \fBovs\-vswitchd.conf.db\fR(5) for +details. +.IP +Schema version numbers and Open vSwitch version numbers are +independent. +.IP +If \fIdb\fR was created before schema versioning was introduced, then +it will not have a version number and this command will print a blank +line. +. +.IP "\fBschema\-version\fI schema\fR" +Reads \fIschema\fR and prints the schema's version number on stdout. +.IP +If \fIschema\fR was created before versioning was introduced, then it +does not have a version number and this command will print a blank +line. +. .IP "\fBquery\fI db transaction\fR" Opens \fIdb\fR, executes \fItransaction\fR on it, and prints the results. The \fItransaction\fR must be a JSON array in the format of @@ -71,7 +100,7 @@ described in the OVSDB specification. .IP The \fIdb\fR is opened for read-only access, so this command may safely run concurrently with other database activity, including -\fBovsdb-server\fR and other database writers. The \fItransaction\fR +\fBovsdb\-server\fR and other database writers. The \fItransaction\fR may specify database modifications, but these will have no effect on \fIdb\fR. . @@ -83,19 +112,19 @@ JSON array in the format of the \fBparams\fR array for the JSON-RPC .IP The \fIdb\fR is opened and locked for read/write access, so this command will fail if the database is opened for writing by any other -process, including \fBovsdb-server\fR(1). Use \fBovsdb\-client\fR(1), +process, including \fBovsdb\-server\fR(1). Use \fBovsdb\-client\fR(1), instead, to write to a database that is served by -\fBovsdb-server\fR(1). +\fBovsdb\-server\fR(1). . -.IP "\fBshow-log\fI db\fR" +.IP "\fBshow\-log\fI db\fR" Prints a summary of the records in \fBdb\fR's log, including the time and date at which each database change occurred and any associated comment. This may be useful for debugging. .PP -To increase the verbosity of output, add \fB-m\fR (or \fB--more\fR) -one or more times to the command line. With one \fB-m\fR, +To increase the verbosity of output, add \fB\-m\fR (or \fB\-\-more\fR) +one or more times to the command line. With one \fB\-m\fR, \fBshow\-log\fR prints a summary of the records added, deleted, or -modified by each transaction. With two \fB-m\fRs, \fBshow\-log\fR +modified by each transaction. With two \fB\-m\fRs, \fBshow\-log\fR also prints the values of the columns modified by each change to a record. .