ovn/utilities/ovn-nbctl.8.xml

   1 <?xml version="1.0" encoding="utf-8"?>
   2 <manpage program="ovn-nbctl" section="8" title="ovn-nbctl">
   3     <h1>Name</h1>
   4     <p>ovn-nbctl -- Open Virtual Network northbound db management utility</p>
   5
   6     <h1>Synopsys</h1>
   7     <p><code>ovn-nbctl</code> [<var>options</var>] <var>command</var> [<var>arg</var>...]</p>
   8
   9     <h1>Description</h1>
  10     <p>This utility can be used to manage the OVN northbound database.</p>
  11
  12     <h1>General Commands</h1>
  13
  14     <dl>
  15       <dt><code>show [<var>lswitch</var>]</code></dt>
  16       <dd>
  17         Prints a brief overview of the database contents.  If
  18         <var>lswitch</var> is provided, only records related to that
  19         logical switch are shown.
  20       </dd>
  21     </dl>
  22
  23     <h1>Logical Switch Commands</h1>
  24
  25     <dl>
  26       <dt><code>lswitch-add</code> [<var>lswitch</var>]</dt> <dd> Creates a new logical switch named <var>lswitch</var>.  If
  27         <var>lswitch</var> is not provided, the switch will not have a
  28         name so other commands must refer to this switch by its UUID.
  29         Initially the switch will have no ports.
  30       </dd>
  31
  32       <dt><code>lswitch-del</code> <var>lswitch</var></dt>
  33       <dd>
  34         Deletes <var>lswitch</var>.
  35       </dd>
  36
  37       <dt><code>lswitch-list</code></dt>
  38       <dd>
  39         Lists all existing switches on standard output, one per line.
  40       </dd>
  41     </dl>
  42
  43     <h1>ACL Commands</h1>
  44     <dl>
  45       <dt>[<code>--log</code>] <code>acl-add</code> <var>lswitch</var> <var>direction</var> <var>priority</var> <var>match</var> <var>action</var></dt>
  46       <dd>
  47         Adds the specified ACL to <var>lswitch</var>.
  48         <var>direction</var> must be either <code>from-lport</code> or
  49         <code>to-lport</code>.  <var>priority</var> must be between
  50         <code>1</code> and <code>65534</code>, inclusive.  If
  51         <code>--log</code> is specified, packet logging is enabled for the
  52         ACL.  A full description of the fields are in <code>ovn-nb</code>(5).
  53       </dd>
  54
  55       <dt><code>acl-del</code> <var>lswitch</var> [<var>direction</var> [<var>priority</var> <var>match</var>]]</dt>
  56       <dd>
  57         Deletes ACLs from <var>lswitch</var>.  If only
  58         <var>lswitch</var> is supplied, all the ACLs from the logical
  59         switch are deleted.  If <var>direction</var> is also specified,
  60         then all the flows in that direction will be deleted from the
  61         logical switch.  If all the fields are given, then a single flow
  62         that matches all the fields will be deleted.
  63       </dd>
  64
  65       <dt><code>acl-list</code> <var>lswitch</var></dt>
  66       <dd>
  67         Lists the ACLs on <var>lswitch</var>.
  68       </dd>
  69     </dl>
  70
  71     <h1>Logical Port Commands</h1>
  72     <dl>
  73       <dt><code>lport-add</code> <var>lswitch</var> <var>lport</var></dt>
  74       <dd>
  75         Creates on <var>lswitch</var> a new logical port named
  76         <var>lport</var>.
  77       </dd>
  78
  79       <dt><code>lport-add</code> <var>lswitch</var> <var>lport</var> <var>parent</var> <var>tag</var></dt>
  80       <dd>
  81         Creates on <var>lswitch</var> a logical port named <var>lport</var>
  82         that is a child of <var>parent</var> that is identifed with VLAN ID
  83         <var>tag</var>.  This is useful in cases such as virtualized
  84         container environments where Open vSwitch does not have a direct
  85         connection to the container's port and it must be shared with
  86         the virtual machine's port.
  87       </dd>
  88
  89       <dt><code>lport-del</code> <var>lport</var></dt>
  90       <dd>
  91         Deletes <var>lport</var>.
  92       </dd>
  93
  94       <dt><code>lport-list</code> <var>lswitch</var></dt>
  95       <dd>
  96         Lists all the logical ports within <var>lswitch</var> on
  97         standard output, one per line.
  98       </dd>
  99
 100       <dt><code>lport-get-parent</code> <var>lport</var></dt>
 101       <dd>
 102         If set, get the parent port of <var>lport</var>.  If not set, print
 103         nothing.
 104       </dd>
 105
 106       <dt><code>lport-get-tag</code> <var>lport</var></dt>
 107       <dd>
 108         If set, get the tag for <var>lport</var> traffic.  If not set, print
 109         nothing.
 110       </dd>
 111
 112       <dt><code>lport-set-macs</code> <var>lport</var> [<var>mac</var>]...</dt>
 113       <dd>
 114         Sets the MACs associated with <var>lport</var> to
 115         <var>mac</var>.  Multiple MACs may be sets by using multiple
 116         <var>mac</var> arguments.  If no <var>mac</var> argument is
 117         given, <var>lport</var> will have no MACs associated with it.
 118       </dd>
 119
 120       <dt><code>lport-get-macs</code> <var>lport</var></dt>
 121       <dd>
 122         Lists all the MACs associated with <var>lport</var> on standard
 123         output, one per line.
 124       </dd>
 125
 126       <dt><code>lport-set-port-security</code> <var>lport</var> [<var>addrs</var>]...</dt>
 127       <dd>
 128         <p>
 129           Sets the port security addresses associated with <var>lport</var> to
 130           <var>addrs</var>.  Multiple sets of addresses may be set by using
 131           multiple <var>addrs</var> arguments.  If no <var>addrs</var> argument
 132           is given, <var>lport</var> will not have port security enabled.
 133         </p>
 134
 135         <p>
 136           Port security limits the addresses from which a logical port may send
 137           packets and to which it may receive packets.  See the
 138           <code>ovn-nb</code>(5) documentation for the <ref
 139           column="port_security" table="Logical_Port"/> column in the <ref
 140           table="Logical_Port"/> table for details.
 141         </p>
 142       </dd>
 143
 144       <dt><code>lport-get-port-security</code> <var>lport</var></dt>
 145       <dd>
 146         Lists all the port security addresses associated with <var>lport</var>
 147         on standard output, one per line.
 148       </dd>
 149
 150       <dt><code>lport-get-up</code> <var>lport</var></dt>
 151       <dd>
 152         Prints the state of <var>lport</var>, either <code>up</code> or
 153         <code>down</code>.
 154       </dd>
 155
 156       <dt><code>lport-set-enabled</code> <var>lport</var> <var>state</var></dt>
 157       <dd>
 158         Set the administrative state of <var>lport</var>, either <code>enabled</code>
 159         or <code>disabled</code>.  When a port is disabled, no traffic is allowed into
 160         or out of the port.
 161       </dd>
 162
 163       <dt><code>lport-get-enabled</code> <var>lport</var></dt>
 164       <dd>
 165         Prints the administrative state of <var>lport</var>, either <code>enabled</code>
 166         or <code>disabled</code>.
 167       </dd>
 168
 169       <dt><code>lport-set-type</code> <var>lport</var> <var>type</var></dt>
 170       <dd>
 171         Set the type for the logical port.  No special types have been implemented yet.
 172       </dd>
 173
 174       <dt><code>lport-get-type</code> <var>lport</var></dt>
 175       <dd>
 176         Get the type for the logical port.
 177       </dd>
 178
 179       <dt><code>lport-set-options</code> <var>lport</var> [<var>key=value</var>]...</dt>
 180       <dd>
 181         Set type-specific key-value options for the logical port.
 182       </dd>
 183
 184       <dt><code>lport-get-options</code> <var>lport</var></dt>
 185       <dd>
 186         Get the type-specific options for the logical port.
 187       </dd>
 188
 189     </dl>
 190
 191     <h1>Options</h1>
 192
 193     <dl>
 194     <dt><code>--db</code> <var>database</var></dt>
 195     <dd>
 196       The OVSDB database remote to contact.  If the <env>OVN_NB_DB</env>
 197       environment variable is set, its value is used as the default.
 198       Otherwise, the default is <code>unix:@RUNDIR@/db.sock</code>, but this
 199       default is unlikely to be useful outside of single-machine OVN test
 200       environments.
 201     </dd>
 202
 203     <dt><code>-h</code> | <code>--help</code></dt>
 204     <dt><code>-o</code> | <code>--options</code></dt>
 205     <dt><code>-V</code> | <code>--version</code></dt>
 206     </dl>
 207
 208     <h1>Logging options</h1>
 209     <dl>
 210     <dt><code>-v</code><var>spec</var>, <code>--verbose=</code><var>spec</var></dt>
 211     <dt><code>-v</code>, <code>--verbose</code></dt>
 212     <dt><code>--log-file</code>[<code>=</code><var>file</var>]</dt>
 213     <dt><code>--syslog-target=</code><var>host</var><code>:</code><var>port</var></dt>
 214     </dl>
 215
 216     <h1>PKI configuration (required to use SSL)</h1>
 217     <dl>
 218     <dt><code>-p</code>, <code>--private-key=</code><var>file</var>  file with private key</dt>
 219     <dt><code>-c</code>, <code>--certificate=</code><var>file</var>  file with certificate for private key</dt>
 220     <dt><code>-C</code>, <code>--ca-cert=</code><var>file</var>      file with peer CA certificate</dt>
 221     </dl>
 222
 223 </manpage>