2 * Copyright (c) 2009, 2010, 2011, 2012 Nicira, Inc.
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.
24 /* A flow classification match.
26 * Use one of the match_*() functions to initialize a "struct match".
28 * The match_*() functions below maintain the following important invariant.
29 * If a bit or a field is wildcarded in 'wc', then the corresponding bit or
30 * field in 'flow' is set to all-0-bits. (The match_zero_wildcarded_fields()
31 * function can be used to restore this invariant after adding wildcards.) */
34 struct flow_wildcards wc;
37 void match_init(struct match *,
38 const struct flow *, const struct flow_wildcards *);
39 void match_init_catchall(struct match *);
40 void match_init_exact(struct match *, const struct flow *);
42 void match_zero_wildcarded_fields(struct match *);
44 void match_set_reg(struct match *, unsigned int reg_idx, uint32_t value);
45 void match_set_reg_masked(struct match *, unsigned int reg_idx,
46 uint32_t value, uint32_t mask);
47 void match_set_metadata(struct match *, ovs_be64 metadata);
48 void match_set_metadata_masked(struct match *,
49 ovs_be64 metadata, ovs_be64 mask);
50 void match_set_tun_id(struct match *, ovs_be64 tun_id);
51 void match_set_tun_id_masked(struct match *, ovs_be64 tun_id, ovs_be64 mask);
52 void match_set_in_port(struct match *, uint16_t ofp_port);
53 void match_set_dl_type(struct match *, ovs_be16);
54 void match_set_dl_src(struct match *, const uint8_t[6]);
55 void match_set_dl_src_masked(struct match *, const uint8_t dl_src[6],
56 const uint8_t mask[6]);
57 void match_set_dl_dst(struct match *, const uint8_t[6]);
58 void match_set_dl_dst_masked(struct match *, const uint8_t dl_dst[6],
59 const uint8_t mask[6]);
60 void match_set_dl_tci(struct match *, ovs_be16 tci);
61 void match_set_dl_tci_masked(struct match *, ovs_be16 tci, ovs_be16 mask);
62 void match_set_any_vid(struct match *);
63 void match_set_dl_vlan(struct match *, ovs_be16);
64 void match_set_vlan_vid(struct match *, ovs_be16);
65 void match_set_vlan_vid_masked(struct match *, ovs_be16 vid, ovs_be16 mask);
66 void match_set_any_pcp(struct match *);
67 void match_set_dl_vlan_pcp(struct match *, uint8_t);
68 void match_set_tp_src(struct match *, ovs_be16);
69 void match_set_tp_src_masked(struct match *, ovs_be16 port, ovs_be16 mask);
70 void match_set_tp_dst(struct match *, ovs_be16);
71 void match_set_tp_dst_masked(struct match *, ovs_be16 port, ovs_be16 mask);
72 void match_set_nw_proto(struct match *, uint8_t);
73 void match_set_nw_src(struct match *, ovs_be32);
74 void match_set_nw_src_masked(struct match *, ovs_be32 ip, ovs_be32 mask);
75 void match_set_nw_dst(struct match *, ovs_be32);
76 void match_set_nw_dst_masked(struct match *, ovs_be32 ip, ovs_be32 mask);
77 void match_set_nw_dscp(struct match *, uint8_t);
78 void match_set_nw_ecn(struct match *, uint8_t);
79 void match_set_nw_ttl(struct match *, uint8_t);
80 void match_set_nw_frag(struct match *, uint8_t nw_frag);
81 void match_set_nw_frag_masked(struct match *, uint8_t nw_frag, uint8_t mask);
82 void match_set_icmp_type(struct match *, uint8_t);
83 void match_set_icmp_code(struct match *, uint8_t);
84 void match_set_arp_sha(struct match *, const uint8_t[6]);
85 void match_set_arp_sha_masked(struct match *,
86 const uint8_t arp_sha[6],
87 const uint8_t mask[6]);
88 void match_set_arp_tha(struct match *, const uint8_t[6]);
89 void match_set_arp_tha_masked(struct match *,
90 const uint8_t arp_tha[6],
91 const uint8_t mask[6]);
92 void match_set_ipv6_src(struct match *, const struct in6_addr *);
93 void match_set_ipv6_src_masked(struct match *, const struct in6_addr *,
94 const struct in6_addr *);
95 void match_set_ipv6_dst(struct match *, const struct in6_addr *);
96 void match_set_ipv6_dst_masked(struct match *, const struct in6_addr *,
97 const struct in6_addr *);
98 void match_set_ipv6_label(struct match *, ovs_be32);
99 void match_set_ipv6_label_masked(struct match *, ovs_be32, ovs_be32);
100 void match_set_nd_target(struct match *, const struct in6_addr *);
101 void match_set_nd_target_masked(struct match *, const struct in6_addr *,
102 const struct in6_addr *);
104 bool match_equal(const struct match *, const struct match *);
105 uint32_t match_hash(const struct match *, uint32_t basis);
107 void match_format(const struct match *, struct ds *, unsigned int priority);
108 char *match_to_string(const struct match *, unsigned int priority);
109 void match_print(const struct match *);
111 /* Compressed match. */
113 /* A sparse representation of a "struct match".
115 * This has the same invariant as "struct match", that is, a 1-bit in the
116 * 'flow' must correspond to a 1-bit in 'mask'.
118 * The invariants for the underlying miniflow and minimask are also maintained,
119 * which means that 'flow' and 'mask' can have different 'map's. In
120 * particular, if the match checks that a given 32-bit field has value 0, then
121 * 'map' will have a 1-bit in 'mask' but a 0-bit in 'flow' for that field. */
123 struct miniflow flow;
124 struct minimask mask;
127 void minimatch_init(struct minimatch *, const struct match *);
128 void minimatch_clone(struct minimatch *, const struct minimatch *);
129 void minimatch_destroy(struct minimatch *);
131 void minimatch_expand(const struct minimatch *, struct match *);
133 bool minimatch_equal(const struct minimatch *a, const struct minimatch *b);
134 uint32_t minimatch_hash(const struct minimatch *, uint32_t basis);
136 void minimatch_format(const struct minimatch *, struct ds *,
137 unsigned int priority);
138 char *minimatch_to_string(const struct minimatch *, unsigned int priority);