openvswitch.h 41 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798991001011021031041051061071081091101111121131141151161171181191201211221231241251261271281291301311321331341351361371381391401411421431441451461471481491501511521531541551561571581591601611621631641651661671681691701711721731741751761771781791801811821831841851861871881891901911921931941951961971981992002012022032042052062072082092102112122132142152162172182192202212222232242252262272282292302312322332342352362372382392402412422432442452462472482492502512522532542552562572582592602612622632642652662672682692702712722732742752762772782792802812822832842852862872882892902912922932942952962972982993003013023033043053063073083093103113123133143153163173183193203213223233243253263273283293303313323333343353363373383393403413423433443453463473483493503513523533543553563573583593603613623633643653663673683693703713723733743753763773783793803813823833843853863873883893903913923933943953963973983994004014024034044054064074084094104114124134144154164174184194204214224234244254264274284294304314324334344354364374384394404414424434444454464474484494504514524534544554564574584594604614624634644654664674684694704714724734744754764774784794804814824834844854864874884894904914924934944954964974984995005015025035045055065075085095105115125135145155165175185195205215225235245255265275285295305315325335345355365375385395405415425435445455465475485495505515525535545555565575585595605615625635645655665675685695705715725735745755765775785795805815825835845855865875885895905915925935945955965975985996006016026036046056066076086096106116126136146156166176186196206216226236246256266276286296306316326336346356366376386396406416426436446456466476486496506516526536546556566576586596606616626636646656666676686696706716726736746756766776786796806816826836846856866876886896906916926936946956966976986997007017027037047057067077087097107117127137147157167177187197207217227237247257267277287297307317327337347357367377387397407417427437447457467477487497507517527537547557567577587597607617627637647657667677687697707717727737747757767777787797807817827837847857867877887897907917927937947957967977987998008018028038048058068078088098108118128138148158168178188198208218228238248258268278288298308318328338348358368378388398408418428438448458468478488498508518528538548558568578588598608618628638648658668678688698708718728738748758768778788798808818828838848858868878888898908918928938948958968978988999009019029039049059069079089099109119129139149159169179189199209219229239249259269279289299309319329339349359369379389399409419429439449459469479489499509519529539549559569579589599609619629639649659669679689699709719729739749759769779789799809819829839849859869879889899909919929939949959969979989991000100110021003100410051006100710081009101010111012101310141015101610171018101910201021102210231024102510261027102810291030103110321033103410351036103710381039104010411042104310441045104610471048104910501051105210531054105510561057105810591060106110621063106410651066106710681069107010711072107310741075107610771078107910801081108210831084108510861087108810891090
  1. /* SPDX-License-Identifier: GPL-2.0 WITH Linux-syscall-note */
  2. /*
  3. * Copyright (c) 2007-2017 Nicira, Inc.
  4. *
  5. * This program is free software; you can redistribute it and/or
  6. * modify it under the terms of version 2 of the GNU General Public
  7. * License as published by the Free Software Foundation.
  8. *
  9. * This program is distributed in the hope that it will be useful, but
  10. * WITHOUT ANY WARRANTY; without even the implied warranty of
  11. * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
  12. * General Public License for more details.
  13. *
  14. * You should have received a copy of the GNU General Public License
  15. * along with this program; if not, write to the Free Software
  16. * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
  17. * 02110-1301, USA
  18. */
  19. #ifndef _UAPI__LINUX_OPENVSWITCH_H
  20. #define _UAPI__LINUX_OPENVSWITCH_H 1
  21. #include <linux/types.h>
  22. #include <linux/if_ether.h>
  23. /**
  24. * struct ovs_header - header for OVS Generic Netlink messages.
  25. * @dp_ifindex: ifindex of local port for datapath (0 to make a request not
  26. * specific to a datapath).
  27. *
  28. * Attributes following the header are specific to a particular OVS Generic
  29. * Netlink family, but all of the OVS families use this header.
  30. */
  31. struct ovs_header {
  32. int dp_ifindex;
  33. };
  34. /* Datapaths. */
  35. #define OVS_DATAPATH_FAMILY "ovs_datapath"
  36. #define OVS_DATAPATH_MCGROUP "ovs_datapath"
  37. /* V2:
  38. * - API users are expected to provide OVS_DP_ATTR_USER_FEATURES
  39. * when creating the datapath.
  40. */
  41. #define OVS_DATAPATH_VERSION 2
  42. /* First OVS datapath version to support features */
  43. #define OVS_DP_VER_FEATURES 2
  44. enum ovs_datapath_cmd {
  45. OVS_DP_CMD_UNSPEC,
  46. OVS_DP_CMD_NEW,
  47. OVS_DP_CMD_DEL,
  48. OVS_DP_CMD_GET,
  49. OVS_DP_CMD_SET
  50. };
  51. /**
  52. * enum ovs_datapath_attr - attributes for %OVS_DP_* commands.
  53. * @OVS_DP_ATTR_NAME: Name of the network device that serves as the "local
  54. * port". This is the name of the network device whose dp_ifindex is given in
  55. * the &struct ovs_header. Always present in notifications. Required in
  56. * %OVS_DP_NEW requests. May be used as an alternative to specifying
  57. * dp_ifindex in other requests (with a dp_ifindex of 0).
  58. * @OVS_DP_ATTR_UPCALL_PID: The Netlink socket in userspace that is initially
  59. * set on the datapath port (for OVS_ACTION_ATTR_MISS). Only valid on
  60. * %OVS_DP_CMD_NEW requests. A value of zero indicates that upcalls should
  61. * not be sent.
  62. * @OVS_DP_ATTR_PER_CPU_PIDS: Per-cpu array of PIDs for upcalls when
  63. * OVS_DP_F_DISPATCH_UPCALL_PER_CPU feature is set.
  64. * @OVS_DP_ATTR_STATS: Statistics about packets that have passed through the
  65. * datapath. Always present in notifications.
  66. * @OVS_DP_ATTR_MEGAFLOW_STATS: Statistics about mega flow masks usage for the
  67. * datapath. Always present in notifications.
  68. * @OVS_DP_ATTR_IFINDEX: Interface index for a new datapath netdev. Only
  69. * valid for %OVS_DP_CMD_NEW requests.
  70. *
  71. * These attributes follow the &struct ovs_header within the Generic Netlink
  72. * payload for %OVS_DP_* commands.
  73. */
  74. enum ovs_datapath_attr {
  75. OVS_DP_ATTR_UNSPEC,
  76. OVS_DP_ATTR_NAME, /* name of dp_ifindex netdev */
  77. OVS_DP_ATTR_UPCALL_PID, /* Netlink PID to receive upcalls */
  78. OVS_DP_ATTR_STATS, /* struct ovs_dp_stats */
  79. OVS_DP_ATTR_MEGAFLOW_STATS, /* struct ovs_dp_megaflow_stats */
  80. OVS_DP_ATTR_USER_FEATURES, /* OVS_DP_F_* */
  81. OVS_DP_ATTR_PAD,
  82. OVS_DP_ATTR_MASKS_CACHE_SIZE,
  83. OVS_DP_ATTR_PER_CPU_PIDS, /* Netlink PIDS to receive upcalls in
  84. * per-cpu dispatch mode
  85. */
  86. OVS_DP_ATTR_IFINDEX,
  87. __OVS_DP_ATTR_MAX
  88. };
  89. #define OVS_DP_ATTR_MAX (__OVS_DP_ATTR_MAX - 1)
  90. struct ovs_dp_stats {
  91. __u64 n_hit; /* Number of flow table matches. */
  92. __u64 n_missed; /* Number of flow table misses. */
  93. __u64 n_lost; /* Number of misses not sent to userspace. */
  94. __u64 n_flows; /* Number of flows present */
  95. };
  96. struct ovs_dp_megaflow_stats {
  97. __u64 n_mask_hit; /* Number of masks used for flow lookups. */
  98. __u32 n_masks; /* Number of masks for the datapath. */
  99. __u32 pad0; /* Pad for future expension. */
  100. __u64 n_cache_hit; /* Number of cache matches for flow lookups. */
  101. __u64 pad1; /* Pad for future expension. */
  102. };
  103. struct ovs_vport_stats {
  104. __u64 rx_packets; /* total packets received */
  105. __u64 tx_packets; /* total packets transmitted */
  106. __u64 rx_bytes; /* total bytes received */
  107. __u64 tx_bytes; /* total bytes transmitted */
  108. __u64 rx_errors; /* bad packets received */
  109. __u64 tx_errors; /* packet transmit problems */
  110. __u64 rx_dropped; /* no space in linux buffers */
  111. __u64 tx_dropped; /* no space available in linux */
  112. };
  113. /* Allow last Netlink attribute to be unaligned */
  114. #define OVS_DP_F_UNALIGNED (1 << 0)
  115. /* Allow datapath to associate multiple Netlink PIDs to each vport */
  116. #define OVS_DP_F_VPORT_PIDS (1 << 1)
  117. /* Allow tc offload recirc sharing */
  118. #define OVS_DP_F_TC_RECIRC_SHARING (1 << 2)
  119. /* Allow per-cpu dispatch of upcalls */
  120. #define OVS_DP_F_DISPATCH_UPCALL_PER_CPU (1 << 3)
  121. /* Fixed logical ports. */
  122. #define OVSP_LOCAL ((__u32)0)
  123. /* Packet transfer. */
  124. #define OVS_PACKET_FAMILY "ovs_packet"
  125. #define OVS_PACKET_VERSION 0x1
  126. enum ovs_packet_cmd {
  127. OVS_PACKET_CMD_UNSPEC,
  128. /* Kernel-to-user notifications. */
  129. OVS_PACKET_CMD_MISS, /* Flow table miss. */
  130. OVS_PACKET_CMD_ACTION, /* OVS_ACTION_ATTR_USERSPACE action. */
  131. /* Userspace commands. */
  132. OVS_PACKET_CMD_EXECUTE /* Apply actions to a packet. */
  133. };
  134. /**
  135. * enum ovs_packet_attr - attributes for %OVS_PACKET_* commands.
  136. * @OVS_PACKET_ATTR_PACKET: Present for all notifications. Contains the entire
  137. * packet as received, from the start of the Ethernet header onward. For
  138. * %OVS_PACKET_CMD_ACTION, %OVS_PACKET_ATTR_PACKET reflects changes made by
  139. * actions preceding %OVS_ACTION_ATTR_USERSPACE, but %OVS_PACKET_ATTR_KEY is
  140. * the flow key extracted from the packet as originally received.
  141. * @OVS_PACKET_ATTR_KEY: Present for all notifications. Contains the flow key
  142. * extracted from the packet as nested %OVS_KEY_ATTR_* attributes. This allows
  143. * userspace to adapt its flow setup strategy by comparing its notion of the
  144. * flow key against the kernel's.
  145. * @OVS_PACKET_ATTR_ACTIONS: Contains actions for the packet. Used
  146. * for %OVS_PACKET_CMD_EXECUTE. It has nested %OVS_ACTION_ATTR_* attributes.
  147. * Also used in upcall when %OVS_ACTION_ATTR_USERSPACE has optional
  148. * %OVS_USERSPACE_ATTR_ACTIONS attribute.
  149. * @OVS_PACKET_ATTR_USERDATA: Present for an %OVS_PACKET_CMD_ACTION
  150. * notification if the %OVS_ACTION_ATTR_USERSPACE action specified an
  151. * %OVS_USERSPACE_ATTR_USERDATA attribute, with the same length and content
  152. * specified there.
  153. * @OVS_PACKET_ATTR_EGRESS_TUN_KEY: Present for an %OVS_PACKET_CMD_ACTION
  154. * notification if the %OVS_ACTION_ATTR_USERSPACE action specified an
  155. * %OVS_USERSPACE_ATTR_EGRESS_TUN_PORT attribute, which is sent only if the
  156. * output port is actually a tunnel port. Contains the output tunnel key
  157. * extracted from the packet as nested %OVS_TUNNEL_KEY_ATTR_* attributes.
  158. * @OVS_PACKET_ATTR_MRU: Present for an %OVS_PACKET_CMD_ACTION and
  159. * @OVS_PACKET_ATTR_LEN: Packet size before truncation.
  160. * %OVS_PACKET_ATTR_USERSPACE action specify the Maximum received fragment
  161. * size.
  162. * @OVS_PACKET_ATTR_HASH: Packet hash info (e.g. hash, sw_hash and l4_hash in skb).
  163. *
  164. * These attributes follow the &struct ovs_header within the Generic Netlink
  165. * payload for %OVS_PACKET_* commands.
  166. */
  167. enum ovs_packet_attr {
  168. OVS_PACKET_ATTR_UNSPEC,
  169. OVS_PACKET_ATTR_PACKET, /* Packet data. */
  170. OVS_PACKET_ATTR_KEY, /* Nested OVS_KEY_ATTR_* attributes. */
  171. OVS_PACKET_ATTR_ACTIONS, /* Nested OVS_ACTION_ATTR_* attributes. */
  172. OVS_PACKET_ATTR_USERDATA, /* OVS_ACTION_ATTR_USERSPACE arg. */
  173. OVS_PACKET_ATTR_EGRESS_TUN_KEY, /* Nested OVS_TUNNEL_KEY_ATTR_*
  174. attributes. */
  175. OVS_PACKET_ATTR_UNUSED1,
  176. OVS_PACKET_ATTR_UNUSED2,
  177. OVS_PACKET_ATTR_PROBE, /* Packet operation is a feature probe,
  178. error logging should be suppressed. */
  179. OVS_PACKET_ATTR_MRU, /* Maximum received IP fragment size. */
  180. OVS_PACKET_ATTR_LEN, /* Packet size before truncation. */
  181. OVS_PACKET_ATTR_HASH, /* Packet hash. */
  182. __OVS_PACKET_ATTR_MAX
  183. };
  184. #define OVS_PACKET_ATTR_MAX (__OVS_PACKET_ATTR_MAX - 1)
  185. /* Virtual ports. */
  186. #define OVS_VPORT_FAMILY "ovs_vport"
  187. #define OVS_VPORT_MCGROUP "ovs_vport"
  188. #define OVS_VPORT_VERSION 0x1
  189. enum ovs_vport_cmd {
  190. OVS_VPORT_CMD_UNSPEC,
  191. OVS_VPORT_CMD_NEW,
  192. OVS_VPORT_CMD_DEL,
  193. OVS_VPORT_CMD_GET,
  194. OVS_VPORT_CMD_SET
  195. };
  196. enum ovs_vport_type {
  197. OVS_VPORT_TYPE_UNSPEC,
  198. OVS_VPORT_TYPE_NETDEV, /* network device */
  199. OVS_VPORT_TYPE_INTERNAL, /* network device implemented by datapath */
  200. OVS_VPORT_TYPE_GRE, /* GRE tunnel. */
  201. OVS_VPORT_TYPE_VXLAN, /* VXLAN tunnel. */
  202. OVS_VPORT_TYPE_GENEVE, /* Geneve tunnel. */
  203. __OVS_VPORT_TYPE_MAX
  204. };
  205. #define OVS_VPORT_TYPE_MAX (__OVS_VPORT_TYPE_MAX - 1)
  206. /**
  207. * enum ovs_vport_attr - attributes for %OVS_VPORT_* commands.
  208. * @OVS_VPORT_ATTR_PORT_NO: 32-bit port number within datapath.
  209. * @OVS_VPORT_ATTR_TYPE: 32-bit %OVS_VPORT_TYPE_* constant describing the type
  210. * of vport.
  211. * @OVS_VPORT_ATTR_NAME: Name of vport. For a vport based on a network device
  212. * this is the name of the network device. Maximum length %IFNAMSIZ-1 bytes
  213. * plus a null terminator.
  214. * @OVS_VPORT_ATTR_OPTIONS: Vport-specific configuration information.
  215. * @OVS_VPORT_ATTR_UPCALL_PID: The array of Netlink socket pids in userspace
  216. * among which OVS_PACKET_CMD_MISS upcalls will be distributed for packets
  217. * received on this port. If this is a single-element array of value 0,
  218. * upcalls should not be sent.
  219. * @OVS_VPORT_ATTR_STATS: A &struct ovs_vport_stats giving statistics for
  220. * packets sent or received through the vport.
  221. *
  222. * These attributes follow the &struct ovs_header within the Generic Netlink
  223. * payload for %OVS_VPORT_* commands.
  224. *
  225. * For %OVS_VPORT_CMD_NEW requests, the %OVS_VPORT_ATTR_TYPE and
  226. * %OVS_VPORT_ATTR_NAME attributes are required. %OVS_VPORT_ATTR_PORT_NO is
  227. * optional; if not specified a free port number is automatically selected.
  228. * Whether %OVS_VPORT_ATTR_OPTIONS is required or optional depends on the type
  229. * of vport.
  230. *
  231. * For other requests, if %OVS_VPORT_ATTR_NAME is specified then it is used to
  232. * look up the vport to operate on; otherwise dp_idx from the &struct
  233. * ovs_header plus %OVS_VPORT_ATTR_PORT_NO determine the vport.
  234. */
  235. enum ovs_vport_attr {
  236. OVS_VPORT_ATTR_UNSPEC,
  237. OVS_VPORT_ATTR_PORT_NO, /* u32 port number within datapath */
  238. OVS_VPORT_ATTR_TYPE, /* u32 OVS_VPORT_TYPE_* constant. */
  239. OVS_VPORT_ATTR_NAME, /* string name, up to IFNAMSIZ bytes long */
  240. OVS_VPORT_ATTR_OPTIONS, /* nested attributes, varies by vport type */
  241. OVS_VPORT_ATTR_UPCALL_PID, /* array of u32 Netlink socket PIDs for */
  242. /* receiving upcalls */
  243. OVS_VPORT_ATTR_STATS, /* struct ovs_vport_stats */
  244. OVS_VPORT_ATTR_PAD,
  245. OVS_VPORT_ATTR_IFINDEX,
  246. OVS_VPORT_ATTR_NETNSID,
  247. __OVS_VPORT_ATTR_MAX
  248. };
  249. #define OVS_VPORT_ATTR_MAX (__OVS_VPORT_ATTR_MAX - 1)
  250. enum {
  251. OVS_VXLAN_EXT_UNSPEC,
  252. OVS_VXLAN_EXT_GBP, /* Flag or __u32 */
  253. __OVS_VXLAN_EXT_MAX,
  254. };
  255. #define OVS_VXLAN_EXT_MAX (__OVS_VXLAN_EXT_MAX - 1)
  256. /* OVS_VPORT_ATTR_OPTIONS attributes for tunnels.
  257. */
  258. enum {
  259. OVS_TUNNEL_ATTR_UNSPEC,
  260. OVS_TUNNEL_ATTR_DST_PORT, /* 16-bit UDP port, used by L4 tunnels. */
  261. OVS_TUNNEL_ATTR_EXTENSION,
  262. __OVS_TUNNEL_ATTR_MAX
  263. };
  264. #define OVS_TUNNEL_ATTR_MAX (__OVS_TUNNEL_ATTR_MAX - 1)
  265. /* Flows. */
  266. #define OVS_FLOW_FAMILY "ovs_flow"
  267. #define OVS_FLOW_MCGROUP "ovs_flow"
  268. #define OVS_FLOW_VERSION 0x1
  269. enum ovs_flow_cmd {
  270. OVS_FLOW_CMD_UNSPEC,
  271. OVS_FLOW_CMD_NEW,
  272. OVS_FLOW_CMD_DEL,
  273. OVS_FLOW_CMD_GET,
  274. OVS_FLOW_CMD_SET
  275. };
  276. struct ovs_flow_stats {
  277. __u64 n_packets; /* Number of matched packets. */
  278. __u64 n_bytes; /* Number of matched bytes. */
  279. };
  280. enum ovs_key_attr {
  281. OVS_KEY_ATTR_UNSPEC,
  282. OVS_KEY_ATTR_ENCAP, /* Nested set of encapsulated attributes. */
  283. OVS_KEY_ATTR_PRIORITY, /* u32 skb->priority */
  284. OVS_KEY_ATTR_IN_PORT, /* u32 OVS dp port number */
  285. OVS_KEY_ATTR_ETHERNET, /* struct ovs_key_ethernet */
  286. OVS_KEY_ATTR_VLAN, /* be16 VLAN TCI */
  287. OVS_KEY_ATTR_ETHERTYPE, /* be16 Ethernet type */
  288. OVS_KEY_ATTR_IPV4, /* struct ovs_key_ipv4 */
  289. OVS_KEY_ATTR_IPV6, /* struct ovs_key_ipv6 */
  290. OVS_KEY_ATTR_TCP, /* struct ovs_key_tcp */
  291. OVS_KEY_ATTR_UDP, /* struct ovs_key_udp */
  292. OVS_KEY_ATTR_ICMP, /* struct ovs_key_icmp */
  293. OVS_KEY_ATTR_ICMPV6, /* struct ovs_key_icmpv6 */
  294. OVS_KEY_ATTR_ARP, /* struct ovs_key_arp */
  295. OVS_KEY_ATTR_ND, /* struct ovs_key_nd */
  296. OVS_KEY_ATTR_SKB_MARK, /* u32 skb mark */
  297. OVS_KEY_ATTR_TUNNEL, /* Nested set of ovs_tunnel attributes */
  298. OVS_KEY_ATTR_SCTP, /* struct ovs_key_sctp */
  299. OVS_KEY_ATTR_TCP_FLAGS, /* be16 TCP flags. */
  300. OVS_KEY_ATTR_DP_HASH, /* u32 hash value. Value 0 indicates the hash
  301. is not computed by the datapath. */
  302. OVS_KEY_ATTR_RECIRC_ID, /* u32 recirc id */
  303. OVS_KEY_ATTR_MPLS, /* array of struct ovs_key_mpls.
  304. * The implementation may restrict
  305. * the accepted length of the array. */
  306. OVS_KEY_ATTR_CT_STATE, /* u32 bitmask of OVS_CS_F_* */
  307. OVS_KEY_ATTR_CT_ZONE, /* u16 connection tracking zone. */
  308. OVS_KEY_ATTR_CT_MARK, /* u32 connection tracking mark */
  309. OVS_KEY_ATTR_CT_LABELS, /* 16-octet connection tracking label */
  310. OVS_KEY_ATTR_CT_ORIG_TUPLE_IPV4, /* struct ovs_key_ct_tuple_ipv4 */
  311. OVS_KEY_ATTR_CT_ORIG_TUPLE_IPV6, /* struct ovs_key_ct_tuple_ipv6 */
  312. OVS_KEY_ATTR_NSH, /* Nested set of ovs_nsh_key_* */
  313. /* User space decided to squat on types 29 and 30. They are defined
  314. * below, but should not be sent to the kernel.
  315. *
  316. * WARNING: No new types should be added unless they are defined
  317. * for both kernel and user space (no 'ifdef's). It's hard
  318. * to keep compatibility otherwise.
  319. */
  320. OVS_KEY_ATTR_PACKET_TYPE, /* be32 packet type */
  321. OVS_KEY_ATTR_ND_EXTENSIONS, /* IPv6 Neighbor Discovery extensions */
  322. OVS_KEY_ATTR_TUNNEL_INFO, /* struct ip_tunnel_info.
  323. * For in-kernel use only.
  324. */
  325. OVS_KEY_ATTR_IPV6_EXTHDRS, /* struct ovs_key_ipv6_exthdr */
  326. __OVS_KEY_ATTR_MAX
  327. };
  328. #define OVS_KEY_ATTR_MAX (__OVS_KEY_ATTR_MAX - 1)
  329. enum ovs_tunnel_key_attr {
  330. /* OVS_TUNNEL_KEY_ATTR_NONE, standard nl API requires this attribute! */
  331. OVS_TUNNEL_KEY_ATTR_ID, /* be64 Tunnel ID */
  332. OVS_TUNNEL_KEY_ATTR_IPV4_SRC, /* be32 src IP address. */
  333. OVS_TUNNEL_KEY_ATTR_IPV4_DST, /* be32 dst IP address. */
  334. OVS_TUNNEL_KEY_ATTR_TOS, /* u8 Tunnel IP ToS. */
  335. OVS_TUNNEL_KEY_ATTR_TTL, /* u8 Tunnel IP TTL. */
  336. OVS_TUNNEL_KEY_ATTR_DONT_FRAGMENT, /* No argument, set DF. */
  337. OVS_TUNNEL_KEY_ATTR_CSUM, /* No argument. CSUM packet. */
  338. OVS_TUNNEL_KEY_ATTR_OAM, /* No argument. OAM frame. */
  339. OVS_TUNNEL_KEY_ATTR_GENEVE_OPTS, /* Array of Geneve options. */
  340. OVS_TUNNEL_KEY_ATTR_TP_SRC, /* be16 src Transport Port. */
  341. OVS_TUNNEL_KEY_ATTR_TP_DST, /* be16 dst Transport Port. */
  342. OVS_TUNNEL_KEY_ATTR_VXLAN_OPTS, /* Nested OVS_VXLAN_EXT_* */
  343. OVS_TUNNEL_KEY_ATTR_IPV6_SRC, /* struct in6_addr src IPv6 address. */
  344. OVS_TUNNEL_KEY_ATTR_IPV6_DST, /* struct in6_addr dst IPv6 address. */
  345. OVS_TUNNEL_KEY_ATTR_PAD,
  346. OVS_TUNNEL_KEY_ATTR_ERSPAN_OPTS, /* struct erspan_metadata */
  347. OVS_TUNNEL_KEY_ATTR_IPV4_INFO_BRIDGE, /* No argument. IPV4_INFO_BRIDGE mode.*/
  348. __OVS_TUNNEL_KEY_ATTR_MAX
  349. };
  350. #define OVS_TUNNEL_KEY_ATTR_MAX (__OVS_TUNNEL_KEY_ATTR_MAX - 1)
  351. /**
  352. * enum ovs_frag_type - IPv4 and IPv6 fragment type
  353. * @OVS_FRAG_TYPE_NONE: Packet is not a fragment.
  354. * @OVS_FRAG_TYPE_FIRST: Packet is a fragment with offset 0.
  355. * @OVS_FRAG_TYPE_LATER: Packet is a fragment with nonzero offset.
  356. *
  357. * Used as the @ipv4_frag in &struct ovs_key_ipv4 and as @ipv6_frag &struct
  358. * ovs_key_ipv6.
  359. */
  360. enum ovs_frag_type {
  361. OVS_FRAG_TYPE_NONE,
  362. OVS_FRAG_TYPE_FIRST,
  363. OVS_FRAG_TYPE_LATER,
  364. __OVS_FRAG_TYPE_MAX
  365. };
  366. #define OVS_FRAG_TYPE_MAX (__OVS_FRAG_TYPE_MAX - 1)
  367. struct ovs_key_ethernet {
  368. __u8 eth_src[ETH_ALEN];
  369. __u8 eth_dst[ETH_ALEN];
  370. };
  371. struct ovs_key_mpls {
  372. __be32 mpls_lse;
  373. };
  374. struct ovs_key_ipv4 {
  375. __be32 ipv4_src;
  376. __be32 ipv4_dst;
  377. __u8 ipv4_proto;
  378. __u8 ipv4_tos;
  379. __u8 ipv4_ttl;
  380. __u8 ipv4_frag; /* One of OVS_FRAG_TYPE_*. */
  381. };
  382. struct ovs_key_ipv6 {
  383. __be32 ipv6_src[4];
  384. __be32 ipv6_dst[4];
  385. __be32 ipv6_label; /* 20-bits in least-significant bits. */
  386. __u8 ipv6_proto;
  387. __u8 ipv6_tclass;
  388. __u8 ipv6_hlimit;
  389. __u8 ipv6_frag; /* One of OVS_FRAG_TYPE_*. */
  390. };
  391. /* separate structure to support backward compatibility with older user space */
  392. struct ovs_key_ipv6_exthdrs {
  393. __u16 hdrs;
  394. };
  395. struct ovs_key_tcp {
  396. __be16 tcp_src;
  397. __be16 tcp_dst;
  398. };
  399. struct ovs_key_udp {
  400. __be16 udp_src;
  401. __be16 udp_dst;
  402. };
  403. struct ovs_key_sctp {
  404. __be16 sctp_src;
  405. __be16 sctp_dst;
  406. };
  407. struct ovs_key_icmp {
  408. __u8 icmp_type;
  409. __u8 icmp_code;
  410. };
  411. struct ovs_key_icmpv6 {
  412. __u8 icmpv6_type;
  413. __u8 icmpv6_code;
  414. };
  415. struct ovs_key_arp {
  416. __be32 arp_sip;
  417. __be32 arp_tip;
  418. __be16 arp_op;
  419. __u8 arp_sha[ETH_ALEN];
  420. __u8 arp_tha[ETH_ALEN];
  421. };
  422. struct ovs_key_nd {
  423. __be32 nd_target[4];
  424. __u8 nd_sll[ETH_ALEN];
  425. __u8 nd_tll[ETH_ALEN];
  426. };
  427. #define OVS_CT_LABELS_LEN_32 4
  428. #define OVS_CT_LABELS_LEN (OVS_CT_LABELS_LEN_32 * sizeof(__u32))
  429. struct ovs_key_ct_labels {
  430. union {
  431. __u8 ct_labels[OVS_CT_LABELS_LEN];
  432. __u32 ct_labels_32[OVS_CT_LABELS_LEN_32];
  433. };
  434. };
  435. /* OVS_KEY_ATTR_CT_STATE flags */
  436. #define OVS_CS_F_NEW 0x01 /* Beginning of a new connection. */
  437. #define OVS_CS_F_ESTABLISHED 0x02 /* Part of an existing connection. */
  438. #define OVS_CS_F_RELATED 0x04 /* Related to an established
  439. * connection. */
  440. #define OVS_CS_F_REPLY_DIR 0x08 /* Flow is in the reply direction. */
  441. #define OVS_CS_F_INVALID 0x10 /* Could not track connection. */
  442. #define OVS_CS_F_TRACKED 0x20 /* Conntrack has occurred. */
  443. #define OVS_CS_F_SRC_NAT 0x40 /* Packet's source address/port was
  444. * mangled by NAT.
  445. */
  446. #define OVS_CS_F_DST_NAT 0x80 /* Packet's destination address/port
  447. * was mangled by NAT.
  448. */
  449. #define OVS_CS_F_NAT_MASK (OVS_CS_F_SRC_NAT | OVS_CS_F_DST_NAT)
  450. struct ovs_key_ct_tuple_ipv4 {
  451. __be32 ipv4_src;
  452. __be32 ipv4_dst;
  453. __be16 src_port;
  454. __be16 dst_port;
  455. __u8 ipv4_proto;
  456. };
  457. struct ovs_key_ct_tuple_ipv6 {
  458. __be32 ipv6_src[4];
  459. __be32 ipv6_dst[4];
  460. __be16 src_port;
  461. __be16 dst_port;
  462. __u8 ipv6_proto;
  463. };
  464. enum ovs_nsh_key_attr {
  465. OVS_NSH_KEY_ATTR_UNSPEC,
  466. OVS_NSH_KEY_ATTR_BASE, /* struct ovs_nsh_key_base. */
  467. OVS_NSH_KEY_ATTR_MD1, /* struct ovs_nsh_key_md1. */
  468. OVS_NSH_KEY_ATTR_MD2, /* variable-length octets for MD type 2. */
  469. __OVS_NSH_KEY_ATTR_MAX
  470. };
  471. #define OVS_NSH_KEY_ATTR_MAX (__OVS_NSH_KEY_ATTR_MAX - 1)
  472. struct ovs_nsh_key_base {
  473. __u8 flags;
  474. __u8 ttl;
  475. __u8 mdtype;
  476. __u8 np;
  477. __be32 path_hdr;
  478. };
  479. #define NSH_MD1_CONTEXT_SIZE 4
  480. struct ovs_nsh_key_md1 {
  481. __be32 context[NSH_MD1_CONTEXT_SIZE];
  482. };
  483. /**
  484. * enum ovs_flow_attr - attributes for %OVS_FLOW_* commands.
  485. * @OVS_FLOW_ATTR_KEY: Nested %OVS_KEY_ATTR_* attributes specifying the flow
  486. * key. Always present in notifications. Required for all requests (except
  487. * dumps).
  488. * @OVS_FLOW_ATTR_ACTIONS: Nested %OVS_ACTION_ATTR_* attributes specifying
  489. * the actions to take for packets that match the key. Always present in
  490. * notifications. Required for %OVS_FLOW_CMD_NEW requests, optional for
  491. * %OVS_FLOW_CMD_SET requests. An %OVS_FLOW_CMD_SET without
  492. * %OVS_FLOW_ATTR_ACTIONS will not modify the actions. To clear the actions,
  493. * an %OVS_FLOW_ATTR_ACTIONS without any nested attributes must be given.
  494. * @OVS_FLOW_ATTR_STATS: &struct ovs_flow_stats giving statistics for this
  495. * flow. Present in notifications if the stats would be nonzero. Ignored in
  496. * requests.
  497. * @OVS_FLOW_ATTR_TCP_FLAGS: An 8-bit value giving the OR'd value of all of the
  498. * TCP flags seen on packets in this flow. Only present in notifications for
  499. * TCP flows, and only if it would be nonzero. Ignored in requests.
  500. * @OVS_FLOW_ATTR_USED: A 64-bit integer giving the time, in milliseconds on
  501. * the system monotonic clock, at which a packet was last processed for this
  502. * flow. Only present in notifications if a packet has been processed for this
  503. * flow. Ignored in requests.
  504. * @OVS_FLOW_ATTR_CLEAR: If present in a %OVS_FLOW_CMD_SET request, clears the
  505. * last-used time, accumulated TCP flags, and statistics for this flow.
  506. * Otherwise ignored in requests. Never present in notifications.
  507. * @OVS_FLOW_ATTR_MASK: Nested %OVS_KEY_ATTR_* attributes specifying the
  508. * mask bits for wildcarded flow match. Mask bit value '1' specifies exact
  509. * match with corresponding flow key bit, while mask bit value '0' specifies
  510. * a wildcarded match. Omitting attribute is treated as wildcarding all
  511. * corresponding fields. Optional for all requests. If not present,
  512. * all flow key bits are exact match bits.
  513. * @OVS_FLOW_ATTR_UFID: A value between 1-16 octets specifying a unique
  514. * identifier for the flow. Causes the flow to be indexed by this value rather
  515. * than the value of the %OVS_FLOW_ATTR_KEY attribute. Optional for all
  516. * requests. Present in notifications if the flow was created with this
  517. * attribute.
  518. * @OVS_FLOW_ATTR_UFID_FLAGS: A 32-bit value of OR'd %OVS_UFID_F_*
  519. * flags that provide alternative semantics for flow installation and
  520. * retrieval. Optional for all requests.
  521. *
  522. * These attributes follow the &struct ovs_header within the Generic Netlink
  523. * payload for %OVS_FLOW_* commands.
  524. */
  525. enum ovs_flow_attr {
  526. OVS_FLOW_ATTR_UNSPEC,
  527. OVS_FLOW_ATTR_KEY, /* Sequence of OVS_KEY_ATTR_* attributes. */
  528. OVS_FLOW_ATTR_ACTIONS, /* Nested OVS_ACTION_ATTR_* attributes. */
  529. OVS_FLOW_ATTR_STATS, /* struct ovs_flow_stats. */
  530. OVS_FLOW_ATTR_TCP_FLAGS, /* 8-bit OR'd TCP flags. */
  531. OVS_FLOW_ATTR_USED, /* u64 msecs last used in monotonic time. */
  532. OVS_FLOW_ATTR_CLEAR, /* Flag to clear stats, tcp_flags, used. */
  533. OVS_FLOW_ATTR_MASK, /* Sequence of OVS_KEY_ATTR_* attributes. */
  534. OVS_FLOW_ATTR_PROBE, /* Flow operation is a feature probe, error
  535. * logging should be suppressed. */
  536. OVS_FLOW_ATTR_UFID, /* Variable length unique flow identifier. */
  537. OVS_FLOW_ATTR_UFID_FLAGS,/* u32 of OVS_UFID_F_*. */
  538. OVS_FLOW_ATTR_PAD,
  539. __OVS_FLOW_ATTR_MAX
  540. };
  541. #define OVS_FLOW_ATTR_MAX (__OVS_FLOW_ATTR_MAX - 1)
  542. /**
  543. * Omit attributes for notifications.
  544. *
  545. * If a datapath request contains an %OVS_UFID_F_OMIT_* flag, then the datapath
  546. * may omit the corresponding %OVS_FLOW_ATTR_* from the response.
  547. */
  548. #define OVS_UFID_F_OMIT_KEY (1 << 0)
  549. #define OVS_UFID_F_OMIT_MASK (1 << 1)
  550. #define OVS_UFID_F_OMIT_ACTIONS (1 << 2)
  551. /**
  552. * enum ovs_sample_attr - Attributes for %OVS_ACTION_ATTR_SAMPLE action.
  553. * @OVS_SAMPLE_ATTR_PROBABILITY: 32-bit fraction of packets to sample with
  554. * @OVS_ACTION_ATTR_SAMPLE. A value of 0 samples no packets, a value of
  555. * %UINT32_MAX samples all packets and intermediate values sample intermediate
  556. * fractions of packets.
  557. * @OVS_SAMPLE_ATTR_ACTIONS: Set of actions to execute in sampling event.
  558. * Actions are passed as nested attributes.
  559. *
  560. * Executes the specified actions with the given probability on a per-packet
  561. * basis.
  562. */
  563. enum ovs_sample_attr {
  564. OVS_SAMPLE_ATTR_UNSPEC,
  565. OVS_SAMPLE_ATTR_PROBABILITY, /* u32 number */
  566. OVS_SAMPLE_ATTR_ACTIONS, /* Nested OVS_ACTION_ATTR_* attributes. */
  567. __OVS_SAMPLE_ATTR_MAX,
  568. #ifdef __KERNEL__
  569. OVS_SAMPLE_ATTR_ARG /* struct sample_arg */
  570. #endif
  571. };
  572. #define OVS_SAMPLE_ATTR_MAX (__OVS_SAMPLE_ATTR_MAX - 1)
  573. #ifdef __KERNEL__
  574. struct sample_arg {
  575. bool exec; /* When true, actions in sample will not
  576. * change flow keys. False otherwise.
  577. */
  578. u32 probability; /* Same value as
  579. * 'OVS_SAMPLE_ATTR_PROBABILITY'.
  580. */
  581. };
  582. #endif
  583. /**
  584. * enum ovs_userspace_attr - Attributes for %OVS_ACTION_ATTR_USERSPACE action.
  585. * @OVS_USERSPACE_ATTR_PID: u32 Netlink PID to which the %OVS_PACKET_CMD_ACTION
  586. * message should be sent. Required.
  587. * @OVS_USERSPACE_ATTR_USERDATA: If present, its variable-length argument is
  588. * copied to the %OVS_PACKET_CMD_ACTION message as %OVS_PACKET_ATTR_USERDATA.
  589. * @OVS_USERSPACE_ATTR_EGRESS_TUN_PORT: If present, u32 output port to get
  590. * tunnel info.
  591. * @OVS_USERSPACE_ATTR_ACTIONS: If present, send actions with upcall.
  592. */
  593. enum ovs_userspace_attr {
  594. OVS_USERSPACE_ATTR_UNSPEC,
  595. OVS_USERSPACE_ATTR_PID, /* u32 Netlink PID to receive upcalls. */
  596. OVS_USERSPACE_ATTR_USERDATA, /* Optional user-specified cookie. */
  597. OVS_USERSPACE_ATTR_EGRESS_TUN_PORT, /* Optional, u32 output port
  598. * to get tunnel info. */
  599. OVS_USERSPACE_ATTR_ACTIONS, /* Optional flag to get actions. */
  600. __OVS_USERSPACE_ATTR_MAX
  601. };
  602. #define OVS_USERSPACE_ATTR_MAX (__OVS_USERSPACE_ATTR_MAX - 1)
  603. struct ovs_action_trunc {
  604. __u32 max_len; /* Max packet size in bytes. */
  605. };
  606. /**
  607. * struct ovs_action_push_mpls - %OVS_ACTION_ATTR_PUSH_MPLS action argument.
  608. * @mpls_lse: MPLS label stack entry to push.
  609. * @mpls_ethertype: Ethertype to set in the encapsulating ethernet frame.
  610. *
  611. * The only values @mpls_ethertype should ever be given are %ETH_P_MPLS_UC and
  612. * %ETH_P_MPLS_MC, indicating MPLS unicast or multicast. Other are rejected.
  613. */
  614. struct ovs_action_push_mpls {
  615. __be32 mpls_lse;
  616. __be16 mpls_ethertype; /* Either %ETH_P_MPLS_UC or %ETH_P_MPLS_MC */
  617. };
  618. /**
  619. * struct ovs_action_add_mpls - %OVS_ACTION_ATTR_ADD_MPLS action
  620. * argument.
  621. * @mpls_lse: MPLS label stack entry to push.
  622. * @mpls_ethertype: Ethertype to set in the encapsulating ethernet frame.
  623. * @tun_flags: MPLS tunnel attributes.
  624. *
  625. * The only values @mpls_ethertype should ever be given are %ETH_P_MPLS_UC and
  626. * %ETH_P_MPLS_MC, indicating MPLS unicast or multicast. Other are rejected.
  627. */
  628. struct ovs_action_add_mpls {
  629. __be32 mpls_lse;
  630. __be16 mpls_ethertype; /* Either %ETH_P_MPLS_UC or %ETH_P_MPLS_MC */
  631. __u16 tun_flags;
  632. };
  633. #define OVS_MPLS_L3_TUNNEL_FLAG_MASK (1 << 0) /* Flag to specify the place of
  634. * insertion of MPLS header.
  635. * When false, the MPLS header
  636. * will be inserted at the start
  637. * of the packet.
  638. * When true, the MPLS header
  639. * will be inserted at the start
  640. * of the l3 header.
  641. */
  642. /**
  643. * struct ovs_action_push_vlan - %OVS_ACTION_ATTR_PUSH_VLAN action argument.
  644. * @vlan_tpid: Tag protocol identifier (TPID) to push.
  645. * @vlan_tci: Tag control identifier (TCI) to push. The CFI bit must be set
  646. * (but it will not be set in the 802.1Q header that is pushed).
  647. *
  648. * The @vlan_tpid value is typically %ETH_P_8021Q or %ETH_P_8021AD.
  649. * The only acceptable TPID values are those that the kernel module also parses
  650. * as 802.1Q or 802.1AD headers, to prevent %OVS_ACTION_ATTR_PUSH_VLAN followed
  651. * by %OVS_ACTION_ATTR_POP_VLAN from having surprising results.
  652. */
  653. struct ovs_action_push_vlan {
  654. __be16 vlan_tpid; /* 802.1Q or 802.1ad TPID. */
  655. __be16 vlan_tci; /* 802.1Q TCI (VLAN ID and priority). */
  656. };
  657. /* Data path hash algorithm for computing Datapath hash.
  658. *
  659. * The algorithm type only specifies the fields in a flow
  660. * will be used as part of the hash. Each datapath is free
  661. * to use its own hash algorithm. The hash value will be
  662. * opaque to the user space daemon.
  663. */
  664. enum ovs_hash_alg {
  665. OVS_HASH_ALG_L4,
  666. };
  667. /*
  668. * struct ovs_action_hash - %OVS_ACTION_ATTR_HASH action argument.
  669. * @hash_alg: Algorithm used to compute hash prior to recirculation.
  670. * @hash_basis: basis used for computing hash.
  671. */
  672. struct ovs_action_hash {
  673. __u32 hash_alg; /* One of ovs_hash_alg. */
  674. __u32 hash_basis;
  675. };
  676. /**
  677. * enum ovs_ct_attr - Attributes for %OVS_ACTION_ATTR_CT action.
  678. * @OVS_CT_ATTR_COMMIT: If present, commits the connection to the conntrack
  679. * table. This allows future packets for the same connection to be identified
  680. * as 'established' or 'related'. The flow key for the current packet will
  681. * retain the pre-commit connection state.
  682. * @OVS_CT_ATTR_ZONE: u16 connection tracking zone.
  683. * @OVS_CT_ATTR_MARK: u32 value followed by u32 mask. For each bit set in the
  684. * mask, the corresponding bit in the value is copied to the connection
  685. * tracking mark field in the connection.
  686. * @OVS_CT_ATTR_LABELS: %OVS_CT_LABELS_LEN value followed by %OVS_CT_LABELS_LEN
  687. * mask. For each bit set in the mask, the corresponding bit in the value is
  688. * copied to the connection tracking label field in the connection.
  689. * @OVS_CT_ATTR_HELPER: variable length string defining conntrack ALG.
  690. * @OVS_CT_ATTR_NAT: Nested OVS_NAT_ATTR_* for performing L3 network address
  691. * translation (NAT) on the packet.
  692. * @OVS_CT_ATTR_FORCE_COMMIT: Like %OVS_CT_ATTR_COMMIT, but instead of doing
  693. * nothing if the connection is already committed will check that the current
  694. * packet is in conntrack entry's original direction. If directionality does
  695. * not match, will delete the existing conntrack entry and commit a new one.
  696. * @OVS_CT_ATTR_EVENTMASK: Mask of bits indicating which conntrack event types
  697. * (enum ip_conntrack_events IPCT_*) should be reported. For any bit set to
  698. * zero, the corresponding event type is not generated. Default behavior
  699. * depends on system configuration, but typically all event types are
  700. * generated, hence listening on NFNLGRP_CONNTRACK_UPDATE events may get a lot
  701. * of events. Explicitly passing this attribute allows limiting the updates
  702. * received to the events of interest. The bit 1 << IPCT_NEW, 1 <<
  703. * IPCT_RELATED, and 1 << IPCT_DESTROY must be set to ones for those events to
  704. * be received on NFNLGRP_CONNTRACK_NEW and NFNLGRP_CONNTRACK_DESTROY groups,
  705. * respectively. Remaining bits control the changes for which an event is
  706. * delivered on the NFNLGRP_CONNTRACK_UPDATE group.
  707. * @OVS_CT_ATTR_TIMEOUT: Variable length string defining conntrack timeout.
  708. */
  709. enum ovs_ct_attr {
  710. OVS_CT_ATTR_UNSPEC,
  711. OVS_CT_ATTR_COMMIT, /* No argument, commits connection. */
  712. OVS_CT_ATTR_ZONE, /* u16 zone id. */
  713. OVS_CT_ATTR_MARK, /* mark to associate with this connection. */
  714. OVS_CT_ATTR_LABELS, /* labels to associate with this connection. */
  715. OVS_CT_ATTR_HELPER, /* netlink helper to assist detection of
  716. related connections. */
  717. OVS_CT_ATTR_NAT, /* Nested OVS_NAT_ATTR_* */
  718. OVS_CT_ATTR_FORCE_COMMIT, /* No argument */
  719. OVS_CT_ATTR_EVENTMASK, /* u32 mask of IPCT_* events. */
  720. OVS_CT_ATTR_TIMEOUT, /* Associate timeout with this connection for
  721. * fine-grain timeout tuning. */
  722. __OVS_CT_ATTR_MAX
  723. };
  724. #define OVS_CT_ATTR_MAX (__OVS_CT_ATTR_MAX - 1)
  725. /**
  726. * enum ovs_nat_attr - Attributes for %OVS_CT_ATTR_NAT.
  727. *
  728. * @OVS_NAT_ATTR_SRC: Flag for Source NAT (mangle source address/port).
  729. * @OVS_NAT_ATTR_DST: Flag for Destination NAT (mangle destination
  730. * address/port). Only one of (@OVS_NAT_ATTR_SRC, @OVS_NAT_ATTR_DST) may be
  731. * specified. Effective only for packets for ct_state NEW connections.
  732. * Packets of committed connections are mangled by the NAT action according to
  733. * the committed NAT type regardless of the flags specified. As a corollary, a
  734. * NAT action without a NAT type flag will only mangle packets of committed
  735. * connections. The following NAT attributes only apply for NEW
  736. * (non-committed) connections, and they may be included only when the CT
  737. * action has the @OVS_CT_ATTR_COMMIT flag and either @OVS_NAT_ATTR_SRC or
  738. * @OVS_NAT_ATTR_DST is also included.
  739. * @OVS_NAT_ATTR_IP_MIN: struct in_addr or struct in6_addr
  740. * @OVS_NAT_ATTR_IP_MAX: struct in_addr or struct in6_addr
  741. * @OVS_NAT_ATTR_PROTO_MIN: u16 L4 protocol specific lower boundary (port)
  742. * @OVS_NAT_ATTR_PROTO_MAX: u16 L4 protocol specific upper boundary (port)
  743. * @OVS_NAT_ATTR_PERSISTENT: Flag for persistent IP mapping across reboots
  744. * @OVS_NAT_ATTR_PROTO_HASH: Flag for pseudo random L4 port mapping (MD5)
  745. * @OVS_NAT_ATTR_PROTO_RANDOM: Flag for fully randomized L4 port mapping
  746. */
  747. enum ovs_nat_attr {
  748. OVS_NAT_ATTR_UNSPEC,
  749. OVS_NAT_ATTR_SRC,
  750. OVS_NAT_ATTR_DST,
  751. OVS_NAT_ATTR_IP_MIN,
  752. OVS_NAT_ATTR_IP_MAX,
  753. OVS_NAT_ATTR_PROTO_MIN,
  754. OVS_NAT_ATTR_PROTO_MAX,
  755. OVS_NAT_ATTR_PERSISTENT,
  756. OVS_NAT_ATTR_PROTO_HASH,
  757. OVS_NAT_ATTR_PROTO_RANDOM,
  758. __OVS_NAT_ATTR_MAX,
  759. };
  760. #define OVS_NAT_ATTR_MAX (__OVS_NAT_ATTR_MAX - 1)
  761. /*
  762. * struct ovs_action_push_eth - %OVS_ACTION_ATTR_PUSH_ETH action argument.
  763. * @addresses: Source and destination MAC addresses.
  764. * @eth_type: Ethernet type
  765. */
  766. struct ovs_action_push_eth {
  767. struct ovs_key_ethernet addresses;
  768. };
  769. /*
  770. * enum ovs_check_pkt_len_attr - Attributes for %OVS_ACTION_ATTR_CHECK_PKT_LEN.
  771. *
  772. * @OVS_CHECK_PKT_LEN_ATTR_PKT_LEN: u16 Packet length to check for.
  773. * @OVS_CHECK_PKT_LEN_ATTR_ACTIONS_IF_GREATER: Nested OVS_ACTION_ATTR_*
  774. * actions to apply if the packer length is greater than the specified
  775. * length in the attr - OVS_CHECK_PKT_LEN_ATTR_PKT_LEN.
  776. * @OVS_CHECK_PKT_LEN_ATTR_ACTIONS_IF_LESS_EQUAL - Nested OVS_ACTION_ATTR_*
  777. * actions to apply if the packer length is lesser or equal to the specified
  778. * length in the attr - OVS_CHECK_PKT_LEN_ATTR_PKT_LEN.
  779. */
  780. enum ovs_check_pkt_len_attr {
  781. OVS_CHECK_PKT_LEN_ATTR_UNSPEC,
  782. OVS_CHECK_PKT_LEN_ATTR_PKT_LEN,
  783. OVS_CHECK_PKT_LEN_ATTR_ACTIONS_IF_GREATER,
  784. OVS_CHECK_PKT_LEN_ATTR_ACTIONS_IF_LESS_EQUAL,
  785. __OVS_CHECK_PKT_LEN_ATTR_MAX,
  786. #ifdef __KERNEL__
  787. OVS_CHECK_PKT_LEN_ATTR_ARG /* struct check_pkt_len_arg */
  788. #endif
  789. };
  790. #define OVS_CHECK_PKT_LEN_ATTR_MAX (__OVS_CHECK_PKT_LEN_ATTR_MAX - 1)
  791. #ifdef __KERNEL__
  792. struct check_pkt_len_arg {
  793. u16 pkt_len; /* Same value as OVS_CHECK_PKT_LEN_ATTR_PKT_LEN'. */
  794. bool exec_for_greater; /* When true, actions in IF_GREATER will
  795. * not change flow keys. False otherwise.
  796. */
  797. bool exec_for_lesser_equal; /* When true, actions in IF_LESS_EQUAL
  798. * will not change flow keys. False
  799. * otherwise.
  800. */
  801. };
  802. #endif
  803. /**
  804. * enum ovs_action_attr - Action types.
  805. *
  806. * @OVS_ACTION_ATTR_OUTPUT: Output packet to port.
  807. * @OVS_ACTION_ATTR_TRUNC: Output packet to port with truncated packet size.
  808. * @OVS_ACTION_ATTR_USERSPACE: Send packet to userspace according to nested
  809. * %OVS_USERSPACE_ATTR_* attributes.
  810. * @OVS_ACTION_ATTR_SET: Replaces the contents of an existing header. The
  811. * single nested %OVS_KEY_ATTR_* attribute specifies a header to modify and its
  812. * value.
  813. * @OVS_ACTION_ATTR_SET_MASKED: Replaces the contents of an existing header. A
  814. * nested %OVS_KEY_ATTR_* attribute specifies a header to modify, its value,
  815. * and a mask. For every bit set in the mask, the corresponding bit value
  816. * is copied from the value to the packet header field, rest of the bits are
  817. * left unchanged. The non-masked value bits must be passed in as zeroes.
  818. * Masking is not supported for the %OVS_KEY_ATTR_TUNNEL attribute.
  819. * @OVS_ACTION_ATTR_PUSH_VLAN: Push a new outermost 802.1Q or 802.1ad header
  820. * onto the packet.
  821. * @OVS_ACTION_ATTR_POP_VLAN: Pop the outermost 802.1Q or 802.1ad header
  822. * from the packet.
  823. * @OVS_ACTION_ATTR_SAMPLE: Probabilitically executes actions, as specified in
  824. * the nested %OVS_SAMPLE_ATTR_* attributes.
  825. * @OVS_ACTION_ATTR_PUSH_MPLS: Push a new MPLS label stack entry onto the
  826. * top of the packets MPLS label stack. Set the ethertype of the
  827. * encapsulating frame to either %ETH_P_MPLS_UC or %ETH_P_MPLS_MC to
  828. * indicate the new packet contents.
  829. * @OVS_ACTION_ATTR_POP_MPLS: Pop an MPLS label stack entry off of the
  830. * packet's MPLS label stack. Set the encapsulating frame's ethertype to
  831. * indicate the new packet contents. This could potentially still be
  832. * %ETH_P_MPLS if the resulting MPLS label stack is not empty. If there
  833. * is no MPLS label stack, as determined by ethertype, no action is taken.
  834. * @OVS_ACTION_ATTR_CT: Track the connection. Populate the conntrack-related
  835. * entries in the flow key.
  836. * @OVS_ACTION_ATTR_PUSH_ETH: Push a new outermost Ethernet header onto the
  837. * packet.
  838. * @OVS_ACTION_ATTR_POP_ETH: Pop the outermost Ethernet header off the
  839. * packet.
  840. * @OVS_ACTION_ATTR_CT_CLEAR: Clear conntrack state from the packet.
  841. * @OVS_ACTION_ATTR_PUSH_NSH: push NSH header to the packet.
  842. * @OVS_ACTION_ATTR_POP_NSH: pop the outermost NSH header off the packet.
  843. * @OVS_ACTION_ATTR_METER: Run packet through a meter, which may drop the
  844. * packet, or modify the packet (e.g., change the DSCP field).
  845. * @OVS_ACTION_ATTR_CLONE: make a copy of the packet and execute a list of
  846. * actions without affecting the original packet and key.
  847. * @OVS_ACTION_ATTR_CHECK_PKT_LEN: Check the packet length and execute a set
  848. * of actions if greater than the specified packet length, else execute
  849. * another set of actions.
  850. * @OVS_ACTION_ATTR_ADD_MPLS: Push a new MPLS label stack entry at the
  851. * start of the packet or at the start of the l3 header depending on the value
  852. * of l3 tunnel flag in the tun_flags field of OVS_ACTION_ATTR_ADD_MPLS
  853. * argument.
  854. *
  855. * Only a single header can be set with a single %OVS_ACTION_ATTR_SET. Not all
  856. * fields within a header are modifiable, e.g. the IPv4 protocol and fragment
  857. * type may not be changed.
  858. *
  859. * @OVS_ACTION_ATTR_SET_TO_MASKED: Kernel internal masked set action translated
  860. * from the @OVS_ACTION_ATTR_SET.
  861. */
  862. enum ovs_action_attr {
  863. OVS_ACTION_ATTR_UNSPEC,
  864. OVS_ACTION_ATTR_OUTPUT, /* u32 port number. */
  865. OVS_ACTION_ATTR_USERSPACE, /* Nested OVS_USERSPACE_ATTR_*. */
  866. OVS_ACTION_ATTR_SET, /* One nested OVS_KEY_ATTR_*. */
  867. OVS_ACTION_ATTR_PUSH_VLAN, /* struct ovs_action_push_vlan. */
  868. OVS_ACTION_ATTR_POP_VLAN, /* No argument. */
  869. OVS_ACTION_ATTR_SAMPLE, /* Nested OVS_SAMPLE_ATTR_*. */
  870. OVS_ACTION_ATTR_RECIRC, /* u32 recirc_id. */
  871. OVS_ACTION_ATTR_HASH, /* struct ovs_action_hash. */
  872. OVS_ACTION_ATTR_PUSH_MPLS, /* struct ovs_action_push_mpls. */
  873. OVS_ACTION_ATTR_POP_MPLS, /* __be16 ethertype. */
  874. OVS_ACTION_ATTR_SET_MASKED, /* One nested OVS_KEY_ATTR_* including
  875. * data immediately followed by a mask.
  876. * The data must be zero for the unmasked
  877. * bits. */
  878. OVS_ACTION_ATTR_CT, /* Nested OVS_CT_ATTR_* . */
  879. OVS_ACTION_ATTR_TRUNC, /* u32 struct ovs_action_trunc. */
  880. OVS_ACTION_ATTR_PUSH_ETH, /* struct ovs_action_push_eth. */
  881. OVS_ACTION_ATTR_POP_ETH, /* No argument. */
  882. OVS_ACTION_ATTR_CT_CLEAR, /* No argument. */
  883. OVS_ACTION_ATTR_PUSH_NSH, /* Nested OVS_NSH_KEY_ATTR_*. */
  884. OVS_ACTION_ATTR_POP_NSH, /* No argument. */
  885. OVS_ACTION_ATTR_METER, /* u32 meter ID. */
  886. OVS_ACTION_ATTR_CLONE, /* Nested OVS_CLONE_ATTR_*. */
  887. OVS_ACTION_ATTR_CHECK_PKT_LEN, /* Nested OVS_CHECK_PKT_LEN_ATTR_*. */
  888. OVS_ACTION_ATTR_ADD_MPLS, /* struct ovs_action_add_mpls. */
  889. OVS_ACTION_ATTR_DEC_TTL, /* Nested OVS_DEC_TTL_ATTR_*. */
  890. __OVS_ACTION_ATTR_MAX, /* Nothing past this will be accepted
  891. * from userspace. */
  892. #ifdef __KERNEL__
  893. OVS_ACTION_ATTR_SET_TO_MASKED, /* Kernel module internal masked
  894. * set action converted from
  895. * OVS_ACTION_ATTR_SET. */
  896. #endif
  897. };
  898. #define OVS_ACTION_ATTR_MAX (__OVS_ACTION_ATTR_MAX - 1)
  899. /* Meters. */
  900. #define OVS_METER_FAMILY "ovs_meter"
  901. #define OVS_METER_MCGROUP "ovs_meter"
  902. #define OVS_METER_VERSION 0x1
  903. enum ovs_meter_cmd {
  904. OVS_METER_CMD_UNSPEC,
  905. OVS_METER_CMD_FEATURES, /* Get features supported by the datapath. */
  906. OVS_METER_CMD_SET, /* Add or modify a meter. */
  907. OVS_METER_CMD_DEL, /* Delete a meter. */
  908. OVS_METER_CMD_GET /* Get meter stats. */
  909. };
  910. enum ovs_meter_attr {
  911. OVS_METER_ATTR_UNSPEC,
  912. OVS_METER_ATTR_ID, /* u32 meter ID within datapath. */
  913. OVS_METER_ATTR_KBPS, /* No argument. If set, units in kilobits
  914. * per second. Otherwise, units in
  915. * packets per second.
  916. */
  917. OVS_METER_ATTR_STATS, /* struct ovs_flow_stats for the meter. */
  918. OVS_METER_ATTR_BANDS, /* Nested attributes for meter bands. */
  919. OVS_METER_ATTR_USED, /* u64 msecs last used in monotonic time. */
  920. OVS_METER_ATTR_CLEAR, /* Flag to clear stats, used. */
  921. OVS_METER_ATTR_MAX_METERS, /* u32 number of meters supported. */
  922. OVS_METER_ATTR_MAX_BANDS, /* u32 max number of bands per meter. */
  923. OVS_METER_ATTR_PAD,
  924. __OVS_METER_ATTR_MAX
  925. };
  926. #define OVS_METER_ATTR_MAX (__OVS_METER_ATTR_MAX - 1)
  927. enum ovs_band_attr {
  928. OVS_BAND_ATTR_UNSPEC,
  929. OVS_BAND_ATTR_TYPE, /* u32 OVS_METER_BAND_TYPE_* constant. */
  930. OVS_BAND_ATTR_RATE, /* u32 band rate in meter units (see above). */
  931. OVS_BAND_ATTR_BURST, /* u32 burst size in meter units. */
  932. OVS_BAND_ATTR_STATS, /* struct ovs_flow_stats for the band. */
  933. __OVS_BAND_ATTR_MAX
  934. };
  935. #define OVS_BAND_ATTR_MAX (__OVS_BAND_ATTR_MAX - 1)
  936. enum ovs_meter_band_type {
  937. OVS_METER_BAND_TYPE_UNSPEC,
  938. OVS_METER_BAND_TYPE_DROP, /* Drop exceeding packets. */
  939. __OVS_METER_BAND_TYPE_MAX
  940. };
  941. #define OVS_METER_BAND_TYPE_MAX (__OVS_METER_BAND_TYPE_MAX - 1)
  942. /* Conntrack limit */
  943. #define OVS_CT_LIMIT_FAMILY "ovs_ct_limit"
  944. #define OVS_CT_LIMIT_MCGROUP "ovs_ct_limit"
  945. #define OVS_CT_LIMIT_VERSION 0x1
  946. enum ovs_ct_limit_cmd {
  947. OVS_CT_LIMIT_CMD_UNSPEC,
  948. OVS_CT_LIMIT_CMD_SET, /* Add or modify ct limit. */
  949. OVS_CT_LIMIT_CMD_DEL, /* Delete ct limit. */
  950. OVS_CT_LIMIT_CMD_GET /* Get ct limit. */
  951. };
  952. enum ovs_ct_limit_attr {
  953. OVS_CT_LIMIT_ATTR_UNSPEC,
  954. OVS_CT_LIMIT_ATTR_ZONE_LIMIT, /* Nested struct ovs_zone_limit. */
  955. __OVS_CT_LIMIT_ATTR_MAX
  956. };
  957. #define OVS_CT_LIMIT_ATTR_MAX (__OVS_CT_LIMIT_ATTR_MAX - 1)
  958. #define OVS_ZONE_LIMIT_DEFAULT_ZONE -1
  959. struct ovs_zone_limit {
  960. int zone_id;
  961. __u32 limit;
  962. __u32 count;
  963. };
  964. enum ovs_dec_ttl_attr {
  965. OVS_DEC_TTL_ATTR_UNSPEC,
  966. OVS_DEC_TTL_ATTR_ACTION, /* Nested struct nlattr */
  967. __OVS_DEC_TTL_ATTR_MAX
  968. };
  969. #define OVS_DEC_TTL_ATTR_MAX (__OVS_DEC_TTL_ATTR_MAX - 1)
  970. #endif /* _LINUX_OPENVSWITCH_H */