vswitchd/vswitch-idl.ovsidl

   1 //
   2 // This is an ovsdb-idl schema.  The OVSDB IDL compiler, ovsdb-idlc,
   3 // can translate it into an OVSDB schema (which simply entails
   4 // deleting some members from the schema) or C headers or source for
   5 // use with the IDL at runtime.
   6 //
   7
   8 {"name": "ovs_vswitchd_db",
   9  "comment": "Configuration for one Open vSwitch daemon.",
  10  "idlPrefix": "ovsrec_",
  11  "idlHeader": "\"vswitchd/vswitch-idl.h\"",
  12  "tables": {
  13    "Open_vSwitch": {
  14      "comment": "Configuration for an Open vSwitch daemon.",
  15      "columns": {
  16        "bridges": {
  17          "comment": "Set of bridges managed by the daemon.",
  18          "type": {"key": "uuid", "keyRefTable": "Bridge",
  19                   "min": 0, "max": "unlimited"}},
  20        "management_id": {
  21          "comment": "Exactly 12 hex digits that identify the daemon.",
  22          "type": "string"},
  23        "controller": {
  24          "comment": "Default Controller used by bridges.",
  25          "type": {"key": "uuid", "keyRefTable": "Controller", "min": 0, "max": 1}},
  26        "ssl": {
  27          "comment": "SSL used globally by the daemon.",
  28          "type": {"key": "uuid", "keyRefTable": "SSL", "min": 0, "max": 1}}}},
  29    "Bridge": {
  30      "comment": "Configuration for a bridge within an Open_vSwitch.",
  31      "columns": {
  32        "name": {
  33          "comment": "Bridge identifier.  Should be alphanumeric and no more than about 8 bytes long.  Must be unique among the names of ports, interfaces, and bridges on a host.",
  34          "type": "string"},
  35        "datapath_id": {
  36          "comment": "OpenFlow datapath ID.  Exactly 12 hex digits.",
  37          "type": {"key": "string", "min": 0, "max": 1}},
  38        "hwaddr": {
  39          "comment": "Ethernet address to use for bridge.  Exactly 12 hex digits in the form XX:XX:XX:XX:XX:XX.",
  40          "type": {"key": "string", "min": 0, "max": 1}},
  41        "ports": {
  42          "comment": "Ports included in the bridge.",
  43          "type": {"key": "uuid", "keyRefTable": "Port", "min": 0, "max": "unlimited"}},
  44        "mirrors": {
  45          "comment": "Port mirroring configuration.",
  46          "type": {"key": "uuid", "keyRefTable": "Mirror", "min": 0, "max": "unlimited"}},
  47        "netflow": {
  48          "comment": "NetFlow configuration.",
  49          "type": {"key": "uuid", "keyRefTable": "NetFlow", "min": 0, "max": 1}},
  50        "controller": {
  51          "comment": "OpenFlow controller.  If unset, defaults to that specified by the parent Open_vSwitch.",
  52          "type": {"key": "uuid", "keyRefTable": "Controller", "min": 0, "max": 1}}}},
  53    "Port": {
  54      "comment": "A port within a Bridge.  May contain a single Interface or multiple (bonded) Interfaces.",
  55      "columns": {
  56        "name": {
  57          "comment": "Port name.  Should be alphanumeric and no more than about 8 bytes long.    May be the same as the interface name, for non-bonded ports.  Must otherwise be unique among the names of ports, interfaces, and bridges on a host.",
  58          "type": "string"},
  59        "interfaces": {
  60          "comment": "The Port's Interfaces.  If there is more than one, this is a bonded Port.",
  61          "type": {"key": "uuid", "keyRefTable": "Interface", "min": 1, "max": "unlimited"}},
  62        "trunks": {
  63          "comment": "The 802.1Q VLAN(s) that this port trunks.  Should be empty if this port trunks all VLAN(s) or if this is not a trunk port.",
  64          "type": {"key": "integer", "min": 0, "max": 4096}},
  65        "tag": {
  66          "comment": "This port's implicitly tagged VLAN.  Should be empty if this is a trunk port.",
  67          "type": {"key": "integer", "min": 0, "max": 1}},
  68        "mac": {
  69          "comment": "The MAC address to use for this port for the purpose of choosing the bridge's MAC address.  This column does not necessarily reflect the port's actual MAC address, nor will setting it change the port's actual MAC address.  Exactly 12 hex digits in the form XX:XX:XX:XX:XX:XX.",
  70          "type": {"key": "string", "min": 0, "max": 1}},
  71        "bond_updelay": {
  72          "comment": "For a bonded port, the number of milliseconds for which carrier must stay up on an interface before the interface is considered to be up.  Ignored for non-bonded ports.",
  73          "type": "integer"},
  74        "bond_downdelay": {
  75          "comment": "For a bonded port, the number of milliseconds for which carrier must stay down on an interface before the interface is considered to be down.  Ignored for non-bonded ports.",
  76          "type": "integer"},
  77        "bond_fake_iface": {
  78          "comment": "For a bonded port, whether to create a fake interface with the name of the port.  Use only for compatibility with legacy software that requires this.",
  79          "type": "boolean"}}},
  80    "Interface": {
  81      "comment": "An interface within a Port.",
  82      "columns": {
  83        "name": {
  84          "comment": "Interface name.  Should be alphanumeric and no more than about 8 bytes long.  May be the same as the port name, for non-bonded ports.  Must otherwise be unique among the names of ports, interfaces, and bridges on a host.",
  85          "type": "string"},
  86        "type": {
  87          "comment": "The interface type.  Normal network devices, e.g.  eth0, have type \"system\" or \"\" (which are synonyms).  Internal ports have type \"internal\".  TUN/TAP devices have type \"tap\".  GRE devices have type \"gre\".",
  88          "type": "string"},
  89        "options": {
  90          "comment": "Configuration options whose interpretation varies based on \"type\".",
  91          "type": {"key": "string", "value": "string", "min": 0, "max": "unlimited"}},
  92        "internal": {
  93          "comment": "An \"internal\" port is one that is implemented in software as a logical device.",
  94          "type": "boolean"},
  95        "ingress_policing_rate": {
  96          "comment": "Maximum rate for data received on this interface, in kbps.  Set to 0 to disable policing.",
  97          "type": "integer"},
  98        "ingress_policing_burst": {
  99          "comment": "Maximum burst size for data received on this interface, in kb.  The default burst size if set to 0 is 10 kb.",
 100          "type": "integer"},
 101        "mac": {
 102          "comment": "Ethernet address to set for this interface.  If unset then the default MAC address is used.  May not be supported on all interfaces.  Exactly 12 hex digits in the form XX:XX:XX:XX:XX:XX.",
 103          "type": {"key": "string", "min": 0, "max": 1}},
 104        "id": {
 105          "comment": "Foreign key for use by NOX.  (This might end up being absorbed into a more general-purpose \"foreign-keys\" column.)",
 106          "type": {"key": "uuid", "min": 0, "max": 1}}}},
 107    "Mirror": {
 108      "comment": "A port mirror within a Bridge.",
 109      "columns": {
 110        "name": {
 111          "comment": "Arbitrary identifier for the Mirror.",
 112          "type": "string"},
 113        "select_src_port": {
 114          "comment": "Ports on which arriving packets are selected for mirroring.",
 115          "type": {"key": "uuid", "keyRefTable": "Port", "min": 0, "max": "unlimited"}},
 116        "select_dst_port": {
 117          "comment": "Ports on which departing packets are selected for mirroring.",
 118          "type": {"key": "uuid", "keyRefTable": "Port", "min": 0, "max": "unlimited"}},
 119        "select_vlan": {
 120          "comment": "VLANs on which packets are selected for mirroring.",
 121          "type": {"key": "integer", "min": 0, "max": 4096}},
 122        "output_port": {
 123          "comment": "Output port for selected packets.  Mutually exclusive with output_vlan.",
 124          "type": {"key": "uuid", "keyRefTable": "Port", "min": 0, "max": 1}},
 125        "output_vlan": {
 126          "comment": "Output VLAN for selected packets.  Mutually exclusive with output_port.",
 127          "type": {"key": "integer", "min": 0, "max": 1}}}},
 128    "NetFlow": {
 129      "comment": "A NetFlow target.",
 130      "columns": {
 131        "targets": {
 132          "comment": "NetFlow targets in the form \"IP:PORT\".",
 133          "type": {"key": "string", "min": 1, "max": "unlimited"}},
 134        "engine_type": {
 135          "comment": "Engine type to use in NetFlow messages.  Defaults to datapath index if not specified.",
 136          "type": "integer", "min":0, "max":1},
 137        "engine_id": {
 138          "comment": "Engine ID to use in NetFlow messages.  Defaults to datapath index if not specified.",
 139          "type": "integer", "min":0, "max":1},
 140        "add_id_to_interface": {
 141          "comment": "Place least-significant 7 bits of engine ID into most significant bits of ingress and egress interface fields of NetFlow records?",
 142          "type": "boolean"},
 143        "active_timeout": {
 144          "comment": "Active timeout interval, in seconds.  A value of 0 requests the default timeout; a negative value disables active timeouts.",
 145          "type": "integer"}}},
 146    "Controller": {
 147      "comment": "An OpenFlow controller.",
 148      "columns": {
 149        "target": {
 150          "comment": "Connection method for controller, e.g. \"ssl:...\", \"tcp:...\".  The special string \"discover\" enables controller discovery.  The special string \"none\" disables the controller.",
 151          "type": "string"},
 152        "max_backoff": {
 153          "comment": "Maximum number of milliseconds to wait between connection attempts.  Default is implementation-specific.",
 154          "type": {"key": "integer", "min": 0, "max": 1}},
 155        "inactivity_probe": {
 156          "comment": "Maximum number of milliseconds of idle time on connection to controller before sending an inactivity probe message.  Default is implementation-specific.",
 157          "type": {"key": "integer", "min": 0, "max": 1}},
 158        "fail_mode": {
 159          "comment": "Either \"standalone\" or \"secure\", or empty to use the implementation's default.",
 160          "type": {"key": "string", "min": 0, "max": 1}},
 161        "discover_accept_regex": {
 162          "comment": "If \"target\" is \"discover\", a POSIX extended regular expression against which the discovered controller location is validated.  If not specified, the default is implementation-specific.",
 163          "type": {"key": "string", "min": 0, "max": 1}},
 164        "discover_update_resolv_conf": {
 165          "comment": "If \"target\" is \"discover\", whether to update /etc/resolv.conf when the controller is discovered.  If not specified, the default is implementation-specific.",
 166          "type": {"key": "boolean", "min": 0, "max": 1}},
 167        "connection_mode": {
 168          "comment": "Either \"in-band\" or \"out-of-band\".  If not specified, the default is implementation-specific.",
 169          "type": {"key": "string", "min": 0, "max": 1}},
 170        "local_ip": {
 171          "comment": "If \"target\" is not \"discover\", the IP address to configure on the local port.",
 172          "type": {"key": "string", "min": 0, "max": 1}},
 173        "local_netmask": {
 174          "comment": "If \"target\" is not \"discover\", the IP netmask to configure on the local port.",
 175          "type": {"key": "string", "min": 0, "max": 1}},
 176        "local_gateway": {
 177          "comment": "If \"target\" is not \"discover\", the IP gateway to configure on the local port.",
 178          "type": {"key": "string", "min": 0, "max": 1}},
 179        "controller_rate_limit": {
 180          "comment": "The maximum rate at which packets will be forwarded to the OpenFlow controller, in packets per second.  If not specified, the default is implementation-specific.",
 181          "type": {"key": "integer", "min": 0, "max": 1}},
 182        "controller_burst_limit": {
 183          "comment": "The maximum number of unused packet credits that the bridge will allow to accumulate, in packets.  If not specified, the default is implementation-specific.",
 184          "type": {"key": "integer", "min": 0, "max": 1}}}},
 185    "SSL": {
 186      "comment": "SSL configuration for an Open_vSwitch.",
 187      "columns": {
 188        "private_key": {
 189          "comment": "Name of a PEM file containing the private key used as the switch's identity for SSL connections to the controller.",
 190          "type": "string"},
 191        "certificate": {
 192          "comment": "Name of a PEM file containing a certificate, signed by the certificate authority (CA) used by the controller and manager, that certifies the switch's private key, identifying a trustworthy switch.",
 193          "type": "string"},
 194        "ca_cert": {
 195          "comment": "Name of a PEM file containing the CA certificate used to verify that the switch is connected to a trustworthy controller.",
 196          "type": "string"},
 197        "bootstrap_ca_cert": {
 198          "comment": "If set to true, then Open vSwitch will attempt to obtain the CA certificate from the controller on its first SSL connection and save it to the named PEM file. If it is successful, it will immediately drop the connection and reconnect, and from then on all SSL connections must be authenticated by a certificate signed by the CA certificate thus obtained.  This option exposes the SSL connection to a man-in-the-middle attack obtaining the initial CA certificate, but it may be useful for bootstrapping.",
 199          "type": "boolean"}}}}}