]>
Commit | Line | Data |
---|---|---|
53931554 | 1 | /* |
e0edde6f | 2 | * Copyright (c) 2008, 2009, 2010, 2011, 2012 Nicira, Inc. |
53931554 BP |
3 | * |
4 | * Licensed under the Apache License, Version 2.0 (the "License"); | |
5 | * you may not use this file except in compliance with the License. | |
6 | * You may obtain a copy of the License at: | |
7 | * | |
8 | * http://www.apache.org/licenses/LICENSE-2.0 | |
9 | * | |
10 | * Unless required by applicable law or agreed to in writing, software | |
11 | * distributed under the License is distributed on an "AS IS" BASIS, | |
12 | * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. | |
13 | * See the License for the specific language governing permissions and | |
14 | * limitations under the License. | |
15 | */ | |
16 | ||
17 | /* OpenFlow: protocol between controller and datapath. */ | |
18 | ||
19 | #ifndef OPENFLOW_OPENFLOW10_H | |
20 | #define OPENFLOW_OPENFLOW10_H 1 | |
21 | ||
87ea5e5e | 22 | #include "openflow/openflow-common.h" |
53931554 BP |
23 | |
24 | /* Port numbering. Physical ports are numbered starting from 1. */ | |
25 | enum ofp_port { | |
26 | /* Maximum number of physical switch ports. */ | |
27 | OFPP_MAX = 0xff00, | |
28 | ||
29 | /* Fake output "ports". */ | |
30 | OFPP_IN_PORT = 0xfff8, /* Send the packet out the input port. This | |
31 | virtual port must be explicitly used | |
32 | in order to send back out of the input | |
33 | port. */ | |
34 | OFPP_TABLE = 0xfff9, /* Perform actions in flow table. | |
35 | NB: This can only be the destination | |
36 | port for packet-out messages. */ | |
37 | OFPP_NORMAL = 0xfffa, /* Process with normal L2/L3 switching. */ | |
38 | OFPP_FLOOD = 0xfffb, /* All physical ports except input port and | |
39 | those disabled by STP. */ | |
40 | OFPP_ALL = 0xfffc, /* All physical ports except input port. */ | |
41 | OFPP_CONTROLLER = 0xfffd, /* Send to controller. */ | |
42 | OFPP_LOCAL = 0xfffe, /* Local openflow "port". */ | |
43 | OFPP_NONE = 0xffff /* Not associated with a physical port. */ | |
44 | }; | |
45 | ||
5293a2e1 BP |
46 | /* OpenFlow 1.0 specific message types, in addition to the common message |
47 | * types. */ | |
48 | enum ofp10_type { | |
53931554 | 49 | /* Controller command messages. */ |
254f4f3b | 50 | OFPT10_PORT_MOD = 15, /* Controller/switch message */ |
53931554 BP |
51 | |
52 | /* Statistics messages. */ | |
5293a2e1 BP |
53 | OFPT10_STATS_REQUEST, /* Controller/switch message */ |
54 | OFPT10_STATS_REPLY, /* Controller/switch message */ | |
53931554 BP |
55 | |
56 | /* Barrier messages. */ | |
5293a2e1 BP |
57 | OFPT10_BARRIER_REQUEST, /* Controller/switch message */ |
58 | OFPT10_BARRIER_REPLY, /* Controller/switch message */ | |
53931554 BP |
59 | |
60 | /* Queue Configuration messages. */ | |
5293a2e1 BP |
61 | OFPT10_QUEUE_GET_CONFIG_REQUEST, /* Controller/switch message */ |
62 | OFPT10_QUEUE_GET_CONFIG_REPLY /* Controller/switch message */ | |
53931554 BP |
63 | }; |
64 | ||
53931554 BP |
65 | /* OFPT_HELLO. This message has an empty body, but implementations must |
66 | * ignore any data included in the body, to allow for future extensions. */ | |
67 | struct ofp_hello { | |
68 | struct ofp_header header; | |
69 | }; | |
70 | ||
71 | #define OFP_DEFAULT_MISS_SEND_LEN 128 | |
72 | ||
73 | enum ofp_config_flags { | |
74 | /* Handling of IP fragments. */ | |
75 | OFPC_FRAG_NORMAL = 0, /* No special handling for fragments. */ | |
76 | OFPC_FRAG_DROP = 1, /* Drop fragments. */ | |
77 | OFPC_FRAG_REASM = 2, /* Reassemble (only if OFPC_IP_REASM set). */ | |
78 | OFPC_FRAG_NX_MATCH = 3, /* Make first fragments available for matching. */ | |
79 | OFPC_FRAG_MASK = 3, | |
80 | ||
81 | /* TTL processing - applicable for IP and MPLS packets. */ | |
82 | OFPC_INVALID_TTL_TO_CONTROLLER = 1 << 2, /* Send packets with invalid TTL | |
83 | to the controller. */ | |
84 | }; | |
85 | ||
86 | /* Switch configuration. */ | |
87 | struct ofp_switch_config { | |
88 | struct ofp_header header; | |
89 | ovs_be16 flags; /* OFPC_* flags. */ | |
90 | ovs_be16 miss_send_len; /* Max bytes of new flow that datapath should | |
91 | send to the controller. */ | |
92 | }; | |
93 | OFP_ASSERT(sizeof(struct ofp_switch_config) == 12); | |
94 | ||
9e1fd49b BP |
95 | /* OpenFlow 1.0 specific capabilities supported by the datapath (struct |
96 | * ofp_switch_features, member capabilities). */ | |
97 | enum ofp10_capabilities { | |
98 | OFPC10_STP = 1 << 3, /* 802.1d spanning tree. */ | |
99 | OFPC10_RESERVED = 1 << 4, /* Reserved, must not be set. */ | |
53931554 BP |
100 | }; |
101 | ||
9e1fd49b BP |
102 | /* OpenFlow 1.0 specific flags to indicate behavior of the physical port. |
103 | * These flags are used in ofp10_phy_port to describe the current | |
104 | * configuration. They are used in the ofp10_port_mod message to configure the | |
105 | * port's behavior. | |
53931554 | 106 | */ |
9e1fd49b BP |
107 | enum ofp10_port_config { |
108 | OFPPC10_NO_STP = 1 << 1, /* Disable 802.1D spanning tree on port. */ | |
109 | OFPPC10_NO_RECV_STP = 1 << 3, /* Drop received 802.1D STP packets. */ | |
110 | OFPPC10_NO_FLOOD = 1 << 4, /* Do not include port when flooding. */ | |
111 | #define OFPPC10_ALL (OFPPC_PORT_DOWN | OFPPC10_NO_STP | OFPPC_NO_RECV | \ | |
112 | OFPPC10_NO_RECV_STP | OFPPC10_NO_FLOOD | OFPPC_NO_FWD | \ | |
113 | OFPPC_NO_PACKET_IN) | |
53931554 BP |
114 | }; |
115 | ||
9e1fd49b BP |
116 | /* OpenFlow 1.0 specific current state of the physical port. These are not |
117 | * configurable from the controller. | |
53931554 | 118 | */ |
9e1fd49b BP |
119 | enum ofp10_port_state { |
120 | /* The OFPPS10_STP_* bits have no effect on switch operation. The | |
53931554 BP |
121 | * controller must adjust OFPPC_NO_RECV, OFPPC_NO_FWD, and |
122 | * OFPPC_NO_PACKET_IN appropriately to fully implement an 802.1D spanning | |
123 | * tree. */ | |
9e1fd49b BP |
124 | OFPPS10_STP_LISTEN = 0 << 8, /* Not learning or relaying frames. */ |
125 | OFPPS10_STP_LEARN = 1 << 8, /* Learning but not relaying frames. */ | |
126 | OFPPS10_STP_FORWARD = 2 << 8, /* Learning and relaying frames. */ | |
127 | OFPPS10_STP_BLOCK = 3 << 8, /* Not part of spanning tree. */ | |
128 | OFPPS10_STP_MASK = 3 << 8 /* Bit mask for OFPPS10_STP_* values. */ | |
129 | ||
130 | #define OFPPS10_ALL (OFPPS_LINK_DOWN | OFPPS10_STP_MASK) | |
53931554 BP |
131 | }; |
132 | ||
9e1fd49b BP |
133 | /* OpenFlow 1.0 specific features of physical ports available in a datapath. */ |
134 | enum ofp10_port_features { | |
135 | OFPPF10_COPPER = 1 << 7, /* Copper medium. */ | |
136 | OFPPF10_FIBER = 1 << 8, /* Fiber medium. */ | |
137 | OFPPF10_AUTONEG = 1 << 9, /* Auto-negotiation. */ | |
138 | OFPPF10_PAUSE = 1 << 10, /* Pause. */ | |
139 | OFPPF10_PAUSE_ASYM = 1 << 11 /* Asymmetric pause. */ | |
53931554 BP |
140 | }; |
141 | ||
142 | /* Description of a physical port */ | |
9e1fd49b | 143 | struct ofp10_phy_port { |
53931554 BP |
144 | ovs_be16 port_no; |
145 | uint8_t hw_addr[OFP_ETH_ALEN]; | |
146 | char name[OFP_MAX_PORT_NAME_LEN]; /* Null-terminated */ | |
147 | ||
9e1fd49b BP |
148 | ovs_be32 config; /* Bitmap of OFPPC_* and OFPPC10_* flags. */ |
149 | ovs_be32 state; /* Bitmap of OFPPS_* and OFPPS10_* flags. */ | |
53931554 | 150 | |
9e1fd49b BP |
151 | /* Bitmaps of OFPPF_* and OFPPF10_* that describe features. All bits |
152 | * zeroed if unsupported or unavailable. */ | |
53931554 BP |
153 | ovs_be32 curr; /* Current features. */ |
154 | ovs_be32 advertised; /* Features being advertised by the port. */ | |
155 | ovs_be32 supported; /* Features supported by the port. */ | |
156 | ovs_be32 peer; /* Features advertised by peer. */ | |
157 | }; | |
9e1fd49b | 158 | OFP_ASSERT(sizeof(struct ofp10_phy_port) == 48); |
53931554 BP |
159 | |
160 | /* Modify behavior of the physical port */ | |
9e1fd49b | 161 | struct ofp10_port_mod { |
53931554 BP |
162 | struct ofp_header header; |
163 | ovs_be16 port_no; | |
164 | uint8_t hw_addr[OFP_ETH_ALEN]; /* The hardware address is not | |
165 | configurable. This is used to | |
166 | sanity-check the request, so it must | |
167 | be the same as returned in an | |
9e1fd49b | 168 | ofp10_phy_port struct. */ |
53931554 BP |
169 | |
170 | ovs_be32 config; /* Bitmap of OFPPC_* flags. */ | |
171 | ovs_be32 mask; /* Bitmap of OFPPC_* flags to be changed. */ | |
172 | ||
173 | ovs_be32 advertise; /* Bitmap of "ofp_port_features"s. Zero all | |
174 | bits to prevent any action taking place. */ | |
175 | uint8_t pad[4]; /* Pad to 64-bits. */ | |
176 | }; | |
9e1fd49b | 177 | OFP_ASSERT(sizeof(struct ofp10_port_mod) == 32); |
53931554 | 178 | |
688af176 SH |
179 | /* Query for port queue configuration. */ |
180 | struct ofp10_queue_get_config_request { | |
181 | struct ofp_header header; | |
182 | ovs_be16 port; /* Port to be queried. Should refer | |
183 | to a valid physical port (i.e. < OFPP_MAX) */ | |
184 | uint8_t pad[2]; | |
185 | /* 32-bit alignment. */ | |
186 | }; | |
187 | OFP_ASSERT(sizeof(struct ofp10_queue_get_config_request) == 12); | |
188 | ||
189 | /* Queue configuration for a given port. */ | |
190 | struct ofp10_queue_get_config_reply { | |
191 | struct ofp_header header; | |
192 | ovs_be16 port; | |
193 | uint8_t pad[6]; | |
194 | /* struct ofp10_packet_queue queues[0]; List of configured queues. */ | |
195 | }; | |
196 | OFP_ASSERT(sizeof(struct ofp10_queue_get_config_reply) == 16); | |
197 | ||
53931554 BP |
198 | /* Packet received on port (datapath -> controller). */ |
199 | struct ofp_packet_in { | |
200 | struct ofp_header header; | |
201 | ovs_be32 buffer_id; /* ID assigned by datapath. */ | |
202 | ovs_be16 total_len; /* Full length of frame. */ | |
203 | ovs_be16 in_port; /* Port on which frame was received. */ | |
204 | uint8_t reason; /* Reason packet is being sent (one of OFPR_*) */ | |
205 | uint8_t pad; | |
206 | uint8_t data[0]; /* Ethernet frame, halfway through 32-bit word, | |
207 | so the IP header is 32-bit aligned. The | |
208 | amount of data is inferred from the length | |
209 | field in the header. Because of padding, | |
210 | offsetof(struct ofp_packet_in, data) == | |
211 | sizeof(struct ofp_packet_in) - 2. */ | |
212 | }; | |
213 | OFP_ASSERT(sizeof(struct ofp_packet_in) == 20); | |
214 | ||
08f94c0e BP |
215 | enum ofp10_action_type { |
216 | OFPAT10_OUTPUT, /* Output to switch port. */ | |
217 | OFPAT10_SET_VLAN_VID, /* Set the 802.1q VLAN id. */ | |
218 | OFPAT10_SET_VLAN_PCP, /* Set the 802.1q priority. */ | |
219 | OFPAT10_STRIP_VLAN, /* Strip the 802.1q header. */ | |
220 | OFPAT10_SET_DL_SRC, /* Ethernet source address. */ | |
221 | OFPAT10_SET_DL_DST, /* Ethernet destination address. */ | |
222 | OFPAT10_SET_NW_SRC, /* IP source address. */ | |
223 | OFPAT10_SET_NW_DST, /* IP destination address. */ | |
224 | OFPAT10_SET_NW_TOS, /* IP ToS (DSCP field, 6 bits). */ | |
225 | OFPAT10_SET_TP_SRC, /* TCP/UDP source port. */ | |
226 | OFPAT10_SET_TP_DST, /* TCP/UDP destination port. */ | |
227 | OFPAT10_ENQUEUE, /* Output to queue. */ | |
228 | OFPAT10_VENDOR = 0xffff | |
53931554 BP |
229 | }; |
230 | ||
08f94c0e | 231 | /* Action structure for OFPAT10_OUTPUT, which sends packets out 'port'. |
53931554 BP |
232 | * When the 'port' is the OFPP_CONTROLLER, 'max_len' indicates the max |
233 | * number of bytes to send. A 'max_len' of zero means no bytes of the | |
234 | * packet should be sent. */ | |
235 | struct ofp_action_output { | |
08f94c0e | 236 | ovs_be16 type; /* OFPAT10_OUTPUT. */ |
53931554 BP |
237 | ovs_be16 len; /* Length is 8. */ |
238 | ovs_be16 port; /* Output port. */ | |
239 | ovs_be16 max_len; /* Max length to send to controller. */ | |
240 | }; | |
241 | OFP_ASSERT(sizeof(struct ofp_action_output) == 8); | |
242 | ||
243 | /* The VLAN id is 12 bits, so we can use the entire 16 bits to indicate | |
244 | * special conditions. All ones is used to match that no VLAN id was | |
245 | * set. */ | |
246 | #define OFP_VLAN_NONE 0xffff | |
247 | ||
08f94c0e | 248 | /* Action structure for OFPAT10_SET_VLAN_VID. */ |
53931554 | 249 | struct ofp_action_vlan_vid { |
08f94c0e | 250 | ovs_be16 type; /* OFPAT10_SET_VLAN_VID. */ |
53931554 BP |
251 | ovs_be16 len; /* Length is 8. */ |
252 | ovs_be16 vlan_vid; /* VLAN id. */ | |
253 | uint8_t pad[2]; | |
254 | }; | |
255 | OFP_ASSERT(sizeof(struct ofp_action_vlan_vid) == 8); | |
256 | ||
08f94c0e | 257 | /* Action structure for OFPAT10_SET_VLAN_PCP. */ |
53931554 | 258 | struct ofp_action_vlan_pcp { |
08f94c0e | 259 | ovs_be16 type; /* OFPAT10_SET_VLAN_PCP. */ |
53931554 BP |
260 | ovs_be16 len; /* Length is 8. */ |
261 | uint8_t vlan_pcp; /* VLAN priority. */ | |
262 | uint8_t pad[3]; | |
263 | }; | |
264 | OFP_ASSERT(sizeof(struct ofp_action_vlan_pcp) == 8); | |
265 | ||
08f94c0e | 266 | /* Action structure for OFPAT10_SET_DL_SRC/DST. */ |
53931554 | 267 | struct ofp_action_dl_addr { |
08f94c0e | 268 | ovs_be16 type; /* OFPAT10_SET_DL_SRC/DST. */ |
53931554 BP |
269 | ovs_be16 len; /* Length is 16. */ |
270 | uint8_t dl_addr[OFP_ETH_ALEN]; /* Ethernet address. */ | |
271 | uint8_t pad[6]; | |
272 | }; | |
273 | OFP_ASSERT(sizeof(struct ofp_action_dl_addr) == 16); | |
274 | ||
08f94c0e | 275 | /* Action structure for OFPAT10_SET_NW_SRC/DST. */ |
53931554 | 276 | struct ofp_action_nw_addr { |
08f94c0e | 277 | ovs_be16 type; /* OFPAT10_SET_TW_SRC/DST. */ |
53931554 BP |
278 | ovs_be16 len; /* Length is 8. */ |
279 | ovs_be32 nw_addr; /* IP address. */ | |
280 | }; | |
281 | OFP_ASSERT(sizeof(struct ofp_action_nw_addr) == 8); | |
282 | ||
08f94c0e | 283 | /* Action structure for OFPAT10_SET_NW_TOS. */ |
53931554 | 284 | struct ofp_action_nw_tos { |
08f94c0e | 285 | ovs_be16 type; /* OFPAT10_SET_TW_TOS. */ |
53931554 | 286 | ovs_be16 len; /* Length is 8. */ |
c9349648 | 287 | uint8_t nw_tos; /* DSCP in high 6 bits, rest ignored. */ |
53931554 BP |
288 | uint8_t pad[3]; |
289 | }; | |
290 | OFP_ASSERT(sizeof(struct ofp_action_nw_tos) == 8); | |
291 | ||
08f94c0e | 292 | /* Action structure for OFPAT10_SET_TP_SRC/DST. */ |
53931554 | 293 | struct ofp_action_tp_port { |
08f94c0e | 294 | ovs_be16 type; /* OFPAT10_SET_TP_SRC/DST. */ |
53931554 BP |
295 | ovs_be16 len; /* Length is 8. */ |
296 | ovs_be16 tp_port; /* TCP/UDP port. */ | |
297 | uint8_t pad[2]; | |
298 | }; | |
299 | OFP_ASSERT(sizeof(struct ofp_action_tp_port) == 8); | |
300 | ||
08f94c0e | 301 | /* Action header for OFPAT10_VENDOR. The rest of the body is vendor-defined. */ |
53931554 | 302 | struct ofp_action_vendor_header { |
08f94c0e | 303 | ovs_be16 type; /* OFPAT10_VENDOR. */ |
53931554 BP |
304 | ovs_be16 len; /* Length is a multiple of 8. */ |
305 | ovs_be32 vendor; /* Vendor ID, which takes the same form | |
306 | as in "struct ofp_vendor_header". */ | |
307 | }; | |
308 | OFP_ASSERT(sizeof(struct ofp_action_vendor_header) == 8); | |
309 | ||
310 | /* Action header that is common to all actions. The length includes the | |
311 | * header and any padding used to make the action 64-bit aligned. | |
312 | * NB: The length of an action *must* always be a multiple of eight. */ | |
313 | struct ofp_action_header { | |
08f94c0e | 314 | ovs_be16 type; /* One of OFPAT10_*. */ |
53931554 BP |
315 | ovs_be16 len; /* Length of action, including this |
316 | header. This is the length of action, | |
317 | including any padding to make it | |
318 | 64-bit aligned. */ | |
319 | uint8_t pad[4]; | |
320 | }; | |
321 | OFP_ASSERT(sizeof(struct ofp_action_header) == 8); | |
322 | ||
08f94c0e | 323 | /* OFPAT10_ENQUEUE action struct: send packets to given queue on port. */ |
53931554 | 324 | struct ofp_action_enqueue { |
08f94c0e | 325 | ovs_be16 type; /* OFPAT10_ENQUEUE. */ |
53931554 BP |
326 | ovs_be16 len; /* Len is 16. */ |
327 | ovs_be16 port; /* Port that queue belongs. Should | |
328 | refer to a valid physical port | |
329 | (i.e. < OFPP_MAX) or OFPP_IN_PORT. */ | |
330 | uint8_t pad[6]; /* Pad for 64-bit alignment. */ | |
331 | ovs_be32 queue_id; /* Where to enqueue the packets. */ | |
332 | }; | |
333 | OFP_ASSERT(sizeof(struct ofp_action_enqueue) == 16); | |
334 | ||
335 | union ofp_action { | |
336 | ovs_be16 type; | |
337 | struct ofp_action_header header; | |
338 | struct ofp_action_vendor_header vendor; | |
339 | struct ofp_action_output output; | |
340 | struct ofp_action_vlan_vid vlan_vid; | |
341 | struct ofp_action_vlan_pcp vlan_pcp; | |
342 | struct ofp_action_nw_addr nw_addr; | |
343 | struct ofp_action_nw_tos nw_tos; | |
344 | struct ofp_action_tp_port tp_port; | |
345 | }; | |
346 | OFP_ASSERT(sizeof(union ofp_action) == 8); | |
347 | ||
348 | /* Send packet (controller -> datapath). */ | |
349 | struct ofp_packet_out { | |
350 | struct ofp_header header; | |
351 | ovs_be32 buffer_id; /* ID assigned by datapath or UINT32_MAX. */ | |
352 | ovs_be16 in_port; /* Packet's input port (OFPP_NONE if none). */ | |
353 | ovs_be16 actions_len; /* Size of action array in bytes. */ | |
354 | /* Followed by: | |
355 | * - Exactly 'actions_len' bytes (possibly 0 bytes, and always a multiple | |
356 | * of 8) containing actions. | |
357 | * - If 'buffer_id' == UINT32_MAX, packet data to fill out the remainder | |
358 | * of the message length. | |
359 | */ | |
360 | }; | |
361 | OFP_ASSERT(sizeof(struct ofp_packet_out) == 16); | |
362 | ||
363 | enum ofp_flow_mod_command { | |
364 | OFPFC_ADD, /* New flow. */ | |
365 | OFPFC_MODIFY, /* Modify all matching flows. */ | |
366 | OFPFC_MODIFY_STRICT, /* Modify entry strictly matching wildcards */ | |
367 | OFPFC_DELETE, /* Delete all matching flows. */ | |
368 | OFPFC_DELETE_STRICT /* Strictly match wildcards and priority. */ | |
369 | }; | |
370 | ||
371 | /* Flow wildcards. */ | |
372 | enum ofp_flow_wildcards { | |
eec25dc1 BP |
373 | OFPFW10_IN_PORT = 1 << 0, /* Switch input port. */ |
374 | OFPFW10_DL_VLAN = 1 << 1, /* VLAN vid. */ | |
375 | OFPFW10_DL_SRC = 1 << 2, /* Ethernet source address. */ | |
376 | OFPFW10_DL_DST = 1 << 3, /* Ethernet destination address. */ | |
377 | OFPFW10_DL_TYPE = 1 << 4, /* Ethernet frame type. */ | |
378 | OFPFW10_NW_PROTO = 1 << 5, /* IP protocol. */ | |
379 | OFPFW10_TP_SRC = 1 << 6, /* TCP/UDP source port. */ | |
380 | OFPFW10_TP_DST = 1 << 7, /* TCP/UDP destination port. */ | |
53931554 BP |
381 | |
382 | /* IP source address wildcard bit count. 0 is exact match, 1 ignores the | |
383 | * LSB, 2 ignores the 2 least-significant bits, ..., 32 and higher wildcard | |
384 | * the entire field. This is the *opposite* of the usual convention where | |
385 | * e.g. /24 indicates that 8 bits (not 24 bits) are wildcarded. */ | |
eec25dc1 BP |
386 | OFPFW10_NW_SRC_SHIFT = 8, |
387 | OFPFW10_NW_SRC_BITS = 6, | |
388 | OFPFW10_NW_SRC_MASK = (((1 << OFPFW10_NW_SRC_BITS) - 1) | |
389 | << OFPFW10_NW_SRC_SHIFT), | |
390 | OFPFW10_NW_SRC_ALL = 32 << OFPFW10_NW_SRC_SHIFT, | |
53931554 BP |
391 | |
392 | /* IP destination address wildcard bit count. Same format as source. */ | |
eec25dc1 BP |
393 | OFPFW10_NW_DST_SHIFT = 14, |
394 | OFPFW10_NW_DST_BITS = 6, | |
395 | OFPFW10_NW_DST_MASK = (((1 << OFPFW10_NW_DST_BITS) - 1) | |
396 | << OFPFW10_NW_DST_SHIFT), | |
397 | OFPFW10_NW_DST_ALL = 32 << OFPFW10_NW_DST_SHIFT, | |
53931554 | 398 | |
eec25dc1 BP |
399 | OFPFW10_DL_VLAN_PCP = 1 << 20, /* VLAN priority. */ |
400 | OFPFW10_NW_TOS = 1 << 21, /* IP ToS (DSCP field, 6 bits). */ | |
53931554 BP |
401 | |
402 | /* Wildcard all fields. */ | |
eec25dc1 | 403 | OFPFW10_ALL = ((1 << 22) - 1) |
53931554 BP |
404 | }; |
405 | ||
406 | /* The wildcards for ICMP type and code fields use the transport source | |
407 | * and destination port fields, respectively. */ | |
eec25dc1 BP |
408 | #define OFPFW10_ICMP_TYPE OFPFW10_TP_SRC |
409 | #define OFPFW10_ICMP_CODE OFPFW10_TP_DST | |
53931554 BP |
410 | |
411 | /* Values below this cutoff are 802.3 packets and the two bytes | |
412 | * following MAC addresses are used as a frame length. Otherwise, the | |
413 | * two bytes are used as the Ethernet type. | |
414 | */ | |
415 | #define OFP_DL_TYPE_ETH2_CUTOFF 0x0600 | |
416 | ||
417 | /* Value of dl_type to indicate that the frame does not include an | |
418 | * Ethernet type. | |
419 | */ | |
420 | #define OFP_DL_TYPE_NOT_ETH_TYPE 0x05ff | |
421 | ||
422 | /* The VLAN id is 12-bits, so we can use the entire 16 bits to indicate | |
423 | * special conditions. All ones indicates that no VLAN id was set. | |
424 | */ | |
425 | #define OFP_VLAN_NONE 0xffff | |
426 | ||
427 | /* Fields to match against flows */ | |
eec25dc1 | 428 | struct ofp10_match { |
53931554 BP |
429 | ovs_be32 wildcards; /* Wildcard fields. */ |
430 | ovs_be16 in_port; /* Input switch port. */ | |
431 | uint8_t dl_src[OFP_ETH_ALEN]; /* Ethernet source address. */ | |
432 | uint8_t dl_dst[OFP_ETH_ALEN]; /* Ethernet destination address. */ | |
433 | ovs_be16 dl_vlan; /* Input VLAN. */ | |
434 | uint8_t dl_vlan_pcp; /* Input VLAN priority. */ | |
435 | uint8_t pad1[1]; /* Align to 64-bits. */ | |
436 | ovs_be16 dl_type; /* Ethernet frame type. */ | |
437 | uint8_t nw_tos; /* IP ToS (DSCP field, 6 bits). */ | |
438 | uint8_t nw_proto; /* IP protocol or lower 8 bits of | |
439 | ARP opcode. */ | |
440 | uint8_t pad2[2]; /* Align to 64-bits. */ | |
441 | ovs_be32 nw_src; /* IP source address. */ | |
442 | ovs_be32 nw_dst; /* IP destination address. */ | |
443 | ovs_be16 tp_src; /* TCP/UDP source port. */ | |
444 | ovs_be16 tp_dst; /* TCP/UDP destination port. */ | |
445 | }; | |
eec25dc1 | 446 | OFP_ASSERT(sizeof(struct ofp10_match) == 40); |
53931554 BP |
447 | |
448 | /* Value used in "idle_timeout" and "hard_timeout" to indicate that the entry | |
449 | * is permanent. */ | |
450 | #define OFP_FLOW_PERMANENT 0 | |
451 | ||
452 | /* By default, choose a priority in the middle. */ | |
453 | #define OFP_DEFAULT_PRIORITY 0x8000 | |
454 | ||
455 | enum ofp_flow_mod_flags { | |
456 | OFPFF_SEND_FLOW_REM = 1 << 0, /* Send flow removed message when flow | |
457 | * expires or is deleted. */ | |
458 | OFPFF_CHECK_OVERLAP = 1 << 1, /* Check for overlapping entries first. */ | |
459 | OFPFF_EMERG = 1 << 2 /* Ramark this is for emergency. */ | |
460 | }; | |
461 | ||
462 | /* Flow setup and teardown (controller -> datapath). */ | |
463 | struct ofp_flow_mod { | |
464 | struct ofp_header header; | |
eec25dc1 | 465 | struct ofp10_match match; /* Fields to match */ |
53931554 BP |
466 | ovs_be64 cookie; /* Opaque controller-issued identifier. */ |
467 | ||
468 | /* Flow actions. */ | |
469 | ovs_be16 command; /* One of OFPFC_*. */ | |
470 | ovs_be16 idle_timeout; /* Idle time before discarding (seconds). */ | |
471 | ovs_be16 hard_timeout; /* Max time before discarding (seconds). */ | |
472 | ovs_be16 priority; /* Priority level of flow entry. */ | |
473 | ovs_be32 buffer_id; /* Buffered packet to apply to (or -1). | |
474 | Not meaningful for OFPFC_DELETE*. */ | |
475 | ovs_be16 out_port; /* For OFPFC_DELETE* commands, require | |
476 | matching entries to include this as an | |
477 | output port. A value of OFPP_NONE | |
478 | indicates no restriction. */ | |
479 | ovs_be16 flags; /* One of OFPFF_*. */ | |
480 | struct ofp_action_header actions[0]; /* The action length is inferred | |
481 | from the length field in the | |
482 | header. */ | |
483 | }; | |
484 | OFP_ASSERT(sizeof(struct ofp_flow_mod) == 72); | |
485 | ||
53931554 BP |
486 | /* Flow removed (datapath -> controller). */ |
487 | struct ofp_flow_removed { | |
488 | struct ofp_header header; | |
eec25dc1 | 489 | struct ofp10_match match; /* Description of fields. */ |
53931554 BP |
490 | ovs_be64 cookie; /* Opaque controller-issued identifier. */ |
491 | ||
492 | ovs_be16 priority; /* Priority level of flow entry. */ | |
493 | uint8_t reason; /* One of OFPRR_*. */ | |
494 | uint8_t pad[1]; /* Align to 32-bits. */ | |
495 | ||
496 | ovs_be32 duration_sec; /* Time flow was alive in seconds. */ | |
497 | ovs_be32 duration_nsec; /* Time flow was alive in nanoseconds beyond | |
498 | duration_sec. */ | |
499 | ovs_be16 idle_timeout; /* Idle timeout from original flow mod. */ | |
500 | uint8_t pad2[2]; /* Align to 64-bits. */ | |
501 | ovs_be64 packet_count; | |
502 | ovs_be64 byte_count; | |
503 | }; | |
504 | OFP_ASSERT(sizeof(struct ofp_flow_removed) == 88); | |
505 | ||
506 | /* OFPT_ERROR: Error message (datapath -> controller). */ | |
507 | struct ofp_error_msg { | |
508 | struct ofp_header header; | |
509 | ||
510 | ovs_be16 type; | |
511 | ovs_be16 code; | |
512 | uint8_t data[0]; /* Variable-length data. Interpreted based | |
513 | on the type and code. */ | |
514 | }; | |
515 | OFP_ASSERT(sizeof(struct ofp_error_msg) == 12); | |
516 | ||
53931554 BP |
517 | /* Statistics request or reply message. */ |
518 | struct ofp_stats_msg { | |
519 | struct ofp_header header; | |
520 | ovs_be16 type; /* One of the OFPST_* constants. */ | |
521 | ovs_be16 flags; /* Requests: always 0. | |
522 | * Replies: 0 or OFPSF_REPLY_MORE. */ | |
523 | }; | |
524 | OFP_ASSERT(sizeof(struct ofp_stats_msg) == 12); | |
525 | ||
526 | enum ofp_stats_reply_flags { | |
527 | OFPSF_REPLY_MORE = 1 << 0 /* More replies to follow. */ | |
528 | }; | |
529 | ||
530 | #define DESC_STR_LEN 256 | |
531 | #define SERIAL_NUM_LEN 32 | |
532 | /* Reply to OFPST_DESC request. Each entry is a NULL-terminated ASCII | |
533 | * string. */ | |
534 | struct ofp_desc_stats { | |
535 | struct ofp_stats_msg osm; | |
536 | char mfr_desc[DESC_STR_LEN]; /* Manufacturer description. */ | |
537 | char hw_desc[DESC_STR_LEN]; /* Hardware description. */ | |
538 | char sw_desc[DESC_STR_LEN]; /* Software description. */ | |
539 | char serial_num[SERIAL_NUM_LEN]; /* Serial number. */ | |
540 | char dp_desc[DESC_STR_LEN]; /* Human readable description of | |
541 | the datapath. */ | |
542 | }; | |
543 | OFP_ASSERT(sizeof(struct ofp_desc_stats) == 1068); | |
544 | ||
545 | /* Stats request of type OFPST_AGGREGATE or OFPST_FLOW. */ | |
546 | struct ofp_flow_stats_request { | |
547 | struct ofp_stats_msg osm; | |
eec25dc1 | 548 | struct ofp10_match match; /* Fields to match. */ |
53931554 BP |
549 | uint8_t table_id; /* ID of table to read (from ofp_table_stats) |
550 | or 0xff for all tables. */ | |
551 | uint8_t pad; /* Align to 32 bits. */ | |
552 | ovs_be16 out_port; /* Require matching entries to include this | |
553 | as an output port. A value of OFPP_NONE | |
554 | indicates no restriction. */ | |
555 | }; | |
556 | OFP_ASSERT(sizeof(struct ofp_flow_stats_request) == 56); | |
557 | ||
558 | /* Body of reply to OFPST_FLOW request. */ | |
559 | struct ofp_flow_stats { | |
560 | ovs_be16 length; /* Length of this entry. */ | |
561 | uint8_t table_id; /* ID of table flow came from. */ | |
562 | uint8_t pad; | |
eec25dc1 | 563 | struct ofp10_match match; /* Description of fields. */ |
53931554 BP |
564 | ovs_be32 duration_sec; /* Time flow has been alive in seconds. */ |
565 | ovs_be32 duration_nsec; /* Time flow has been alive in nanoseconds | |
566 | beyond duration_sec. */ | |
567 | ovs_be16 priority; /* Priority of the entry. Only meaningful | |
568 | when this is not an exact-match entry. */ | |
569 | ovs_be16 idle_timeout; /* Number of seconds idle before expiration. */ | |
570 | ovs_be16 hard_timeout; /* Number of seconds before expiration. */ | |
571 | uint8_t pad2[6]; /* Align to 64 bits. */ | |
572 | ovs_32aligned_be64 cookie; /* Opaque controller-issued identifier. */ | |
573 | ovs_32aligned_be64 packet_count; /* Number of packets in flow. */ | |
574 | ovs_32aligned_be64 byte_count; /* Number of bytes in flow. */ | |
575 | struct ofp_action_header actions[0]; /* Actions. */ | |
576 | }; | |
577 | OFP_ASSERT(sizeof(struct ofp_flow_stats) == 88); | |
578 | ||
579 | /* Reply to OFPST_AGGREGATE request. */ | |
580 | struct ofp_aggregate_stats_reply { | |
581 | struct ofp_stats_msg osm; | |
582 | ovs_32aligned_be64 packet_count; /* Number of packets in flows. */ | |
583 | ovs_32aligned_be64 byte_count; /* Number of bytes in flows. */ | |
584 | ovs_be32 flow_count; /* Number of flows. */ | |
585 | uint8_t pad[4]; /* Align to 64 bits. */ | |
586 | }; | |
587 | OFP_ASSERT(sizeof(struct ofp_aggregate_stats_reply) == 36); | |
588 | ||
589 | /* Body of reply to OFPST_TABLE request. */ | |
590 | struct ofp_table_stats { | |
591 | uint8_t table_id; /* Identifier of table. Lower numbered tables | |
592 | are consulted first. */ | |
593 | uint8_t pad[3]; /* Align to 32-bits. */ | |
594 | char name[OFP_MAX_TABLE_NAME_LEN]; | |
eec25dc1 | 595 | ovs_be32 wildcards; /* Bitmap of OFPFW10_* wildcards that are |
53931554 BP |
596 | supported by the table. */ |
597 | ovs_be32 max_entries; /* Max number of entries supported. */ | |
598 | ovs_be32 active_count; /* Number of active entries. */ | |
599 | ovs_32aligned_be64 lookup_count; /* # of packets looked up in table. */ | |
600 | ovs_32aligned_be64 matched_count; /* Number of packets that hit table. */ | |
601 | }; | |
602 | OFP_ASSERT(sizeof(struct ofp_table_stats) == 64); | |
603 | ||
604 | /* Stats request of type OFPST_PORT. */ | |
605 | struct ofp_port_stats_request { | |
606 | struct ofp_stats_msg osm; | |
607 | ovs_be16 port_no; /* OFPST_PORT message may request statistics | |
608 | for a single port (specified with port_no) | |
609 | or for all ports (port_no == OFPP_NONE). */ | |
610 | uint8_t pad[6]; | |
611 | }; | |
612 | OFP_ASSERT(sizeof(struct ofp_port_stats_request) == 20); | |
613 | ||
614 | /* Body of reply to OFPST_PORT request. If a counter is unsupported, set | |
615 | * the field to all ones. */ | |
616 | struct ofp_port_stats { | |
617 | ovs_be16 port_no; | |
618 | uint8_t pad[6]; /* Align to 64-bits. */ | |
619 | ovs_32aligned_be64 rx_packets; /* Number of received packets. */ | |
620 | ovs_32aligned_be64 tx_packets; /* Number of transmitted packets. */ | |
621 | ovs_32aligned_be64 rx_bytes; /* Number of received bytes. */ | |
622 | ovs_32aligned_be64 tx_bytes; /* Number of transmitted bytes. */ | |
623 | ovs_32aligned_be64 rx_dropped; /* Number of packets dropped by RX. */ | |
624 | ovs_32aligned_be64 tx_dropped; /* Number of packets dropped by TX. */ | |
625 | ovs_32aligned_be64 rx_errors; /* Number of receive errors. This is a | |
626 | super-set of receive errors and should be | |
627 | great than or equal to the sum of all | |
628 | rx_*_err values. */ | |
629 | ovs_32aligned_be64 tx_errors; /* Number of transmit errors. This is a | |
630 | super-set of transmit errors. */ | |
631 | ovs_32aligned_be64 rx_frame_err; /* Number of frame alignment errors. */ | |
632 | ovs_32aligned_be64 rx_over_err; /* Number of packets with RX overrun. */ | |
633 | ovs_32aligned_be64 rx_crc_err; /* Number of CRC errors. */ | |
634 | ovs_32aligned_be64 collisions; /* Number of collisions. */ | |
635 | }; | |
636 | OFP_ASSERT(sizeof(struct ofp_port_stats) == 104); | |
637 | ||
638 | /* All ones is used to indicate all queues in a port (for stats retrieval). */ | |
639 | #define OFPQ_ALL 0xffffffff | |
640 | ||
641 | /* Body for stats request of type OFPST_QUEUE. */ | |
642 | struct ofp_queue_stats_request { | |
643 | struct ofp_stats_msg osm; | |
644 | ovs_be16 port_no; /* All ports if OFPP_ALL. */ | |
645 | uint8_t pad[2]; /* Align to 32-bits. */ | |
646 | ovs_be32 queue_id; /* All queues if OFPQ_ALL. */ | |
647 | }; | |
648 | OFP_ASSERT(sizeof(struct ofp_queue_stats_request) == 20); | |
649 | ||
650 | /* Body for stats reply of type OFPST_QUEUE consists of an array of this | |
651 | * structure type. */ | |
652 | struct ofp_queue_stats { | |
653 | ovs_be16 port_no; | |
654 | uint8_t pad[2]; /* Align to 32-bits. */ | |
655 | ovs_be32 queue_id; /* Queue id. */ | |
656 | ovs_32aligned_be64 tx_bytes; /* Number of transmitted bytes. */ | |
657 | ovs_32aligned_be64 tx_packets; /* Number of transmitted packets. */ | |
658 | ovs_32aligned_be64 tx_errors; /* # of packets dropped due to overrun. */ | |
659 | }; | |
660 | OFP_ASSERT(sizeof(struct ofp_queue_stats) == 32); | |
661 | ||
662 | /* Vendor extension stats message. */ | |
663 | struct ofp_vendor_stats_msg { | |
664 | struct ofp_stats_msg osm; /* Type OFPST_VENDOR. */ | |
665 | ovs_be32 vendor; /* Vendor ID: | |
666 | * - MSB 0: low-order bytes are IEEE OUI. | |
667 | * - MSB != 0: defined by OpenFlow | |
668 | * consortium. */ | |
669 | /* Followed by vendor-defined arbitrary additional data. */ | |
670 | }; | |
671 | OFP_ASSERT(sizeof(struct ofp_vendor_stats_msg) == 16); | |
672 | ||
673 | /* Vendor extension. */ | |
674 | struct ofp_vendor_header { | |
675 | struct ofp_header header; /* Type OFPT_VENDOR. */ | |
676 | ovs_be32 vendor; /* Vendor ID: | |
677 | * - MSB 0: low-order bytes are IEEE OUI. | |
678 | * - MSB != 0: defined by OpenFlow | |
679 | * consortium. */ | |
680 | /* Vendor-defined arbitrary additional data. */ | |
681 | }; | |
682 | OFP_ASSERT(sizeof(struct ofp_vendor_header) == 12); | |
683 | ||
684 | #endif /* openflow/openflow-1.0.h */ |