• <var id="lvoaz"></var>
      1. <output id="lvoaz"></output>
          ovsdb-tool(1)                 Open vSwitch Manual                ovsdb-tool(1)
          
          
          
          NAME
                 ovsdb-tool - Open vSwitch database management utility
          
          SYNOPSIS
                 ovsdb-tool [options] create [db [schema]]
                 ovsdb-tool [options] compact [db [target]]
                 ovsdb-tool [options] convert [db [schema [target]]]
                 ovsdb-tool [options] needs-conversion [db [schema]]
                 ovsdb-tool [options] db-version [db]
                 ovsdb-tool [options] schema-version [schema]
                 ovsdb-tool [options] db-cksum [db]
                 ovsdb-tool [options] schema-cksum [schema]
                 ovsdb-tool [options] query [db] transaction
                 ovsdb-tool [options] transact [db] transaction
                 ovsdb-tool [options] [-m | --more]... show-log [db]
                 ovsdb-tool help
          
                 Logging options:
                        [-v[module[:destination[:level]]]]...
                        [--verbose[=module[:destination[:level]]]]...
                        [--log-file[=file]]
          
                 Common options:
                        [-h | --help] [-V | --version]
          
          
          DESCRIPTION
                 The ovsdb-tool program is a command-line tool for managing Open vSwitch
                 database (OVSDB) files.  It does not  interact  directly  with  running
                 Open vSwitch database servers (instead, use ovsdb-client).
          
             Basic Commands
                 create db schema
                        Reads  an  OVSDB schema from the file named schema and creates a
                        new OVSDB database file named db using  that  schema.   The  new
                        database is initially empty.  This command will not overwrite an
                        existing db.
          
                        schema must contain an OVSDB schema in JSON  format.   Refer  to
                        the OVSDB specification for details.
          
                 compact db [target]
                        Reads  db  and  writes a compacted version.  If target is speci‐
                        fied, the compacted version is written as a new file named  tar
                        get,  which  must not already exist.  If target is omitted, then
                        the compacted version of the database replaces db in-place.
          
                 convert db schema [target]
                        Reads db, translating it into to the schema specified in schema,
                        and  writes out the new interpretation.  If target is specified,
                        the translated version is written as a new  file  named  target,
                        which  must  not  already exist.  If target is omitted, then the
                        translated version of the database replaces db in-place.
          
                        This command can do simple ``upgrades'' and ``downgrades'' on  a
                        database's  schema.   The  data  in db must be valid when inter‐
                        preted under schema, with only one exception:  data  in  db  for
                        tables  and  columns  that  do  not exist in schema are ignored.
                        Columns that exist in schema but not in  db  are  set  to  their
                        default values.  All of schema's constraints apply in full.
          
                 needs-conversion db schema
                        Reads  the  schema  embedded  in db and the standalone schema in
                        schema and compares them.  If the schemas are the  same,  prints
                        no on stdout; if they differ, print yes.
          
                 db-version db
                 schema-version schema
                        Prints  the  version  number  in  the schema embedded within the
                        database db or in the standalone schema  schema  on  stdout.   A
                        schema    version    number    has    the   form   x.y.z.    See
                        ovs-vswitchd.conf.db(5) for details.
          
                        Schema version numbers and  Open  vSwitch  version  numbers  are
                        independent.
          
                        If  schema or db was created before schema versioning was intro‐
                        duced, then it will not have a version number and  this  command
                        will print a blank line.
          
                 db-cksum db
                 schema-cksum schema
                        Prints  the  checksum in the schema embedded within the database
                        db or of the standalone schema schema on stdout.
          
                        If schema or db was created before schema checksums were  intro‐
                        duced,  then  it  will not have a checksum and this command will
                        print a blank line.
          
                 query db transaction
                        Opens db, executes transaction on it, and  prints  the  results.
                        The transaction must be a JSON array in the format of the params
                        array for the JSON-RPC transact  method,  as  described  in  the
                        OVSDB specification.
          
                        The  db  is  opened  for  read-only  access, so this command may
                        safely run concurrently with other database activity,  including
                        ovsdb-server  and  other  database writers.  The transaction may
                        specify database modifications, but these will have no effect on
                        db.
          
                 transact db transaction
                        Opens  db,  executes  transaction on it, prints the results, and
                        commits any changes to db.  The transaction must be a JSON array
                        in  the  format  of  the  params array for the JSON-RPC transact
                        method, as described in the OVSDB specification.
          
                        The db is opened and locked for read/write access, so this  com‐
                        mand  will  fail  if  the  database is opened for writing by any
                        other process, including ovsdb-server(1).  Use  ovsdb-client(1),
                        instead,   to   write   to   a   database   that  is  served  by
                        ovsdb-server(1).
          
                 show-log db
                        Prints a summary of the records in db's log, including the  time
                        and  date at which each database change occurred and any associ‐
                        ated comment.  This may be useful for debugging.
          
                        To increase the verbosity of output, add -m (or --more)  one  or
                        more  times to the command line.  With one -m, show-log prints a
                        summary of the records  added,  deleted,  or  modified  by  each
                        transaction.   With  two -ms, show-log also prints the values of
                        the columns modified by each change to a record.
          
          OPTIONS
             Logging Options
                 -v[spec]
                 --verbose=[spec]
                        Sets logging levels.  Without any spec, sets the log  level  for
                        every  module and destination to dbg.  Otherwise, spec is a list
                        of words separated by spaces or commas or colons, up to one from
                        each category below:
          
                        ·      A  valid  module name, as displayed by the vlog/list com‐
                               mand on ovs-appctl(8), limits the log level change to the
                               specified module.
          
                        ·      syslog,  console,  or file, to limit the log level change
                               to only to the system log, to the console, or to a  file,
                               respectively.   (If  --detach  is  specified,  ovsdb-tool
                               closes its standard file descriptors, so logging  to  the
                               console will have no effect.)
          
                               On  Windows platform, syslog is accepted as a word and is
                               only useful along with the  --syslog-target  option  (the
                               word has no effect otherwise).
          
                        ·      off,  emer,  err,  warn, info, or dbg, to control the log
                               level.  Messages of the given severity or higher will  be
                               logged,  and  messages of lower severity will be filtered
                               out.  off filters out all  messages.   See  ovs-appctl(8)
                               for a definition of each log level.
          
                        Case is not significant within spec.
          
                        Regardless  of  the  log  levels set for file, logging to a file
                        will not take place unless --log-file  is  also  specified  (see
                        below).
          
                        For compatibility with older versions of OVS, any is accepted as
                        a word but has no effect.
          
                 -v
                 --verbose
                        Sets the maximum logging verbosity level, equivalent  to  --ver
                        bose=dbg.
          
                 -vPATTERN:destination:pattern
                 --verbose=PATTERN:destination:pattern
                        Sets  the  log  pattern  for  destination  to pattern.  Refer to
                        ovs-appctl(8) for a description of the valid syntax for pattern.
          
                 -vFACILITY:facility
                 --verbose=FACILITY:facility
                        Sets the RFC5424 facility of the log message.  facility  can  be
                        one  of kern, user, mail, daemon, auth, syslog, lpr, news, uucp,
                        clock, ftp, ntp, audit, alert, clock2, local0,  local1,  local2,
                        local3,  local4, local5, local6 or local7. If this option is not
                        specified, daemon is used as the default for  the  local  system
                        syslog  and local0 is used while sending a message to the target
                        provided via the --syslog-target option.
          
                 --log-file[=file]
                        Enables logging to a file.  If file is  specified,  then  it  is
                        used  as  the exact name for the log file.  The default log file
                        name   used   if   file   is    omitted    is    //var/log/open
                        vswitch/ovsdb-tool.log.
          
                 --syslog-target=host:port
                        Send  syslog  messages  to  UDP port on host, in addition to the
                        system syslog.  The host must be a numerical IP address,  not  a
                        hostname.
          
                 --syslog-method=method
                        Specify method how syslog messages should be sent to syslog dae‐
                        mon.  Following forms are supported:
          
                        ·      libc, use libc syslog() function.  This  is  the  default
                               behavior.   Downside  of  using this options is that libc
                               adds fixed prefix to every message before it is  actually
                               sent  to  the  syslog  daemon  over  /dev/log UNIX domain
                               socket.
          
                        ·      unix:file, use UNIX domain socket directly.  It is possi‐
                               ble to specify arbitrary message format with this option.
                               However, rsyslogd 8.9 and older versions use  hard  coded
                               parser  function  anyway  that  limits UNIX domain socket
                               use.  If you want to use arbitrary  message  format  with
                               older rsyslogd versions, then use UDP socket to localhost
                               IP address instead.
          
                        ·      udp:ip:port, use UDP socket.  With this method it is pos‐
                               sible  to  use  arbitrary  message format also with older
                               rsyslogd.  When sending syslog messages over  UDP  socket
                               extra  precaution  needs  to  be  taken into account, for
                               example, syslog daemon needs to be configured  to  listen
                               on  the  specified  UDP  port,  accidental iptables rules
                               could be interfering with local syslog traffic and  there
                               are  some security considerations that apply to UDP sock‐
                               ets, but do not apply to UNIX domain sockets.
          
             Other Options
                 -h
                 --help Prints a brief help message to the console.
          
                 -V
                 --version
                        Prints version information to the console.
          
          FILES
                 The default db is //etc/openvswitch/conf.db.   The  default  schema  is
                 //share/openvswitch/vswitch.ovsschema.   The help command also displays
                 these defaults.
          
          SEE ALSO
                 ovsdb-server(1), ovsdb-client(1), and the OVSDB specification.
          
          
          
          Open vSwitch                        2.5.90                       ovsdb-tool(1)
          
          现金李逵劈鱼