]>
Commit | Line | Data |
---|---|---|
09246b99 | 1 | /* |
b71273f6 | 2 | * Copyright (c) 2010, 2011, 2012, 2013, 2014 Nicira, Inc. |
09246b99 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 | #ifndef NX_MATCH_H | |
18 | #define NX_MATCH_H 1 | |
19 | ||
20 | #include <stdint.h> | |
c979df05 BP |
21 | #include <sys/types.h> |
22 | #include <netinet/in.h> | |
bdda5aca | 23 | #include "compiler.h" |
e9358af6 | 24 | #include "flow.h" |
178742f9 | 25 | #include "meta-flow.h" |
f25d0cf3 | 26 | #include "ofp-errors.h" |
c979df05 | 27 | #include "openvswitch/types.h" |
09246b99 | 28 | |
f393f81e | 29 | struct ds; |
81a76618 | 30 | struct match; |
f25d0cf3 BP |
31 | struct ofpact_reg_move; |
32 | struct ofpact_reg_load; | |
bd85dac1 | 33 | struct ofpact_stack; |
09246b99 | 34 | struct ofpbuf; |
b6c9e612 BP |
35 | struct nx_action_reg_load; |
36 | struct nx_action_reg_move; | |
09246b99 | 37 | |
bd85dac1 | 38 | |
09246b99 BP |
39 | /* Nicira Extended Match (NXM) flexible flow match helper functions. |
40 | * | |
41 | * See include/openflow/nicira-ext.h for NXM specification. | |
42 | */ | |
43 | ||
178742f9 BP |
44 | void mf_format_subfield(const struct mf_subfield *, struct ds *); |
45 | char *mf_parse_subfield__(struct mf_subfield *sf, const char **s) | |
cab50449 | 46 | OVS_WARN_UNUSED_RESULT; |
178742f9 | 47 | char *mf_parse_subfield(struct mf_subfield *, const char *s) |
cab50449 | 48 | OVS_WARN_UNUSED_RESULT; |
178742f9 | 49 | |
90bf1e07 | 50 | enum ofperr nx_pull_match(struct ofpbuf *, unsigned int match_len, |
81a76618 | 51 | struct match *, |
90bf1e07 BP |
52 | ovs_be64 *cookie, ovs_be64 *cookie_mask); |
53 | enum ofperr nx_pull_match_loose(struct ofpbuf *, unsigned int match_len, | |
81a76618 | 54 | struct match *, ovs_be64 *cookie, |
7623f4dd | 55 | ovs_be64 *cookie_mask); |
81a76618 BP |
56 | enum ofperr oxm_pull_match(struct ofpbuf *, struct match *); |
57 | enum ofperr oxm_pull_match_loose(struct ofpbuf *, struct match *); | |
bc65c25a SH |
58 | enum ofperr oxm_pull_field_array(const void *, size_t fields_len, |
59 | struct field_array *); | |
81a76618 | 60 | int nx_put_match(struct ofpbuf *, const struct match *, |
e729e793 | 61 | ovs_be64 cookie, ovs_be64 cookie_mask); |
9d84066c | 62 | int oxm_put_match(struct ofpbuf *, const struct match *, enum ofp_version); |
53eb84a5 SH |
63 | void oxm_format_field_array(struct ds *, const struct field_array *); |
64 | int oxm_put_field_array(struct ofpbuf *, const struct field_array *, | |
65 | enum ofp_version version); | |
09246b99 | 66 | |
178742f9 BP |
67 | /* Decoding and encoding OXM/NXM headers (just a field ID) or entries (a field |
68 | * ID followed by a value and possibly a mask). */ | |
69 | enum ofperr nx_pull_entry(struct ofpbuf *, const struct mf_field **, | |
70 | union mf_value *value, union mf_value *mask); | |
71 | enum ofperr nx_pull_header(struct ofpbuf *, const struct mf_field **, | |
72 | bool *masked); | |
73 | void nx_put_entry(struct ofpbuf *, enum mf_field_id, enum ofp_version, | |
74 | const union mf_value *value, const union mf_value *mask); | |
75 | void nx_put_header(struct ofpbuf *, enum mf_field_id, enum ofp_version, | |
76 | bool masked); | |
77 | ||
78 | /* NXM and OXM protocol headers values. | |
79 | * | |
80 | * These are often alternatives to nx_pull_entry/header() and | |
81 | * nx_put_entry/header() for decoding and encoding OXM/NXM. In those cases, | |
82 | * the nx_*() functions should be preferred because they can support the 64-bit | |
83 | * "experimenter" OXM format (even though it is not yet implemented). */ | |
508a9338 | 84 | uint32_t mf_nxm_header(enum mf_field_id); |
178742f9 BP |
85 | const struct mf_field *mf_from_nxm_header(uint32_t nxm_header); |
86 | ||
09246b99 | 87 | char *nx_match_to_string(const uint8_t *, unsigned int match_len); |
db5a1019 | 88 | char *oxm_match_to_string(const struct ofpbuf *, unsigned int match_len); |
09246b99 | 89 | int nx_match_from_string(const char *, struct ofpbuf *); |
7623f4dd | 90 | int oxm_match_from_string(const char *, struct ofpbuf *); |
09246b99 | 91 | |
178742f9 BP |
92 | void nx_format_field_name(enum mf_field_id, enum ofp_version, struct ds *); |
93 | ||
bdda5aca | 94 | char *nxm_parse_reg_move(struct ofpact_reg_move *, const char *) |
cab50449 | 95 | OVS_WARN_UNUSED_RESULT; |
f25d0cf3 BP |
96 | |
97 | void nxm_format_reg_move(const struct ofpact_reg_move *, struct ds *); | |
f393f81e | 98 | |
f25d0cf3 | 99 | enum ofperr nxm_reg_move_check(const struct ofpact_reg_move *, |
816fd533 | 100 | const struct flow *); |
b6c9e612 | 101 | |
bcd2633a JP |
102 | void nxm_execute_reg_move(const struct ofpact_reg_move *, struct flow *, |
103 | struct flow_wildcards *); | |
f25d0cf3 | 104 | void nxm_reg_load(const struct mf_subfield *, uint64_t src_data, |
f74e7df7 | 105 | struct flow *, struct flow_wildcards *); |
b6c9e612 | 106 | |
bdda5aca | 107 | char *nxm_parse_stack_action(struct ofpact_stack *, const char *) |
cab50449 | 108 | OVS_WARN_UNUSED_RESULT; |
bd85dac1 AZ |
109 | |
110 | void nxm_format_stack_push(const struct ofpact_stack *, struct ds *); | |
111 | void nxm_format_stack_pop(const struct ofpact_stack *, struct ds *); | |
112 | ||
bd85dac1 AZ |
113 | enum ofperr nxm_stack_push_check(const struct ofpact_stack *, |
114 | const struct flow *); | |
115 | enum ofperr nxm_stack_pop_check(const struct ofpact_stack *, | |
116 | const struct flow *); | |
117 | ||
bd85dac1 | 118 | void nxm_execute_stack_push(const struct ofpact_stack *, |
bcd2633a JP |
119 | const struct flow *, struct flow_wildcards *, |
120 | struct ofpbuf *); | |
bd85dac1 | 121 | void nxm_execute_stack_pop(const struct ofpact_stack *, |
f74e7df7 JP |
122 | struct flow *, struct flow_wildcards *, |
123 | struct ofpbuf *); | |
bd85dac1 | 124 | |
178742f9 BP |
125 | ovs_be64 oxm_bitmap_from_mf_bitmap(const struct mf_bitmap *, enum ofp_version); |
126 | struct mf_bitmap oxm_bitmap_to_mf_bitmap(ovs_be64 oxm_bitmap, | |
127 | enum ofp_version); | |
128 | struct mf_bitmap oxm_writable_fields(void); | |
129 | struct mf_bitmap oxm_matchable_fields(void); | |
130 | struct mf_bitmap oxm_maskable_fields(void); | |
4291acd2 | 131 | |
816fd533 | 132 | /* Dealing with the 'ofs_nbits' members in several Nicira extensions. */ |
c979df05 BP |
133 | |
134 | static inline ovs_be16 | |
135 | nxm_encode_ofs_nbits(int ofs, int n_bits) | |
136 | { | |
137 | return htons((ofs << 6) | (n_bits - 1)); | |
138 | } | |
139 | ||
140 | static inline int | |
141 | nxm_decode_ofs(ovs_be16 ofs_nbits) | |
142 | { | |
143 | return ntohs(ofs_nbits) >> 6; | |
144 | } | |
145 | ||
146 | static inline int | |
147 | nxm_decode_n_bits(ovs_be16 ofs_nbits) | |
148 | { | |
149 | return (ntohs(ofs_nbits) & 0x3f) + 1; | |
150 | } | |
151 | \f | |
2e4f5fcf BP |
152 | /* This is my guess at the length of a "typical" nx_match, for use in |
153 | * predicting space requirements. */ | |
154 | #define NXM_TYPICAL_LEN 64 | |
155 | ||
09246b99 | 156 | #endif /* nx-match.h */ |