]>
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) | |
46 | WARN_UNUSED_RESULT; | |
47 | char *mf_parse_subfield(struct mf_subfield *, const char *s) | |
48 | WARN_UNUSED_RESULT; | |
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 *); | |
58 | int nx_put_match(struct ofpbuf *, const struct match *, | |
e729e793 | 59 | ovs_be64 cookie, ovs_be64 cookie_mask); |
9d84066c | 60 | int oxm_put_match(struct ofpbuf *, const struct match *, enum ofp_version); |
09246b99 | 61 | |
178742f9 BP |
62 | /* Decoding and encoding OXM/NXM headers (just a field ID) or entries (a field |
63 | * ID followed by a value and possibly a mask). */ | |
64 | enum ofperr nx_pull_entry(struct ofpbuf *, const struct mf_field **, | |
65 | union mf_value *value, union mf_value *mask); | |
66 | enum ofperr nx_pull_header(struct ofpbuf *, const struct mf_field **, | |
67 | bool *masked); | |
68 | void nx_put_entry(struct ofpbuf *, enum mf_field_id, enum ofp_version, | |
69 | const union mf_value *value, const union mf_value *mask); | |
70 | void nx_put_header(struct ofpbuf *, enum mf_field_id, enum ofp_version, | |
71 | bool masked); | |
72 | ||
73 | /* NXM and OXM protocol headers values. | |
74 | * | |
75 | * These are often alternatives to nx_pull_entry/header() and | |
76 | * nx_put_entry/header() for decoding and encoding OXM/NXM. In those cases, | |
77 | * the nx_*() functions should be preferred because they can support the 64-bit | |
78 | * "experimenter" OXM format (even though it is not yet implemented). */ | |
508a9338 | 79 | uint32_t mf_nxm_header(enum mf_field_id); |
178742f9 BP |
80 | const struct mf_field *mf_from_nxm_header(uint32_t nxm_header); |
81 | ||
09246b99 | 82 | char *nx_match_to_string(const uint8_t *, unsigned int match_len); |
db5a1019 | 83 | char *oxm_match_to_string(const struct ofpbuf *, unsigned int match_len); |
09246b99 | 84 | int nx_match_from_string(const char *, struct ofpbuf *); |
7623f4dd | 85 | int oxm_match_from_string(const char *, struct ofpbuf *); |
09246b99 | 86 | |
178742f9 BP |
87 | void nx_format_field_name(enum mf_field_id, enum ofp_version, struct ds *); |
88 | ||
bdda5aca BP |
89 | char *nxm_parse_reg_move(struct ofpact_reg_move *, const char *) |
90 | WARN_UNUSED_RESULT; | |
f25d0cf3 BP |
91 | |
92 | void nxm_format_reg_move(const struct ofpact_reg_move *, struct ds *); | |
f393f81e | 93 | |
f25d0cf3 | 94 | enum ofperr nxm_reg_move_check(const struct ofpact_reg_move *, |
816fd533 | 95 | const struct flow *); |
b6c9e612 | 96 | |
bcd2633a JP |
97 | void nxm_execute_reg_move(const struct ofpact_reg_move *, struct flow *, |
98 | struct flow_wildcards *); | |
f25d0cf3 | 99 | void nxm_reg_load(const struct mf_subfield *, uint64_t src_data, |
f74e7df7 | 100 | struct flow *, struct flow_wildcards *); |
b6c9e612 | 101 | |
bdda5aca BP |
102 | char *nxm_parse_stack_action(struct ofpact_stack *, const char *) |
103 | WARN_UNUSED_RESULT; | |
bd85dac1 AZ |
104 | |
105 | void nxm_format_stack_push(const struct ofpact_stack *, struct ds *); | |
106 | void nxm_format_stack_pop(const struct ofpact_stack *, struct ds *); | |
107 | ||
bd85dac1 AZ |
108 | enum ofperr nxm_stack_push_check(const struct ofpact_stack *, |
109 | const struct flow *); | |
110 | enum ofperr nxm_stack_pop_check(const struct ofpact_stack *, | |
111 | const struct flow *); | |
112 | ||
bd85dac1 | 113 | void nxm_execute_stack_push(const struct ofpact_stack *, |
bcd2633a JP |
114 | const struct flow *, struct flow_wildcards *, |
115 | struct ofpbuf *); | |
bd85dac1 | 116 | void nxm_execute_stack_pop(const struct ofpact_stack *, |
f74e7df7 JP |
117 | struct flow *, struct flow_wildcards *, |
118 | struct ofpbuf *); | |
bd85dac1 | 119 | |
178742f9 BP |
120 | ovs_be64 oxm_bitmap_from_mf_bitmap(const struct mf_bitmap *, enum ofp_version); |
121 | struct mf_bitmap oxm_bitmap_to_mf_bitmap(ovs_be64 oxm_bitmap, | |
122 | enum ofp_version); | |
123 | struct mf_bitmap oxm_writable_fields(void); | |
124 | struct mf_bitmap oxm_matchable_fields(void); | |
125 | struct mf_bitmap oxm_maskable_fields(void); | |
4291acd2 | 126 | |
816fd533 | 127 | /* Dealing with the 'ofs_nbits' members in several Nicira extensions. */ |
c979df05 BP |
128 | |
129 | static inline ovs_be16 | |
130 | nxm_encode_ofs_nbits(int ofs, int n_bits) | |
131 | { | |
132 | return htons((ofs << 6) | (n_bits - 1)); | |
133 | } | |
134 | ||
135 | static inline int | |
136 | nxm_decode_ofs(ovs_be16 ofs_nbits) | |
137 | { | |
138 | return ntohs(ofs_nbits) >> 6; | |
139 | } | |
140 | ||
141 | static inline int | |
142 | nxm_decode_n_bits(ovs_be16 ofs_nbits) | |
143 | { | |
144 | return (ntohs(ofs_nbits) & 0x3f) + 1; | |
145 | } | |
146 | \f | |
2e4f5fcf BP |
147 | /* This is my guess at the length of a "typical" nx_match, for use in |
148 | * predicting space requirements. */ | |
149 | #define NXM_TYPICAL_LEN 64 | |
150 | ||
09246b99 | 151 | #endif /* nx-match.h */ |