2 * Copyright (c) 2010, 2011 Nicira Networks.
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:
8 * http://www.apache.org/licenses/LICENSE-2.0
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.
19 #include "ofp-parse.h"
27 #include "byte-order.h"
28 #include "dynamic-string.h"
30 #include "multipath.h"
34 #include "openflow/openflow.h"
36 #include "socket-util.h"
40 VLOG_DEFINE_THIS_MODULE(ofp_parse
);
43 str_to_u32(const char *str
)
49 ovs_fatal(0, "missing required numeric argument");
53 value
= strtoul(str
, &tail
, 0);
54 if (errno
== EINVAL
|| errno
== ERANGE
|| *tail
) {
55 ovs_fatal(0, "invalid numeric format %s", str
);
61 str_to_u64(const char *str
)
67 ovs_fatal(0, "missing required numeric argument");
71 value
= strtoull(str
, &tail
, 0);
72 if (errno
== EINVAL
|| errno
== ERANGE
|| *tail
) {
73 ovs_fatal(0, "invalid numeric format %s", str
);
79 str_to_mac(const char *str
, uint8_t mac
[6])
81 if (sscanf(str
, ETH_ADDR_SCAN_FMT
, ETH_ADDR_SCAN_ARGS(mac
))
82 != ETH_ADDR_SCAN_COUNT
) {
83 ovs_fatal(0, "invalid mac address %s", str
);
88 str_to_eth_dst(const char *str
,
89 uint8_t mac
[ETH_ADDR_LEN
], uint8_t mask
[ETH_ADDR_LEN
])
91 if (sscanf(str
, ETH_ADDR_SCAN_FMT
"/"ETH_ADDR_SCAN_FMT
,
92 ETH_ADDR_SCAN_ARGS(mac
), ETH_ADDR_SCAN_ARGS(mask
))
93 == ETH_ADDR_SCAN_COUNT
* 2) {
94 if (!flow_wildcards_is_dl_dst_mask_valid(mask
)) {
95 ovs_fatal(0, "%s: invalid Ethernet destination mask (only "
96 "00:00:00:00:00:00, 01:00:00:00:00:00, "
97 "fe:ff:ff:ff:ff:ff, and ff:ff:ff:ff:ff:ff are allowed)",
100 } else if (sscanf(str
, ETH_ADDR_SCAN_FMT
, ETH_ADDR_SCAN_ARGS(mac
))
101 == ETH_ADDR_SCAN_COUNT
) {
102 memset(mask
, 0xff, ETH_ADDR_LEN
);
104 ovs_fatal(0, "invalid mac address %s", str
);
109 str_to_ip(const char *str_
, ovs_be32
*ip
, ovs_be32
*maskp
)
111 char *str
= xstrdup(str_
);
112 char *save_ptr
= NULL
;
113 const char *name
, *netmask
;
114 struct in_addr in_addr
;
118 name
= strtok_r(str
, "/", &save_ptr
);
119 retval
= name
? lookup_ip(name
, &in_addr
) : EINVAL
;
121 ovs_fatal(0, "%s: could not convert to IP address", str
);
123 *ip
= in_addr
.s_addr
;
125 netmask
= strtok_r(NULL
, "/", &save_ptr
);
128 if (sscanf(netmask
, "%"SCNu8
".%"SCNu8
".%"SCNu8
".%"SCNu8
,
129 &o
[0], &o
[1], &o
[2], &o
[3]) == 4) {
130 mask
= htonl((o
[0] << 24) | (o
[1] << 16) | (o
[2] << 8) | o
[3]);
132 int prefix
= atoi(netmask
);
133 if (prefix
<= 0 || prefix
> 32) {
134 ovs_fatal(0, "%s: network prefix bits not between 1 and 32",
136 } else if (prefix
== 32) {
137 mask
= htonl(UINT32_MAX
);
139 mask
= htonl(((1u << prefix
) - 1) << (32 - prefix
));
143 mask
= htonl(UINT32_MAX
);
150 if (mask
!= htonl(UINT32_MAX
)) {
151 ovs_fatal(0, "%s: netmask not allowed here", str_
);
159 str_to_tun_id(const char *str
, ovs_be64
*tun_idp
, ovs_be64
*maskp
)
161 uint64_t tun_id
, mask
;
165 tun_id
= strtoull(str
, &tail
, 0);
166 if (errno
|| (*tail
!= '\0' && *tail
!= '/')) {
171 mask
= strtoull(tail
+ 1, &tail
, 0);
172 if (errno
|| *tail
!= '\0') {
179 *tun_idp
= htonll(tun_id
);
180 *maskp
= htonll(mask
);
184 ovs_fatal(0, "%s: bad syntax for tunnel id", str
);
188 str_to_vlan_tci(const char *str
, ovs_be16
*vlan_tcip
, ovs_be16
*maskp
)
190 uint16_t vlan_tci
, mask
;
194 vlan_tci
= strtol(str
, &tail
, 0);
195 if (errno
|| (*tail
!= '\0' && *tail
!= '/')) {
200 mask
= strtol(tail
+ 1, &tail
, 0);
201 if (errno
|| *tail
!= '\0') {
208 *vlan_tcip
= htons(vlan_tci
);
209 *maskp
= htons(mask
);
213 ovs_fatal(0, "%s: bad syntax for vlan_tci", str
);
217 str_to_ipv6(const char *str_
, struct in6_addr
*addrp
, struct in6_addr
*maskp
)
219 char *str
= xstrdup(str_
);
220 char *save_ptr
= NULL
;
221 const char *name
, *netmask
;
222 struct in6_addr addr
, mask
;
225 name
= strtok_r(str
, "/", &save_ptr
);
226 retval
= name
? lookup_ipv6(name
, &addr
) : EINVAL
;
228 ovs_fatal(0, "%s: could not convert to IPv6 address", str
);
231 netmask
= strtok_r(NULL
, "/", &save_ptr
);
233 int prefix
= atoi(netmask
);
234 if (prefix
<= 0 || prefix
> 128) {
235 ovs_fatal(0, "%s: network prefix bits not between 1 and 128",
238 mask
= ipv6_create_mask(prefix
);
241 mask
= in6addr_exact
;
243 *addrp
= ipv6_addr_bitand(&addr
, &mask
);
248 if (!ipv6_mask_is_exact(&mask
)) {
249 ovs_fatal(0, "%s: netmask not allowed here", str_
);
256 static struct ofp_action_output
*
257 put_output_action(struct ofpbuf
*b
, uint16_t port
)
259 struct ofp_action_output
*oao
;
261 oao
= ofputil_put_OFPAT_OUTPUT(b
);
262 oao
->port
= htons(port
);
267 parse_enqueue(struct ofpbuf
*b
, char *arg
)
270 char *port
= strtok_r(arg
, ":q", &sp
);
271 char *queue
= strtok_r(NULL
, "", &sp
);
272 struct ofp_action_enqueue
*oae
;
274 if (port
== NULL
|| queue
== NULL
) {
275 ovs_fatal(0, "\"enqueue\" syntax is \"enqueue:PORT:QUEUE\"");
278 oae
= ofputil_put_OFPAT_ENQUEUE(b
);
279 oae
->port
= htons(str_to_u32(port
));
280 oae
->queue_id
= htonl(str_to_u32(queue
));
284 parse_output(struct ofpbuf
*b
, char *arg
)
286 if (strchr(arg
, '[')) {
287 struct nx_action_output_reg
*naor
;
291 nxm_parse_field_bits(arg
, &src
, &ofs
, &n_bits
);
293 naor
= ofputil_put_NXAST_OUTPUT_REG(b
);
294 naor
->ofs_nbits
= nxm_encode_ofs_nbits(ofs
, n_bits
);
295 naor
->src
= htonl(src
);
296 naor
->max_len
= htons(UINT16_MAX
);
298 put_output_action(b
, str_to_u32(arg
));
303 parse_resubmit(struct ofpbuf
*b
, char *arg
)
305 struct nx_action_resubmit
*nar
;
306 char *in_port_s
, *table_s
;
310 in_port_s
= strsep(&arg
, ",");
311 if (in_port_s
&& in_port_s
[0]) {
312 if (!ofputil_port_from_string(in_port_s
, &in_port
)) {
313 in_port
= str_to_u32(in_port_s
);
316 in_port
= OFPP_IN_PORT
;
319 table_s
= strsep(&arg
, ",");
320 table
= table_s
&& table_s
[0] ? str_to_u32(table_s
) : 255;
322 if (in_port
== OFPP_IN_PORT
&& table
== 255) {
323 ovs_fatal(0, "at least one \"in_port\" or \"table\" must be specified "
327 if (in_port
!= OFPP_IN_PORT
&& table
== 255) {
328 nar
= ofputil_put_NXAST_RESUBMIT(b
);
330 nar
= ofputil_put_NXAST_RESUBMIT_TABLE(b
);
333 nar
->in_port
= htons(in_port
);
337 parse_set_tunnel(struct ofpbuf
*b
, const char *arg
)
339 uint64_t tun_id
= str_to_u64(arg
);
340 if (tun_id
> UINT32_MAX
) {
341 ofputil_put_NXAST_SET_TUNNEL64(b
)->tun_id
= htonll(tun_id
);
343 ofputil_put_NXAST_SET_TUNNEL(b
)->tun_id
= htonl(tun_id
);
348 parse_note(struct ofpbuf
*b
, const char *arg
)
350 size_t start_ofs
= b
->size
;
351 struct nx_action_note
*nan
;
355 nan
= ofputil_put_NXAST_NOTE(b
);
357 b
->size
-= sizeof nan
->note
;
358 while (*arg
!= '\0') {
369 byte
= hexits_value(arg
, 2, &ok
);
371 ovs_fatal(0, "bad hex digit in `note' argument");
373 ofpbuf_put(b
, &byte
, 1);
378 len
= b
->size
- start_ofs
;
379 remainder
= len
% OFP_ACTION_ALIGN
;
381 ofpbuf_put_zeros(b
, OFP_ACTION_ALIGN
- remainder
);
383 nan
= (struct nx_action_note
*)((char *)b
->data
+ start_ofs
);
384 nan
->len
= htons(b
->size
- start_ofs
);
388 parse_named_action(enum ofputil_action_code code
, struct ofpbuf
*b
, char *arg
)
390 struct ofp_action_dl_addr
*oada
;
391 struct ofp_action_vlan_pcp
*oavp
;
392 struct ofp_action_vlan_vid
*oavv
;
393 struct ofp_action_nw_addr
*oana
;
394 struct ofp_action_tp_port
*oata
;
397 case OFPUTIL_OFPAT_OUTPUT
:
398 parse_output(b
, arg
);
401 case OFPUTIL_OFPAT_SET_VLAN_VID
:
402 oavv
= ofputil_put_OFPAT_SET_VLAN_VID(b
);
403 oavv
->vlan_vid
= htons(str_to_u32(arg
));
406 case OFPUTIL_OFPAT_SET_VLAN_PCP
:
407 oavp
= ofputil_put_OFPAT_SET_VLAN_PCP(b
);
408 oavp
->vlan_pcp
= str_to_u32(arg
);
411 case OFPUTIL_OFPAT_STRIP_VLAN
:
412 ofputil_put_OFPAT_STRIP_VLAN(b
);
415 case OFPUTIL_OFPAT_SET_DL_SRC
:
416 case OFPUTIL_OFPAT_SET_DL_DST
:
417 oada
= ofputil_put_action(code
, b
);
418 str_to_mac(arg
, oada
->dl_addr
);
421 case OFPUTIL_OFPAT_SET_NW_SRC
:
422 case OFPUTIL_OFPAT_SET_NW_DST
:
423 oana
= ofputil_put_action(code
, b
);
424 str_to_ip(arg
, &oana
->nw_addr
, NULL
);
427 case OFPUTIL_OFPAT_SET_NW_TOS
:
428 ofputil_put_OFPAT_SET_NW_TOS(b
)->nw_tos
= str_to_u32(arg
);
431 case OFPUTIL_OFPAT_SET_TP_SRC
:
432 case OFPUTIL_OFPAT_SET_TP_DST
:
433 oata
= ofputil_put_action(code
, b
);
434 oata
->tp_port
= htons(str_to_u32(arg
));
437 case OFPUTIL_OFPAT_ENQUEUE
:
438 parse_enqueue(b
, arg
);
441 case OFPUTIL_NXAST_RESUBMIT
:
442 parse_resubmit(b
, arg
);
445 case OFPUTIL_NXAST_SET_TUNNEL
:
446 parse_set_tunnel(b
, arg
);
449 case OFPUTIL_NXAST_SET_QUEUE
:
450 ofputil_put_NXAST_SET_QUEUE(b
)->queue_id
= htonl(str_to_u32(arg
));
453 case OFPUTIL_NXAST_POP_QUEUE
:
454 ofputil_put_NXAST_POP_QUEUE(b
);
457 case OFPUTIL_NXAST_REG_MOVE
:
458 nxm_parse_reg_move(ofputil_put_NXAST_REG_MOVE(b
), arg
);
461 case OFPUTIL_NXAST_REG_LOAD
:
462 nxm_parse_reg_load(ofputil_put_NXAST_REG_LOAD(b
), arg
);
465 case OFPUTIL_NXAST_NOTE
:
469 case OFPUTIL_NXAST_SET_TUNNEL64
:
470 ofputil_put_NXAST_SET_TUNNEL64(b
)->tun_id
= htonll(str_to_u64(arg
));
473 case OFPUTIL_NXAST_MULTIPATH
:
474 multipath_parse(ofputil_put_NXAST_MULTIPATH(b
), arg
);
477 case OFPUTIL_NXAST_AUTOPATH
:
478 autopath_parse(ofputil_put_NXAST_AUTOPATH(b
), arg
);
481 case OFPUTIL_NXAST_BUNDLE
:
482 bundle_parse(b
, arg
);
485 case OFPUTIL_NXAST_BUNDLE_LOAD
:
486 bundle_parse_load(b
, arg
);
489 case OFPUTIL_NXAST_RESUBMIT_TABLE
:
490 case OFPUTIL_NXAST_OUTPUT_REG
:
496 str_to_action(char *str
, struct ofpbuf
*b
)
505 char empty_string
[] = "";
511 pos
+= strspn(pos
, ", \t\r\n");
517 ovs_fatal(0, "Drop actions must not be followed by other actions");
521 actlen
= strcspn(pos
, ":(, \t\r\n");
522 if (act
[actlen
] == ':') {
523 /* The argument can be separated by a colon. */
526 arg
= act
+ actlen
+ 1;
527 arglen
= strcspn(arg
, ", \t\r\n");
528 pos
= arg
+ arglen
+ (arg
[arglen
] != '\0');
530 } else if (act
[actlen
] == '(') {
531 /* The argument can be surrounded by balanced parentheses. The
532 * outermost set of parentheses is removed. */
536 arg
= act
+ actlen
+ 1;
537 for (arglen
= 0; level
> 0; arglen
++) {
538 switch (arg
[arglen
]) {
540 ovs_fatal(0, "unbalanced parentheses in argument to %s "
552 arg
[arglen
- 1] = '\0';
555 /* There might be no argument at all. */
557 pos
= act
+ actlen
+ (act
[actlen
] != '\0');
561 code
= ofputil_action_code_from_name(act
);
563 parse_named_action(code
, b
, arg
);
564 } else if (!strcasecmp(act
, "drop")) {
565 /* A drop action in OpenFlow occurs by just not setting
569 ovs_fatal(0, "Drop actions must not be preceded by other "
572 } else if (!strcasecmp(act
, "CONTROLLER")) {
573 struct ofp_action_output
*oao
;
574 oao
= put_output_action(b
, OFPP_CONTROLLER
);
576 /* Unless a numeric argument is specified, we send the whole
577 * packet to the controller. */
578 if (arg
[0] && (strspn(arg
, "0123456789") == strlen(arg
))) {
579 oao
->max_len
= htons(str_to_u32(arg
));
581 oao
->max_len
= htons(UINT16_MAX
);
583 } else if (ofputil_port_from_string(act
, &port
)) {
584 put_output_action(b
, port
);
586 ovs_fatal(0, "Unknown action: %s", act
);
599 parse_protocol(const char *name
, const struct protocol
**p_out
)
601 static const struct protocol protocols
[] = {
602 { "ip", ETH_TYPE_IP
, 0 },
603 { "arp", ETH_TYPE_ARP
, 0 },
604 { "icmp", ETH_TYPE_IP
, IPPROTO_ICMP
},
605 { "tcp", ETH_TYPE_IP
, IPPROTO_TCP
},
606 { "udp", ETH_TYPE_IP
, IPPROTO_UDP
},
607 { "ipv6", ETH_TYPE_IPV6
, 0 },
608 { "ip6", ETH_TYPE_IPV6
, 0 },
609 { "icmp6", ETH_TYPE_IPV6
, IPPROTO_ICMPV6
},
610 { "tcp6", ETH_TYPE_IPV6
, IPPROTO_TCP
},
611 { "udp6", ETH_TYPE_IPV6
, IPPROTO_UDP
},
613 const struct protocol
*p
;
615 for (p
= protocols
; p
< &protocols
[ARRAY_SIZE(protocols
)]; p
++) {
616 if (!strcmp(p
->name
, name
)) {
625 BUILD_ASSERT_DECL(FLOW_WC_SEQ
== 1);
627 FIELD(F_TUN_ID, "tun_id", 0) \
628 FIELD(F_IN_PORT, "in_port", FWW_IN_PORT) \
629 FIELD(F_DL_VLAN, "dl_vlan", 0) \
630 FIELD(F_DL_VLAN_PCP, "dl_vlan_pcp", 0) \
631 FIELD(F_VLAN_TCI, "vlan_tci", 0) \
632 FIELD(F_DL_SRC, "dl_src", FWW_DL_SRC) \
633 FIELD(F_DL_DST, "dl_dst", FWW_DL_DST | FWW_ETH_MCAST) \
634 FIELD(F_DL_TYPE, "dl_type", FWW_DL_TYPE) \
635 FIELD(F_NW_SRC, "nw_src", 0) \
636 FIELD(F_NW_DST, "nw_dst", 0) \
637 FIELD(F_NW_PROTO, "nw_proto", FWW_NW_PROTO) \
638 FIELD(F_NW_TOS, "nw_tos", FWW_NW_TOS) \
639 FIELD(F_TP_SRC, "tp_src", FWW_TP_SRC) \
640 FIELD(F_TP_DST, "tp_dst", FWW_TP_DST) \
641 FIELD(F_ICMP_TYPE, "icmp_type", FWW_TP_SRC) \
642 FIELD(F_ICMP_CODE, "icmp_code", FWW_TP_DST) \
643 FIELD(F_ARP_SHA, "arp_sha", FWW_ARP_SHA) \
644 FIELD(F_ARP_THA, "arp_tha", FWW_ARP_THA) \
645 FIELD(F_IPV6_SRC, "ipv6_src", 0) \
646 FIELD(F_IPV6_DST, "ipv6_dst", 0) \
647 FIELD(F_ND_TARGET, "nd_target", FWW_ND_TARGET) \
648 FIELD(F_ND_SLL, "nd_sll", FWW_ARP_SHA) \
649 FIELD(F_ND_TLL, "nd_tll", FWW_ARP_THA)
652 #define FIELD(ENUM, NAME, WILDCARD) ENUM,
659 enum field_index index
;
661 flow_wildcards_t wildcard
; /* FWW_* bit. */
665 ofp_fatal(const char *flow
, bool verbose
, const char *format
, ...)
670 fprintf(stderr
, "%s:\n", flow
);
673 va_start(args
, format
);
674 ovs_fatal_valist(0, format
, args
);
678 parse_field_name(const char *name
, const struct field
**f_out
)
680 static const struct field fields
[N_FIELDS
] = {
681 #define FIELD(ENUM, NAME, WILDCARD) { ENUM, NAME, WILDCARD },
685 const struct field
*f
;
687 for (f
= fields
; f
< &fields
[ARRAY_SIZE(fields
)]; f
++) {
688 if (!strcmp(f
->name
, name
)) {
698 parse_field_value(struct cls_rule
*rule
, enum field_index index
,
701 uint8_t mac
[ETH_ADDR_LEN
], mac_mask
[ETH_ADDR_LEN
];
702 ovs_be64 tun_id
, tun_mask
;
704 ovs_be16 tci
, tci_mask
;
705 struct in6_addr ipv6
, ipv6_mask
;
710 str_to_tun_id(value
, &tun_id
, &tun_mask
);
711 cls_rule_set_tun_id_masked(rule
, tun_id
, tun_mask
);
715 if (!ofputil_port_from_string(value
, &port_no
)) {
716 port_no
= atoi(value
);
718 cls_rule_set_in_port(rule
, port_no
);
722 cls_rule_set_dl_vlan(rule
, htons(str_to_u32(value
)));
726 cls_rule_set_dl_vlan_pcp(rule
, str_to_u32(value
));
730 str_to_vlan_tci(value
, &tci
, &tci_mask
);
731 cls_rule_set_dl_tci_masked(rule
, tci
, tci_mask
);
735 str_to_mac(value
, mac
);
736 cls_rule_set_dl_src(rule
, mac
);
740 str_to_eth_dst(value
, mac
, mac_mask
);
741 cls_rule_set_dl_dst_masked(rule
, mac
, mac_mask
);
745 cls_rule_set_dl_type(rule
, htons(str_to_u32(value
)));
749 str_to_ip(value
, &ip
, &mask
);
750 cls_rule_set_nw_src_masked(rule
, ip
, mask
);
754 str_to_ip(value
, &ip
, &mask
);
755 cls_rule_set_nw_dst_masked(rule
, ip
, mask
);
759 cls_rule_set_nw_proto(rule
, str_to_u32(value
));
763 cls_rule_set_nw_tos(rule
, str_to_u32(value
));
767 cls_rule_set_tp_src(rule
, htons(str_to_u32(value
)));
771 cls_rule_set_tp_dst(rule
, htons(str_to_u32(value
)));
775 cls_rule_set_icmp_type(rule
, str_to_u32(value
));
779 cls_rule_set_icmp_code(rule
, str_to_u32(value
));
783 str_to_mac(value
, mac
);
784 cls_rule_set_arp_sha(rule
, mac
);
788 str_to_mac(value
, mac
);
789 cls_rule_set_arp_tha(rule
, mac
);
793 str_to_ipv6(value
, &ipv6
, &ipv6_mask
);
794 cls_rule_set_ipv6_src_masked(rule
, &ipv6
, &ipv6_mask
);
798 str_to_ipv6(value
, &ipv6
, &ipv6_mask
);
799 cls_rule_set_ipv6_dst_masked(rule
, &ipv6
, &ipv6_mask
);
803 str_to_ipv6(value
, &ipv6
, NULL
);
804 cls_rule_set_nd_target(rule
, &ipv6
);
808 str_to_mac(value
, mac
);
809 cls_rule_set_arp_sha(rule
, mac
);
813 str_to_mac(value
, mac
);
814 cls_rule_set_arp_tha(rule
, mac
);
823 parse_reg_value(struct cls_rule
*rule
, int reg_idx
, const char *value
)
825 /* This uses an oversized destination field (64 bits when 32 bits would do)
826 * because some sscanf() implementations truncate the range of %i
827 * directives, so that e.g. "%"SCNi16 interprets input of "0xfedc" as a
828 * value of 0x7fff. The other alternatives are to allow only a single
829 * radix (e.g. decimal or hexadecimal) or to write more sophisticated
831 unsigned long long int reg_value
, reg_mask
;
833 if (!strcmp(value
, "ANY") || !strcmp(value
, "*")) {
834 cls_rule_set_reg_masked(rule
, reg_idx
, 0, 0);
835 } else if (sscanf(value
, "%lli/%lli",
836 ®_value
, ®_mask
) == 2) {
837 cls_rule_set_reg_masked(rule
, reg_idx
, reg_value
, reg_mask
);
838 } else if (sscanf(value
, "%lli", ®_value
)) {
839 cls_rule_set_reg(rule
, reg_idx
, reg_value
);
841 ovs_fatal(0, "register fields must take the form <value> "
842 "or <value>/<mask>");
846 /* Convert 'str_' (as described in the Flow Syntax section of the ovs-ofctl man
847 * page) into 'fm' for sending the specified flow_mod 'command' to a switch.
848 * If 'actions' is specified, an action must be in 'string' and may be expanded
851 * To parse syntax for an OFPT_FLOW_MOD (or NXT_FLOW_MOD), use an OFPFC_*
852 * constant for 'command'. To parse syntax for an OFPST_FLOW or
853 * OFPST_AGGREGATE (or NXST_FLOW or NXST_AGGREGATE), use -1 for 'command'. */
855 parse_ofp_str(struct ofputil_flow_mod
*fm
, int command
, const char *str_
,
865 char *string
= xstrdup(str_
);
866 char *save_ptr
= NULL
;
875 fields
= F_ACTIONS
| F_COOKIE
| F_TIMEOUT
| F_PRIORITY
;
882 case OFPFC_DELETE_STRICT
:
883 fields
= F_OUT_PORT
| F_PRIORITY
;
887 fields
= F_ACTIONS
| F_COOKIE
;
890 case OFPFC_MODIFY_STRICT
:
891 fields
= F_ACTIONS
| F_COOKIE
| F_PRIORITY
;
898 cls_rule_init_catchall(&fm
->cr
, OFP_DEFAULT_PRIORITY
);
899 fm
->cookie
= htonll(0);
901 fm
->command
= command
;
902 fm
->idle_timeout
= OFP_FLOW_PERMANENT
;
903 fm
->hard_timeout
= OFP_FLOW_PERMANENT
;
904 fm
->buffer_id
= UINT32_MAX
;
905 fm
->out_port
= OFPP_NONE
;
907 if (fields
& F_ACTIONS
) {
908 struct ofpbuf actions
;
911 act_str
= strstr(string
, "action");
913 ofp_fatal(str_
, verbose
, "must specify an action");
917 act_str
= strchr(act_str
+ 1, '=');
919 ofp_fatal(str_
, verbose
, "must specify an action");
924 ofpbuf_init(&actions
, sizeof(union ofp_action
));
925 str_to_action(act_str
, &actions
);
926 fm
->actions
= ofpbuf_steal_data(&actions
);
927 fm
->n_actions
= actions
.size
/ sizeof(union ofp_action
);
932 for (name
= strtok_r(string
, "=, \t\r\n", &save_ptr
); name
;
933 name
= strtok_r(NULL
, "=, \t\r\n", &save_ptr
)) {
934 const struct protocol
*p
;
936 if (parse_protocol(name
, &p
)) {
937 cls_rule_set_dl_type(&fm
->cr
, htons(p
->dl_type
));
939 cls_rule_set_nw_proto(&fm
->cr
, p
->nw_proto
);
942 const struct field
*f
;
945 value
= strtok_r(NULL
, ", \t\r\n", &save_ptr
);
947 ofp_fatal(str_
, verbose
, "field %s missing value", name
);
950 if (!strcmp(name
, "table")) {
951 fm
->table_id
= atoi(value
);
952 } else if (!strcmp(name
, "out_port")) {
953 fm
->out_port
= atoi(value
);
954 } else if (fields
& F_PRIORITY
&& !strcmp(name
, "priority")) {
955 fm
->cr
.priority
= atoi(value
);
956 } else if (fields
& F_TIMEOUT
&& !strcmp(name
, "idle_timeout")) {
957 fm
->idle_timeout
= atoi(value
);
958 } else if (fields
& F_TIMEOUT
&& !strcmp(name
, "hard_timeout")) {
959 fm
->hard_timeout
= atoi(value
);
960 } else if (fields
& F_COOKIE
&& !strcmp(name
, "cookie")) {
961 fm
->cookie
= htonll(str_to_u64(value
));
962 } else if (parse_field_name(name
, &f
)) {
963 if (!strcmp(value
, "*") || !strcmp(value
, "ANY")) {
965 fm
->cr
.wc
.wildcards
|= f
->wildcard
;
966 cls_rule_zero_wildcarded_fields(&fm
->cr
);
967 } else if (f
->index
== F_NW_SRC
) {
968 cls_rule_set_nw_src_masked(&fm
->cr
, 0, 0);
969 } else if (f
->index
== F_NW_DST
) {
970 cls_rule_set_nw_dst_masked(&fm
->cr
, 0, 0);
971 } else if (f
->index
== F_IPV6_SRC
) {
972 cls_rule_set_ipv6_src_masked(&fm
->cr
,
973 &in6addr_any
, &in6addr_any
);
974 } else if (f
->index
== F_IPV6_DST
) {
975 cls_rule_set_ipv6_dst_masked(&fm
->cr
,
976 &in6addr_any
, &in6addr_any
);
977 } else if (f
->index
== F_DL_VLAN
) {
978 cls_rule_set_any_vid(&fm
->cr
);
979 } else if (f
->index
== F_DL_VLAN_PCP
) {
980 cls_rule_set_any_pcp(&fm
->cr
);
985 parse_field_value(&fm
->cr
, f
->index
, value
);
987 } else if (!strncmp(name
, "reg", 3)
988 && isdigit((unsigned char) name
[3])) {
989 unsigned int reg_idx
= atoi(name
+ 3);
990 if (reg_idx
>= FLOW_N_REGS
) {
992 fprintf(stderr
, "%s:\n", str_
);
994 ofp_fatal(str_
, verbose
, "only %d registers supported", FLOW_N_REGS
);
996 parse_reg_value(&fm
->cr
, reg_idx
, value
);
997 } else if (!strcmp(name
, "duration")
998 || !strcmp(name
, "n_packets")
999 || !strcmp(name
, "n_bytes")) {
1000 /* Ignore these, so that users can feed the output of
1001 * "ovs-ofctl dump-flows" back into commands that parse
1004 ofp_fatal(str_
, verbose
, "unknown keyword %s", name
);
1012 /* Parses 'string' as an OFPT_FLOW_MOD or NXT_FLOW_MOD with command 'command'
1013 * (one of OFPFC_*) and appends the parsed OpenFlow message to 'packets'.
1014 * '*cur_format' should initially contain the flow format currently configured
1015 * on the connection; this function will add a message to change the flow
1016 * format and update '*cur_format', if this is necessary to add the parsed
1019 parse_ofp_flow_mod_str(struct list
*packets
, enum nx_flow_format
*cur_format
,
1020 bool *flow_mod_table_id
, char *string
, uint16_t command
,
1023 enum nx_flow_format min_format
, next_format
;
1024 struct cls_rule rule_copy
;
1025 struct ofpbuf actions
;
1027 struct ofputil_flow_mod fm
;
1029 ofpbuf_init(&actions
, 64);
1030 parse_ofp_str(&fm
, command
, string
, verbose
);
1032 min_format
= ofputil_min_flow_format(&fm
.cr
);
1033 next_format
= MAX(*cur_format
, min_format
);
1034 if (next_format
!= *cur_format
) {
1035 struct ofpbuf
*sff
= ofputil_make_set_flow_format(next_format
);
1036 list_push_back(packets
, &sff
->list_node
);
1037 *cur_format
= next_format
;
1040 /* Normalize a copy of the rule. This ensures that non-normalized flows
1041 * get logged but doesn't affect what gets sent to the switch, so that the
1042 * switch can do whatever it likes with the flow. */
1044 ofputil_normalize_rule(&rule_copy
, next_format
);
1046 if (fm
.table_id
!= 0xff && !*flow_mod_table_id
) {
1047 struct ofpbuf
*sff
= ofputil_make_flow_mod_table_id(true);
1048 list_push_back(packets
, &sff
->list_node
);
1049 *flow_mod_table_id
= true;
1052 ofm
= ofputil_encode_flow_mod(&fm
, *cur_format
, *flow_mod_table_id
);
1053 list_push_back(packets
, &ofm
->list_node
);
1055 ofpbuf_uninit(&actions
);
1058 /* Similar to parse_ofp_flow_mod_str(), except that the string is read from
1059 * 'stream' and the command is always OFPFC_ADD. Returns false if end-of-file
1060 * is reached before reading a flow, otherwise true. */
1062 parse_ofp_flow_mod_file(struct list
*packets
,
1063 enum nx_flow_format
*cur
, bool *flow_mod_table_id
,
1064 FILE *stream
, uint16_t command
)
1070 ok
= ds_get_preprocessed_line(&s
, stream
) == 0;
1072 parse_ofp_flow_mod_str(packets
, cur
, flow_mod_table_id
,
1073 ds_cstr(&s
), command
, true);
1081 parse_ofp_flow_stats_request_str(struct ofputil_flow_stats_request
*fsr
,
1082 bool aggregate
, char *string
)
1084 struct ofputil_flow_mod fm
;
1086 parse_ofp_str(&fm
, -1, string
, false);
1087 fsr
->aggregate
= aggregate
;
1089 fsr
->out_port
= fm
.out_port
;
1090 fsr
->table_id
= fm
.table_id
;