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