ofp.h revision 1.4
1/*	$OpenBSD: ofp.h,v 1.4 2016/11/18 11:55:02 rzalamena Exp $	*/
2
3/*
4 * Copyright (c) 2013-2016 Reyk Floeter <reyk@openbsd.org>
5 * Copyright (c) 2016 Kazuya GODA <goda@openbsd.org>
6 *
7 * Permission to use, copy, modify, and distribute this software for any
8 * purpose with or without fee is hereby granted, provided that the above
9 * copyright notice and this permission notice appear in all copies.
10 *
11 * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
12 * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
13 * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
14 * ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
15 * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
16 * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
17 * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
18 */
19
20#ifndef _NET_OFP_H_
21#define _NET_OFP_H_
22
23#include <sys/types.h>
24#include <sys/socket.h>
25
26#include <net/if.h>
27#include <netinet/in.h>
28#include <netinet/if_ether.h>
29
30#define OFP_IFNAMSIZ	16	/* on-wire (not IF_NAMSIZE) */
31#define OFP_ALIGNMENT	8	/* OFP alignment */
32#define OFP_ALIGN(_x)	(((_x) + (OFP_ALIGNMENT - 1)) & ~(OFP_ALIGNMENT - 1))
33
34struct ofp_header {
35	uint8_t		 oh_version;		/* OpenFlow version */
36	uint8_t		 oh_type;		/* message type */
37	uint16_t	 oh_length;		/* message length */
38	uint32_t	 oh_xid;		/* transaction Id */
39} __packed;
40
41/* OpenFlow version */
42#define OFP_V_0				0x00	/* OpenFlow 0.0 */
43#define OFP_V_1_0			0x01	/* OpenFlow 1.0 */
44#define OFP_V_1_1			0x02	/* OpenFlow 1.1 */
45#define OFP_V_1_2			0x03	/* OpenFlow 1.2 */
46#define OFP_V_1_3			0x04	/* OpenFlow 1.3 */
47#define OFP_V_1_4			0x05	/* OpenFlow 1.4 */
48#define OFP_V_1_5			0x06	/* OpenFlow 1.5 */
49
50/* OpenFlow message type */
51#define OFP_T_HELLO			0	/* Hello */
52#define OFP_T_ERROR			1	/* Error */
53#define OFP_T_ECHO_REQUEST		2	/* Echo Request */
54#define OFP_T_ECHO_REPLY		3	/* Echo Reply */
55#define OFP_T_EXPERIMENTER		4	/* Vendor/Experimenter */
56#define OFP_T_FEATURES_REQUEST		5	/* Features Request (switch) */
57#define OFP_T_FEATURES_REPLY		6	/* Features Reply (switch) */
58#define OFP_T_GET_CONFIG_REQUEST	7	/* Get Config Request (switch) */
59#define OFP_T_GET_CONFIG_REPLY		8	/* Get Config Reply (switch) */
60#define OFP_T_SET_CONFIG		9	/* Set Config (switch) */
61#define OFP_T_PACKET_IN			10	/* Packet In (async) */
62#define OFP_T_FLOW_REMOVED		11	/* Flow Removed (async) */
63#define OFP_T_PORT_STATUS		12	/* Port Status (async) */
64#define OFP_T_PACKET_OUT		13	/* Packet Out (controller) */
65#define OFP_T_FLOW_MOD			14	/* Flow Mod (controller) */
66#define OFP_T_GROUP_MOD			15	/* Group Mod (controller) */
67#define OFP_T_PORT_MOD			16	/* Port Mod (controller) */
68#define OFP_T_TABLE_MOD			17	/* Table Mod (controller) */
69#define OFP_T_MULTIPART_REQUEST		18	/* Multipart Message Request */
70#define OFP_T_MULTIPART_REPLY		19	/* Multipart Message Request */
71#define OFP_T_BARRIER_REQUEST		20	/* Barrier Request */
72#define OFP_T_BARRIER_REPLY		21	/* Barrier Reply */
73#define OFP_T_QUEUE_GET_CONFIG_REQUEST	22	/* Queue Get Config Request */
74#define OFP_T_QUEUE_GET_CONFIG_REPLY	23	/* Queue Get Config Reply */
75#define OFP_T_ROLE_REQUEST		24	/* Role Request */
76#define OFP_T_ROLE_REPLY		25	/* Role Reply */
77#define OFP_T_GET_ASYNC_REQUEST		26	/* Get Async Request */
78#define OFP_T_GET_ASYNC_REPLY		27	/* Get Async Reply */
79#define OFP_T_SET_ASYNC			28	/* Set Async */
80#define OFP_T_METER_MOD			29	/* Meter Mod */
81#define OFP_T_TYPE_MAX			30
82
83/* OpenFlow Hello Message */
84struct ofp_hello_element_header {
85	uint16_t	he_type;
86	uint16_t	he_length;
87} __packed;
88
89#define OPF_HELLO_T_VERSION_BITMAP	1	/* Supported version bitmap */
90
91struct ofp_hello_element_versionbitmap {
92	uint16_t	hev_type;
93	uint16_t	hev_length;
94} __packed;
95
96/* Ports */
97#define OFP_PORT_MAX		0xffffff00	/* Maximum number of physical ports */
98#define	OFP_PORT_INPUT		0xfffffff8	/* Send back to input port */
99#define OFP_PORT_FLOWTABLE	0xfffffff9	/* Perform actions in flow table */
100#define OFP_PORT_NORMAL		0xfffffffa	/* Let switch decide */
101#define OFP_PORT_FLOOD		0xfffffffb	/* All non-block ports except input */
102#define OFP_PORT_ALL		0xfffffffc	/* All ports except input */
103#define OFP_PORT_CONTROLLER	0xfffffffd	/* Send to controller */
104#define OFP_PORT_LOCAL		0xfffffffe	/* Local virtual OpenFlow port */
105#define OFP_PORT_ANY		0xffffffff	/* No port */
106
107/* Switch Config Message (reply) */
108struct ofp_switch_config {
109	struct ofp_header	cfg_oh;		/* OpenFlow header */
110	uint16_t		cfg_flags;	/* Configuration flags */
111	uint16_t		cfg_miss_send_len; /* Max bytes from datapath */
112} __packed;
113
114/* Switch Config */
115#define OFP_CONFIG_FRAG_NORMAL	0x0000		/* No special frag handling */
116#define OFP_CONFIG_FRAG_DROP	0x0001		/* Drop fragments */
117#define OFP_CONFIG_FRAG_REASM	0x0002		/* Reassemble fragments */
118#define OFP_CONFIG_FRAG_MASK	0x0003		/* Fragment mask */
119
120/* Switch port description */
121struct ofp_switch_port {
122	uint32_t	swp_number;		/* Switch port number */
123	uint8_t		swp_pad[4];		/* Padding */
124	uint8_t		swp_macaddr[ETHER_ADDR_LEN]; /* Port MAC address */
125	uint8_t		swp_pad2[2];		/* Padding */
126	char		swp_name[OFP_IFNAMSIZ];	/* Switch port name */
127	uint32_t	swp_config;		/* Configuration flags */
128	uint32_t	swp_state;		/* State flags */
129	uint32_t	swp_cur;		/* Current features */
130	uint32_t	swp_advertised;		/* Advertised by the port */
131	uint32_t	swp_supported;		/* Supported by the port */
132	uint32_t	swp_peer;		/* Advertised by peer */
133	uint32_t	swp_cur_speed;		/* Current port speed in Kbps*/
134	uint32_t	swp_max_speed;		/* Support port max speed in Kbps*/
135} __packed;
136
137/* Physical port configuration */
138#define OFP_PORTCONFIG_PORT_DOWN	0x1	/* Port is down */
139#define OFP_PORTCONFIG_NO_STP		0x2	/* Disable STP on port */
140#define OFP_PORTCONFIG_NO_RECV		0x4	/* Drop everything except STP */
141#define OFP_PORTCONFIG_NO_RECV_STP	0x8	/* Drop received STP */
142#define OFP_PORTCONFIG_NO_FLOOD		0x10	/* Do not flood to this port */
143#define OFP_PORTCONFIG_NO_FWD		0x20	/* Drop packets to port */
144#define OFP_PORTCONFIG_NO_PACKET_IN	0x40	/* NO PACKET_IN on port */
145
146/* Physical port state */
147#define OFP_PORTSTATE_LINK_DOWN		0x1	/* Link not active */
148#define OFP_PORTSTATE_STP_LISTEN	0x000	/* Not learning or forwarding */
149#define OFP_PORTSTATE_STP_LEARN		0x100	/* Learning but not forwarding */
150#define OFP_PORTSTATE_STP_FORWARD	0x200	/* Learning and forwarding */
151#define OFP_PORTSTATE_STP_BLOCK		0x300	/* Not part of spanning tree */
152#define OFP_PORTSTATE_STP_MASK		0x300	/* Spanning tree values */
153
154/* Physical port media types */
155#define OFP_PORTMEDIA_10MB_HD		0x1	/* 10 Mb half-duplex */
156#define OFP_PORTMEDIA_10MB_FD		0x2	/* 10 Mb full-duplex */
157#define OFP_PORTMEDIA_100MB_HD		0x4	/* 100 Mb half-duplex */
158#define OFP_PORTMEDIA_100MB_FD		0x8	/* 100 Mb full-duplex */
159#define OFP_PORTMEDIA_1GB_HD		0x10    /* 1 Gb half-duplex */
160#define OFP_PORTMEDIA_1GB_FD		0x20    /* 1 Gb full-duplex */
161#define OFP_PORTMEDIA_10GB_FD		0x40    /* 10 Gb full-duplex */
162#define OFP_PORTMEDIA_COPPER		0x80    /* Copper */
163#define OFP_PORTMEDIA_FIBER		0x100   /* Fiber */
164#define OFP_PORTMEDIA_AUTONEG		0x200   /* Auto-negotiation */
165#define OFP_PORTMEDIA_PAUSE		0x400   /* Pause */
166#define OFP_PORTMEDIA_PAUSE_ASYM	0x800	/* Asymmetric pause */
167
168/* Switch Features Message (reply) */
169struct ofp_switch_features {
170	struct ofp_header	swf_oh;		/* OpenFlow header */
171	uint64_t		swf_datapath_id; /* Datapath unique ID */
172	uint32_t		swf_nbuffers;	/* Max packets buffered */
173	uint8_t			swf_ntables;	/* Number of supported tables */
174	uint8_t			swf_aux_id;	/* Identify auxiliary connections */
175	uint8_t			swf_pad[2];	/* Align to 64 bits */
176	uint32_t		swf_capabilities; /* Capability flags */
177	uint32_t		swf_actions;	/* Supported action flags */
178} __packed;
179
180/* Switch capabilities */
181#define OFP_SWCAP_FLOW_STATS		0x1	/* Flow statistics */
182#define OFP_SWCAP_TABLE_STATS		0x2	/* Table statistics */
183#define OFP_SWCAP_PORT_STATS		0x4	/* Port statistics */
184#define OFP_SWCAP_GROUP_STATS		0x8	/* Group statistics */
185#define OFP_SWCAP_IP_REASM		0x20	/* Can reassemble IP frags */
186#define OFP_SWCAP_QUEUE_STATS		0x40	/* Queue statistics */
187#define OFP_SWCAP_ARP_MATCH_IP		0x80	/* Match IP addresses in ARP pkts */
188#define OFP_SWCAP_PORT_BLOCKED		0x100	/* Switch will block ports */
189
190/* Flow matching */
191struct ofp_match {
192	uint16_t	om_type;
193	uint16_t	om_length;
194} __packed;
195
196/* Flow matching type type */
197#define OFP_MATCH_STANDARD		0	/* Standard match deprecated */
198#define OFP_MATCH_OXM			1	/* OpenFlow Extensible Match */
199
200/* Packet-In Message */
201struct ofp_packet_in {
202	struct ofp_header	pin_oh;		/* OpenFlow header */
203	uint32_t		pin_buffer_id;
204	uint16_t		pin_total_len;
205	uint8_t			pin_reason;
206	uint8_t			pin_table_id;
207	uint64_t		pin_cookie;
208	struct ofp_match	pin_match;
209} __packed;
210
211/* Reason */
212#define	OFP_PKTIN_REASON_NO_MATCH	0	/* No matching flow */
213#define	OFP_PKTIN_REASON_ACTION		1	/* Explicit output */
214#define	OFP_PKTIN_REASON_TTL		2	/* Packet has invalid TTL */
215
216/* Flow Instruction */
217struct ofp_instruction {
218	uint16_t	i_type;
219	uint16_t	i_len;
220} __packed;
221
222/* Instruction types */
223#define OFP_INSTRUCTION_T_GOTO_TABLE	1	/* Goto-Table */
224#define OFP_INSTRUCTION_T_WRITE_META	2	/* Write-Metadata */
225#define OFP_INSTRUCTION_T_WRITE_ACTIONS	3	/* Write-Actions */
226#define OFP_INSTRUCTION_T_APPLY_ACTIONS	4	/* Apply-Actions */
227#define OFP_INSTRUCTION_T_CLEAR_ACTIONS	5	/* Clear-Actions */
228#define OFP_INSTRUCTION_T_METER		6	/* Meter */
229#define OFP_INSTRUCTION_T_EXPERIMENTER	0xffff	/* Experimenter */
230
231/* Write-Metadata instruction */
232struct ofp_instruction_write_metadata {
233	uint16_t	iwm_type;
234	uint16_t	iwm_len;
235	uint8_t		iwm_pad[4];
236	uint64_t	iwm_metadata;
237	uint64_t	iwm_metadata_mask;
238} __packed;
239
240/* Goto-Table instruction */
241struct ofp_instruction_goto_table {
242	uint16_t	igt_type;
243	uint16_t	igt_len;
244	uint8_t		igt_table_id;
245	uint8_t		igt_pad[3];
246} __packed;
247
248/* Apply-Actions instruction */
249struct ofp_instruction_actions {
250	uint16_t	ia_type;
251	uint16_t	ia_len;
252	uint8_t		ia_pad[4];
253} __packed;
254
255/* Meter instruction */
256struct ofp_instruction_meter {
257	uint16_t	im_type;
258	uint16_t	im_len;
259	uint32_t	im_meter_id;
260} __packed;
261
262/* Experimenter instruction */
263struct ofp_instruction_experimenter {
264	uint16_t	ie_type;
265	uint16_t	ie_len;
266	uint32_t	ie_experimenter;
267} __packed;
268
269/* Actions */
270#define OFP_ACTION_OUTPUT		0	/* Output to switch port */
271#define OFP_ACTION_COPY_TTL_OUT		11	/* Copy TTL outwards */
272#define OFP_ACTION_COPY_TTL_IN		12	/* Copy TTL inwards */
273#define OFP_ACTION_SET_MPLS_TTL		15	/* MPLS TTL */
274#define OFP_ACTION_DEC_MPLS_TTL		16	/* Decrement MPLS TTL */
275#define OFP_ACTION_PUSH_VLAN		17	/* Push a new VLAN tag */
276#define OFP_ACTION_POP_VLAN		18	/* Pop the outer VLAN tag */
277#define OFP_ACTION_PUSH_MPLS		19	/* Push a new MPLS tag */
278#define OFP_ACTION_POP_MPLS		20	/* Pop the outer MPLS tag */
279#define OFP_ACTION_SET_QUEUE		21	/* Set queue id when outputing to a port */
280#define OFP_ACTION_GROUP		22	/* Apply group */
281#define OFP_ACTION_SET_NW_TTL		23	/* Set IP TTL */
282#define OFP_ACTION_DEC_NW_TTL		24	/* Decrement IP TTL */
283#define OFP_ACTION_SET_FIELD		25	/* Set a header field using OXM TLV format */
284#define OFP_ACTION_PUSH_PBB		26	/* Push a new PBB service tag (I-TAG) */
285#define OFP_ACTION_POP_PBB		27	/* Pop the outer PBB service tag (I-TAG) */
286#define OFP_ACTION_EXPERIMENTER		0xffff	/* Vendor-specific action */
287
288/* Action Header */
289struct ofp_action_header {
290	uint16_t	ah_type;
291	uint16_t	ah_len;
292	uint32_t	ah_pad;
293} __packed;
294
295#define OFP_CONTROLLER_MAXLEN_MAX	0xffe5
296#define OFP_CONTROLLER_MAXLEN_NO_BUFFER	0xffff
297
298/* Output Action */
299struct ofp_action_output {
300	uint16_t	ao_type;
301	uint16_t	ao_len;
302	uint32_t	ao_port;
303	uint16_t	ao_max_len;
304	uint8_t		ao_pad[6];
305} __packed;
306
307struct ofp_action_mpls_ttl {
308	uint16_t	amt_type;
309	uint16_t	amt_len;
310	uint8_t		amt_ttl;
311	uint8_t		amt_pad[3];
312} __packed;
313
314struct ofp_action_push {
315	uint16_t	ap_type;
316	uint16_t	ap_len;
317	uint16_t	ap_ethertype;
318	uint8_t		ap_pad[2];
319} __packed;
320
321struct ofp_action_pop_mpls {
322	uint16_t	apm_type;
323	uint16_t	apm_len;
324	uint16_t	apm_ethertype;
325	uint8_t		apm_pad[2];
326} __packed;
327
328struct ofp_action_group {
329	uint16_t	ag_type;
330	uint16_t	ag_len;
331	uint32_t	ag_group_id;
332} __packed;
333
334struct ofp_action_nw_ttl {
335	uint16_t	ant_type;
336	uint16_t	ant_len;
337	uint8_t		ant_ttl;
338	uint8_t		ant_pad[3];
339} __packed;
340
341struct ofp_action_set_field {
342	uint16_t	asf_type;
343	uint16_t	asf_len;
344	uint8_t		asf_field[4];
345} __packed;
346
347struct ofp_action_set_queue {
348	uint16_t	asq_type;
349	uint16_t	asq_len;
350	uint32_t	asq_queue_id;
351} __packed;
352
353/* Packet-Out Message */
354struct ofp_packet_out {
355	struct ofp_header	pout_oh;	/* OpenFlow header */
356	uint32_t		pout_buffer_id;
357	uint32_t		pout_in_port;
358	uint16_t		pout_actions_len;
359	uint8_t			pout_pad[6];
360	struct ofp_action_header pout_actions[0];
361	/* Followed by optional packet data if buffer_id == 0xffffffff */
362} __packed;
363
364#define OFP_PKTOUT_NO_BUFFER		0xffffffff
365
366/* Flow match fields for basic class */
367#define OFP_XM_T_IN_PORT		0	/* Switch input port */
368#define OFP_XM_T_IN_PHY_PORT		1	/* Switch physical input port */
369#define OFP_XM_T_META			2	/* Metadata passed between tables */
370#define OFP_XM_T_ETH_DST		3	/* Ethernet destination address */
371#define OFP_XM_T_ETH_SRC		4	/* Ethernet source address */
372#define OFP_XM_T_ETH_TYPE		5	/* Ethernet frame type */
373#define OFP_XM_T_VLAN_VID		6	/* VLAN id */
374#define OFP_XM_T_VLAN_PCP		7	/* VLAN priority */
375#define OFP_XM_T_IP_DSCP		8	/* IP DSCP (6 bits in ToS field) */
376#define OFP_XM_T_IP_ECN			9	/* IP ECN (2 bits in ToS field) */
377#define OFP_XM_T_IP_PROTO		10	/* IP protocol */
378#define OFP_XM_T_IPV4_SRC		11	/* IPv4 source address */
379#define OFP_XM_T_IPV4_DST		12	/* IPv4 destination address */
380#define OFP_XM_T_TCP_SRC		13	/* TCP source port */
381#define OFP_XM_T_TCP_DST		14	/* TCP destination port */
382#define OFP_XM_T_UDP_SRC		15	/* UDP source port */
383#define OFP_XM_T_UDP_DST		16	/* UDP destination port */
384#define OFP_XM_T_SCTP_SRC		17	/* SCTP source port */
385#define OFP_XM_T_SCTP_DST		18	/* SCTP destination port */
386#define OFP_XM_T_ICMPV4_TYPE		19	/* ICMP type */
387#define OFP_XM_T_ICMPV4_CODE		20	/* ICMP code */
388#define OFP_XM_T_ARP_OP			21	/* ARP opcode */
389#define OFP_XM_T_ARP_SPA		22	/* ARP source IPv4 address */
390#define OFP_XM_T_ARP_TPA		23	/* ARP target IPv4 address */
391#define OFP_XM_T_ARP_SHA		24	/* ARP source hardware address */
392#define OFP_XM_T_ARP_THA		25	/* ARP target hardware address */
393#define OFP_XM_T_IPV6_SRC		26	/* IPv6 source address */
394#define OFP_XM_T_IPV6_DST		27	/* IPv6 destination address */
395#define OFP_XM_T_IPV6_FLABEL		28	/* IPv6 Flow Label */
396#define OFP_XM_T_ICMPV6_TYPE		29	/* ICMPv6 type */
397#define OFP_XM_T_ICMPV6_CODE		30	/* ICMPv6 code */
398#define OFP_XM_T_IPV6_ND_TARGET		31	/* Target address for ND */
399#define OFP_XM_T_IPV6_ND_SLL		32	/* Source link-layer for ND */
400#define OFP_XM_T_IPV6_ND_TLL		33	/* Target link-layer for ND */
401#define OFP_XM_T_MPLS_LABEL		34	/* MPLS label */
402#define OFP_XM_T_MPLS_TC		35	/* MPLS TC */
403#define OFP_XM_T_MPLS_BOS		36	/* MPLS BoS bit */
404#define OFP_XM_T_PBB_ISID		37	/* PBB I-SID */
405#define OFP_XM_T_TUNNEL_ID		38	/* Logical Port Metadata */
406#define OFP_XM_T_IPV6_EXTHDR		39	/* IPv6 Extension Header pseudo-field */
407#define OFP_XM_T_MAX			40	/* ? */
408
409/* Flow match fields for nxm1 class */
410#define OFP_XM_NXMT_TUNNEL_ID		38	/* ? */
411#define OFP_XM_NXMT_TUNNEL_IPV4_SRC	31	/* ? */
412#define OFP_XM_NXMT_TUNNEL_IPV4_DST	32	/* ? */
413#define OFP_XM_NXMT_TUNNEL_IPV6_SRC	109	/* ? */
414#define OFP_XM_NXMT_TUNNEL_IPV6_DST	110	/* ? */
415
416/* OXM class */
417#define OFP_OXM_C_NXM_0			0x0000	/* NXM 0 */
418#define OFP_OXM_C_NXM_1			0x0001	/* NXM 1 */
419#define OFP_OXM_C_OPENFLOW_BASIC	0x8000	/* OpenFlow Basic */
420#define OFP_OXM_C_OPENFLOW_EXPERIMENTER	0xffff	/* OpenFlow Experimenter */
421
422/* VLAN matching flag */
423#define OFP_XM_VID_PRESENT		0x1000	/* VLAN ID present */
424#define OFP_XM_VID_NONE			0x0000	/* No VLAN ID */
425
426#define OFP_XM_IPV6_EXTHDR_NONEXT	0x0001
427#define OFP_XM_IPV6_EXTHDR_ESP		0x0002
428#define OFP_XM_IPV6_EXTHDR_AUTH		0x0004
429#define OFP_XM_IPV6_EXTHDR_DEST		0x0008
430#define OFP_XM_IPV6_EXTHDR_FRAG		0x0010
431#define OFP_XM_IPV6_EXTHDR_ROUTER	0x0020
432#define OFP_XM_IPV6_EXTHDR_HOP		0x0040
433#define OFP_XM_IPV6_EXTHDR_UNREP	0x0080
434#define OFP_XM_IPV6_EXTHDR_UNSEQ	0x0100
435
436struct ofp_ox_match {
437	uint16_t	oxm_class;
438	uint8_t		oxm_fh;
439	uint8_t		oxm_length;
440	uint8_t		oxm_value[0];
441} __packed;
442
443#define OFP_OXM_GET_FIELD(o)	(((o)->oxm_fh) >> 1)
444#define OFP_OXM_GET_HASMASK(o)	(((o)->oxm_fh) & 0x1)
445#define OFP_OXM_SET_FIELD(o, t)	(((o)->oxm_fh) = ((t) << 1))
446#define OFP_OXM_SET_HASMASK(o)	(((o)->oxm_fh) |= 0x1)
447
448/* Flow modification commands */
449#define OFP_FLOWCMD_ADD			0	/* Add new flow */
450#define OFP_FLOWCMD_MODIFY		1	/* Modify flow */
451#define OFP_FLOWCMD_MODIFY_STRICT	2	/* Modify flow w/o wildcard */
452#define OFP_FLOWCMD_DELETE		3	/* Delete flow */
453#define OFP_FLOWCMD_DELETE_STRICT	4	/* Delete flow w/o wildcard */
454
455/* Flow modification flags */
456#define OFP_FLOWFLAG_SEND_FLOW_REMOVED	0x0001	/* Send flow removed message */
457#define OFP_FLOWFLAG_CHECK_OVERLAP	0x0002	/* Check flow overlap first */
458#define OFP_FLOWFLAG_RESET_COUNTS	0x0004	/* Reset flow packet and byte counters */
459#define OFP_FLOWFLAG_NO_PACKET_COUNTS	0x0008	/* Don't keep track of packet count */
460#define OFP_FLOWFLAG_NO_BYTE_COUNTS	0x0010	/* Don't keep track of byte count */
461
462/* Flow modification message */
463struct ofp_flow_mod {
464	struct ofp_header	fm_oh;		/* OpenFlow header */
465	uint64_t		fm_cookie;
466	uint64_t		fm_cookie_mask;
467	uint8_t			fm_table_id;
468	uint8_t			fm_command;
469	uint16_t		fm_idle_timeout;
470	uint16_t		fm_hard_timeout;
471	uint16_t		fm_priority;
472	uint32_t		fm_buffer_id;
473	uint32_t		fm_out_port;
474	uint32_t		fm_out_group;
475	uint16_t		fm_flags;
476	uint8_t			fm_pad[2];
477	struct ofp_match	fm_match;
478} __packed;
479
480/* Flow removed reasons */
481#define OFP_FLOWREM_REASON_IDLE_TIMEOUT	0	/* Flow idle time exceeded idle_timeout */
482#define OFP_FLOWREM_REASON_HARD_TIMEOUT	1	/* Time exceeded hard_timeout */
483#define OFP_FLOWREM_REASON_DELETE	2	/* Evicted by a DELETE flow mod */
484#define OFP_FLOWREM_REASON_GROUP_DELETE	3	/* Group was removed */
485
486/* Flow removed message */
487struct ofp_flow_removed {
488	struct ofp_header	fr_oh;
489	uint64_t		fr_cookie;
490	uint16_t		fr_priority;
491	uint8_t			fr_reason;
492	uint8_t			fr_table_id;
493	uint32_t		fr_duration_sec;
494	uint32_t		fr_duration_nsec;
495	uint16_t		fr_idle_timeout;
496	uint16_t		fr_hard_timeout;
497	uint64_t		fr_packet_count;
498	uint64_t		fr_byte_count;
499	struct ofp_match	fr_match;
500} __packed;
501
502/* Error message */
503struct ofp_error {
504	struct ofp_header	err_oh;
505	uint16_t		err_type;
506	uint16_t		err_code;
507	uint8_t			err_data[0];
508	/* Followed by optional data */
509} __packed;
510#define OFP_ERRDATA_MAX			64
511
512/* Error types */
513#define OFP_ERRTYPE_HELLO_FAILED	0	/* Hello protocol failed */
514#define OFP_ERRTYPE_BAD_REQUEST		1	/* Request was not understood */
515#define OFP_ERRTYPE_BAD_ACTION		2	/* Error in action */
516#define OFP_ERRTYPE_BAD_INSTRUCTION	3	/* Error in instruction list */
517#define OFP_ERRTYPE_BAD_MATCH		4	/* Error in match */
518#define OFP_ERRTYPE_FLOW_MOD_FAILED	5	/* Problem modifying flow */
519#define OFP_ERRTYPE_GROUP_MOD_FAILED	6	/* Problem modifying group */
520#define OFP_ERRTYPE_PORT_MOD_FAILED	7	/* Port mod request failed */
521#define OFP_ERRTYPE_TABLE_MOD_FAILED	8	/* Port mod request failed */
522#define OFP_ERRTYPE_QUEUE_OP_FAILED	9	/* Queue operation failed */
523#define OFP_ERRTYPE_SWITCH_CFG_FAILED	10	/* Switch Config request failed */
524#define OFP_ERRTYPE_ROLE_REQUEST_FAILED	11	/* Controller role request failed */
525#define OFP_ERRTYPE_METER_MOD_FAILED	12	/* Error in meter */
526#define OFP_ERRTYPE_TABLE_FEATURES_FAILED 13	/* Setting table features failed */
527#define OFP_ERRTYPE_EXPERIMENTER	0xffff	/* Experimenter error message */
528
529/* HELLO error codes */
530#define OFP_ERRHELLO_INCOMPATIBLE	0	/* No compatible version */
531#define OFP_ERRHELLO_EPERM		1	/* Permissions error */
532
533/* REQUEST error codes */
534#define OFP_ERRREQ_VERSION		0	/* Version not supported  */
535#define OFP_ERRREQ_TYPE			1	/* Type not supported  */
536#define OFP_ERRREQ_MULTIPART		2	/* Multipart type not supported */
537#define OFP_ERRREQ_EXPERIMENTER		3	/* Experimenter id not supported */
538#define OFP_ERRREQ_EXP_TYPE		4	/* Experimenter type not supported  */
539#define OFP_ERRREQ_EPERM		5	/* Permission error */
540#define OFP_ERRREQ_LEN			6	/* Wrong request length for type */
541#define OFP_ERRREQ_BUFFER_EMPTY		7	/* Specified buffer has already been used */
542#define OFP_ERRREQ_BUFFER_UNKNOWN	8	/* Specified buffer does not exist */
543#define OFP_ERRREQ_TABLE_ID		9	/* Specified table-id invalid or does not exit */
544#define OFP_ERRREQ_IS_SLAVE		10	/* Denied because controller is slave */
545#define OFP_ERRREQ_PORT			11	/* Invalid port */
546#define OFP_ERRREQ_PACKET		12	/* Invalid packet in packet-out */
547#define OFP_ERRREQ_MULTIPART_OVERFLOW	13	/* Multipart overflowed the assigned buffer */
548
549/* ACTION error codes */
550#define OFP_ERRACTION_TYPE		0	/* Unknown or unsupported action type */
551#define OFP_ERRACTION_LEN		1	/* Length problem in actions */
552#define OFP_ERRACTION_EXPERIMENTER	2	/* Unknown experimenter id specified */
553#define OFP_ERRACTION_EXP_TYPE		3	/* Unknown action for experimenter id */
554#define OFP_ERRACTION_OUT_PORT		4	/* Problem validating output port */
555#define OFP_ERRACTION_ARGUMENT		5	/* Bad action argument  */
556#define OFP_ERRACTION_EPERM		6	/* Permission error */
557#define OFP_ERRACTION_TOO_MANY		7	/* Can't handle this many actions */
558#define OFP_ERRACTION_BAD_QUEUE		8	/* Problem validating output queue */
559#define OFP_ERRACTION_BAD_OUT_GROPU	9	/* Invalid group id in forward action */
560#define OFP_ERRACTION_MATCH_INCONSIST	10	/* Action can't apply or Set-Field failed */
561#define OFP_ERRACTION_UNSUPPORTED_ORDER	11	/* Action order is unsupported for Apply-Actions */
562#define OFP_ERRACTION_TAG		12	/* Actions uses an unsupported tag/encap */
563#define OFP_ERRACTION_SET_TYPE		13	/* Unsupported type in SET_FIELD action */
564#define OFP_ERRACTION_SET_LEN		14	/* Length problem in SET_FIELD action */
565#define OFP_ERRACTION_SET_ARGUMENT	15	/* Bad argument in SET_FIELD action */
566
567/* INSTRUCTION error codes */
568#define OFP_ERRINST_UNKNOWN_INST	0	/* Unknown instruction */
569#define OFP_ERRINST_UNSUPPORTED_INST	1	/* Switch or table does not support */
570#define OFP_ERRINST_TABLE_ID		2	/* Invalid Table-ID specified */
571#define OFP_ERRINST_UNSUPP_META		3	/* Metadata value unsupported by datapath */
572#define OFP_ERRINST_UNSUPP_META_MASK	4	/* Metadata mask value unsupported by datapath */
573#define OFP_ERRINST_BAD_EXPERIMENTER	5	/* Unknown experimenter id specified */
574#define OFP_ERRINST_BAD_EXPERIMENTER_TYPE 6	/* Unknown instruction for experimenter id */
575#define OFP_ERRINST_BAD_LEN		7	/* Length problem in instructions */
576#define OFP_ERRINST_EPERM		8	/* Permissions error */
577
578/* MATCH error codes */
579#define OFP_ERRMATCH_BAD_TYPE		0	/* Unsupported match type */
580#define OFP_ERRMATCH_BAD_LEN		1	/* Length problem in match */
581#define OFP_ERRMATCH_BAD_TAG		2	/* Match uses an unsupported tag/encap */
582#define OFP_ERRMATCH_BAD_DL_ADDR_MASK	3	/* Unsupported datalink addr mask */
583#define OFP_ERRMATCH_BAD_NW_ADDR_MASK	4	/* Unsupported network addr mask */
584#define OFP_ERRMATCH_BAD_WILDCARDS	5	/* Unsupported combination of fields */
585#define OFP_ERRMATCH_BAD_FIELD		6	/* Unsupported field type in the match */
586#define OFP_ERRMATCH_BAD_VALUE		7	/* Unsupported value in a match field */
587#define OFP_ERRMATCH_BAD_MASK		8	/* Unsupported mask specified in match */
588#define OFP_ERRMATCH_BAD_PREREQ		9	/* A prerequisite was not met */
589#define OFP_ERRMATCH_DUP_FIELD		10	/* A field type was duplicated */
590#define OFP_ERRMATCH_EPERM		11	/* Permissions error */
591
592/* FLOW MOD error codes */
593#define OFP_ERRFLOWMOD_UNKNOWN		0	/* Unknown */
594#define OFP_ERRFLOWMOD_ALL_TABLES_FULL	1	/* Not added, full tables */
595#define OFP_ERRFLOWMOD_TABLE_ID		2	/* Invalid table id */
596#define OFP_ERRFLOWMOD_OVERLAP		3	/* Overlapping flow */
597#define OFP_ERRFLOWMOD_EPERM		4	/* Permissions error */
598#define OFP_ERRFLOWMOD_BAD_TIMEOUT	5	/* non-zero idle/hard timeout */
599#define OFP_ERRFLOWMOD_BAD_COMMAND	6	/* Unsupported or Unknown command */
600#define OFP_ERRFLOWMOD_BAD_FLAGS	7	/* Unsupported or Unknown flags */
601
602/* GROUP MOD error codes */
603#define OFP_ERRGROUPMOD_GROUP_EXISTS	0	/* Already present group */
604#define OFP_ERRGROUPMOD_INVALID_GROUP	1	/* Group specified is invalid */
605#define OFP_ERRGROUPMOD_WEIGHT_UNSUPP	2	/* Switch does not support unequal load sharing */
606#define OFP_ERRGROUPMOD_OUT_OF_GROUPS	3	/* The Group table is full */
607#define OFP_ERRGROUPMOD_OUT_OF_BUCKETS	4	/* The maximum number of action buckets */
608#define OFP_ERRGROUPMOD_CHAINING_UNSUPP	5	/* Switch does not support groups forwarding to groups */
609#define OFP_ERRGROUPMOD_WATCH_UNSUPP	6	/* This group cannot watch the watch_port */
610#define OFP_ERRGROUPMOD_LOOP		7	/* Group entry would cause a loop */
611#define OFP_ERRGROUPMOD_UNKNOWN_GROUP	8	/* MODIFY attempted to modify a non-existent group */
612#define OFP_ERRGROUPMOD_CHAINED_GROUP	9	/* Group not deleted because another group is forwarding to it */
613#define OFP_ERRGROUPMOD_BAD_TYPE	10	/* Unsupported or unknown group type */
614#define OFP_ERRGROUPMOD_BAD_COMMAND	11	/* Unsupported or unknown command */
615#define OFP_ERRGROUPMOD_BAD_BUCKET	12	/* Error in bucket */
616#define OFP_ERRGROUPMOD_BAD_WATCH	13	/* Error in watch port/group */
617#define OFP_ERRGROUPMOD_EPERM		14	/* Permission error */
618
619/* GROUP MOD message */
620#define OFP_GROUPCMD_ADD		0	/* Add group */
621#define OFP_GROUPCMD_MODIFY		1	/* Modify group */
622#define OFP_GROUPCMD_DELETE		2	/* Delete group */
623
624/* Group types */
625#define OFP_GROUP_T_ALL			0
626#define OFP_GROUP_T_SELECT		1
627#define OFP_GROUP_T_INDIRECT		2
628#define OFP_GROUP_T_FAST_FAILOVER	3
629
630#define OFP_GROUP_MAX		0xffffff00
631#define OFP_GROUP_ALL		0xfffffffc
632#define OFP_GROUP_ANY		0xffffffff
633
634struct ofp_bucket {
635	uint16_t		b_len;
636	uint16_t		b_weight;
637	uint32_t		b_watch_port;
638	uint32_t		b_watch_group;
639	uint8_t			b_pad[4];
640	struct ofp_action_header b_actions[0];
641} __packed;
642
643struct ofp_group_mod {
644	struct ofp_header	gm_oh;
645	uint16_t		gm_command;
646	uint8_t			gm_type;
647	uint8_t			gm_pad;
648	uint32_t		gm_group_id;
649	struct ofp_bucket	gm_buckets[0];
650} __packed;
651
652struct ofp_multipart {
653	struct ofp_header	mp_oh;
654	uint16_t		mp_type;
655	uint16_t		mp_flags;
656	uint8_t			mp_pad[4];
657} __packed;
658
659#define OFP_MP_FLAG_REQ_MORE		1
660#define OFP_MP_FLAG_REPLY_MORE		1
661
662/* Multipart types */
663#define OFP_MP_T_DESC			0	/* Description of the switch */
664#define OFP_MP_T_FLOW			1	/* Individual flow statistics */
665#define OFP_MP_T_AGGREGATE		2	/* Aggregate flow statistics */
666#define OFP_MP_T_TABLE			3	/* Flow table statistics */
667#define OFP_MP_T_PORT_STATS		4	/* Port statistics */
668#define OFP_MP_T_QUEUE			5	/* Queue statistics for a port */
669#define OFP_MP_T_GROUP			6	/* Group counter statistics */
670#define OFP_MP_T_GROUP_DESC		7	/* Group description */
671#define OFP_MP_T_GROUP_FEATURES		8	/* Group features */
672#define OFP_MP_T_METER			9	/* Meter statistics */
673#define OFP_MP_T_METER_CONFIG		10	/* Meter configuration */
674#define OFP_MP_T_METER_FEATURES		11	/* Meter features */
675#define OFP_MP_T_TABLE_FEATURES		12	/* Table features */
676#define OFP_MP_T_PORT_DESC		13	/* Port description */
677#define OFP_MP_T_EXPERIMENTER		0xffff	/* Experimenter extension */
678
679#define OFP_DESC_STR_LEN		256
680#define OFP_SERIAL_NUM_LEN		32
681
682struct ofp_desc {
683	char		d_mfr_desc[OFP_DESC_STR_LEN];
684	char		d_hw_desc[OFP_DESC_STR_LEN];
685	char		d_sw_desc[OFP_DESC_STR_LEN];
686	char		d_serial_num[OFP_SERIAL_NUM_LEN];
687	char		d_dp_desc[OFP_DESC_STR_LEN];
688} __packed;
689
690/* Flow stats request */
691struct ofp_flow_stats_request {
692	uint8_t			fsr_table_id;
693	uint8_t			fsr_pad[3];
694	uint32_t		fsr_out_port;
695	uint32_t		fsr_out_group;
696	uint8_t			fsr_pad2[4];
697	uint64_t		fsr_cookie;
698	uint64_t		fsr_cookie_mask;
699	struct ofp_match	fsr_match;
700} __packed;
701
702/* Flow stats */
703struct ofp_flow_stats {
704	uint16_t		fs_length;
705	uint8_t			fs_table_id;
706	uint8_t			fs_pad;
707	uint32_t		fs_duration_sec;
708	uint32_t		fs_duration_nsec;
709	uint16_t		fs_priority;
710	uint16_t		fs_idle_timeout;
711	uint16_t		fs_hard_timeout;
712	uint16_t		fs_flags;
713	uint8_t			fs_pad2[4];
714	uint64_t		fs_cookie;
715	uint64_t		fs_packet_count;
716	uint64_t		fs_byte_count;
717	struct ofp_match	fs_match;
718} __packed;
719
720/* Aggregate flow stats request */
721struct ofp_aggregate_stats_request {
722	uint8_t			asr_table_id;
723	uint8_t			asr_pad[3];
724	uint32_t		asr_out_port;
725	uint32_t		asr_out_group;
726	uint8_t			asr_pad2[4];
727	uint64_t		asr_cookie;
728	uint64_t		asr_cookie_mask;
729	struct ofp_match	asr_match;
730} __packed;
731
732struct ofp_aggregate_stats {
733	uint64_t	as_packet_count;
734	uint64_t	as_byte_count;
735	uint32_t	as_flow_count;
736	uint8_t		as_pad[4];
737} __packed;
738
739#define OFP_TABLE_ID_MAX				0xfe
740#define OFP_TABLE_ID_ALL				0xff
741
742struct ofp_table_stats {
743	uint8_t		ts_table_id;
744	uint8_t		ts_pad[3];
745	uint32_t	ts_active_count;
746	uint64_t	ts_lookup_count;
747	uint64_t	ts_matched_count;
748} __packed;
749
750/* Table features */
751#define OFP_TABLE_FEATPROP_INSTRUCTION		0	/* Instruction property */
752#define OFP_TABLE_FEATPROP_INSTRUCTION_MISS	1	/* Instruction for table-miss  */
753#define OFP_TABLE_FEATPROP_NEXT_TABLES		2	/* Next table property */
754#define OFP_TABLE_FEATPROP_NEXT_TABLES_MISS	3	/* Next table for table-miss */
755#define OFP_TABLE_FEATPROP_WRITE_ACTIONS	4	/* Write actions property */
756#define OFP_TABLE_FEATPROP_WRITE_ACTIONS_MISS	5	/* Write actions for table-miss */
757#define OFP_TABLE_FEATPROP_APPLY_ACTIONS	6	/* Apply actions property */
758#define OFP_TABLE_FEATPROP_APPLY_ACTIONS_MISS	7	/* Apply actions for table-miss */
759#define OFP_TABLE_FEATPROP_MATCH		8	/* Match property */
760#define OFP_TABLE_FEATPROP_WILDCARDS		10	/* Wildcards property */
761#define OFP_TABLE_FEATPROP_WRITE_SETFIELD	12	/* Write set-field property */
762#define OFP_TABLE_FEATPROP_WRITE_SETFIELD_MISS	13	/* Write set-field for table-miss */
763#define OFP_TABLE_FEATPROP_APPLY_SETFIELD	14	/* Apply set-field property */
764#define OFP_TABLE_FEATPROP_APPLY_SETFIELD_MISS	15	/* Apply set-field for table-miss */
765#define OFP_TABLE_FEATPROP_EXPERIMENTER		0xfffe	/* Experimenter property */
766#define OFP_TABLE_FEATPROP_EXPERIMENTER_MISS	0xffff	/* Experimenter for table-miss */
767
768#define OFP_TABLE_MAX_NAME_LEN			32
769
770struct ofp_table_features {
771	uint16_t	tf_length;
772	uint8_t		tf_tableid;
773	uint8_t		tf_pad[5];
774	char		tf_name[OFP_TABLE_MAX_NAME_LEN];
775	uint64_t	tf_metadata_match;
776	uint64_t	tf_metadata_write;
777	uint32_t	tf_config;
778	uint32_t	tf_max_entries;
779} __packed;
780
781struct ofp_table_feature_property {
782	uint16_t	tp_type;
783	uint16_t	tp_length;
784} __packed;
785
786struct ofp_table_feature_property_instruction {
787	uint16_t		tpi_type;
788	uint16_t		tpi_length;
789	struct ofp_instruction	tpi_instructions[0];
790} __packed;
791
792struct ofp_table_feature_property_next_tables {
793	uint16_t	tpnt_type;
794	uint16_t	tpnt_length;
795	uint8_t		tpnt_tables[0];
796} __packed;
797
798struct ofp_table_feature_property_actions {
799	uint16_t			tpa_type;
800	uint16_t			tpa_length;
801	struct ofp_action_header	tpa_actions[0];
802} __packed;
803
804struct ofp_table_feature_property_oxm {
805	uint16_t	tpoxm_type;
806	uint16_t	tpoxm_length;
807	uint32_t	tpoxm_oxm[0];
808} __packed;
809
810struct ofp_table_feature_property_experimenter {
811	uint16_t	tfpexp_type;
812	uint16_t	tfpexp_length;
813	uint32_t	tfpexp_experimenter;
814	uint32_t	tfpexp_exp_type;
815	uint32_t	tfpexp_experimenter_data[0];
816} __packed;
817
818struct ofp_port_stats {
819	uint32_t	pt_port_no;
820	uint8_t		pt_pad[4];
821	uint64_t	pt_rx_packets;
822	uint64_t	pt_tx_packets;
823	uint64_t	pt_rx_bytes;
824	uint64_t	pt_tx_bytes;
825	uint64_t	pt_rx_dropped;
826	uint64_t	pt_tx_dropped;
827	uint64_t	pt_rx_errors;
828	uint64_t	pt_tx_errors;
829	uint64_t	pt_rx_frame_err;
830	uint64_t	pt_rx_over_err;
831	uint64_t	pt_rx_crc_err;
832	uint64_t	pt_collision;
833	uint32_t	pt_duration_sec;
834	uint32_t	pt_duration_nsec;
835} __packed;
836
837/* Groups stats request */
838struct ofp_group_stats_request {
839	uint32_t	gsr_group_id;
840	uint8_t		gsr_pad[4];
841} __packed;
842
843struct ofp_bucket_counter {
844	uint64_t	gs_packet_count;
845	uint64_t	gs_byte_count;
846} __packed;
847
848/* Group stats */
849struct ofp_group_stats {
850	uint16_t		gs_length;
851	uint8_t			gs_pad[2];
852	uint32_t		gs_group_id;
853	uint32_t		gs_ref_count;
854	uint8_t			gs_pad2[4];
855	uint64_t		gs_packet_count;
856	uint64_t		gs_byte_count;
857	uint32_t		gs_duration_sec;
858	uint32_t		gs_duration_nsec;
859	struct ofp_bucket_counter gs_bucket_stats[0];
860} __packed;
861
862/* Group description */
863struct ofp_group_desc {
864	uint16_t		gd_length;
865	uint8_t			gd_type;
866	uint8_t			gd_pad;
867	uint32_t		gd_group_id;
868	struct ofp_bucket	gd_buckets[0];
869} __packed;
870
871#endif /* _NET_OPF_H_ */
872