]>
git.proxmox.com Git - mirror_ovs.git/blob - lib/nx-match.h
2 * Copyright (c) 2010-2017, 2020 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.
21 #include <sys/types.h>
22 #include <netinet/in.h>
25 #include "openvswitch/meta-flow.h"
26 #include "openvswitch/ofp-errors.h"
27 #include "openvswitch/types.h"
31 struct ofpact_reg_move
;
32 struct ofpact_reg_load
;
35 struct nx_action_reg_load
;
36 struct nx_action_reg_move
;
40 /* Nicira Extended Match (NXM) flexible flow match helper functions.
42 * See include/openflow/nicira-ext.h for NXM specification.
45 char * mf_parse_field(const struct mf_field
**field
, const char *s
)
46 OVS_WARN_UNUSED_RESULT
;
47 void mf_format_subfield(const struct mf_subfield
*, struct ds
*);
48 char *mf_parse_subfield__(struct mf_subfield
*sf
, const char **s
)
49 OVS_WARN_UNUSED_RESULT
;
50 char *mf_parse_subfield(struct mf_subfield
*, const char *s
)
51 OVS_WARN_UNUSED_RESULT
;
53 /* Decoding matches. */
54 enum ofperr
nx_pull_match(struct ofpbuf
*, unsigned int match_len
,
55 struct match
*, ovs_be64
*cookie
,
56 ovs_be64
*cookie_mask
, bool pipeline_fields_only
,
57 const struct tun_table
*, const struct vl_mff_map
*);
58 enum ofperr
nx_pull_match_loose(struct ofpbuf
*, unsigned int match_len
,
59 struct match
*, ovs_be64
*cookie
,
60 ovs_be64
*cookie_mask
,
61 bool pipeline_fields_only
,
62 const struct tun_table
*);
63 enum ofperr
oxm_pull_match(struct ofpbuf
*, bool pipeline_fields_only
,
64 const struct tun_table
*, const struct vl_mff_map
*,
66 enum ofperr
oxm_pull_match_loose(struct ofpbuf
*, bool pipeline_fields_only
,
67 const struct tun_table
*, struct match
*);
68 enum ofperr
oxm_decode_match(const void *, size_t, bool,
69 const struct tun_table
*,
70 const struct vl_mff_map
*, struct match
*);
71 enum ofperr
oxm_pull_field_array(const void *, size_t fields_len
,
72 struct field_array
*);
74 /* Encoding matches. */
75 int nx_put_match(struct ofpbuf
*, const struct match
*,
76 ovs_be64 cookie
, ovs_be64 cookie_mask
);
77 int oxm_put_match(struct ofpbuf
*, const struct match
*, enum ofp_version
);
78 void oxm_put_raw(struct ofpbuf
*, const struct match
*, enum ofp_version
);
79 void oxm_format_field_array(struct ds
*, const struct field_array
*);
80 int oxm_put_field_array(struct ofpbuf
*, const struct field_array
*,
81 enum ofp_version version
);
83 /* Decoding and encoding OXM/NXM headers (just a field ID) or entries (a field
84 * ID followed by a value and possibly a mask). */
85 enum ofperr
nx_pull_entry(struct ofpbuf
*, const struct vl_mff_map
*,
86 const struct mf_field
**, union mf_value
*value
,
87 union mf_value
*mask
, bool is_action
);
88 enum ofperr
nx_pull_header(struct ofpbuf
*, const struct vl_mff_map
*,
89 const struct mf_field
**, bool *masked
);
90 void nxm_put_entry_raw(struct ofpbuf
*, enum mf_field_id field
,
91 enum ofp_version version
, const void *value
,
92 const void *mask
, size_t n_bytes
);
93 void nx_put_entry(struct ofpbuf
*, const struct mf_field
*, enum ofp_version
,
94 const union mf_value
*value
, const union mf_value
*mask
);
95 void nx_put_header(struct ofpbuf
*, enum mf_field_id
, enum ofp_version
,
97 void nx_put_mff_header(struct ofpbuf
*, const struct mf_field
*,
98 enum ofp_version
, bool);
100 /* NXM and OXM protocol headers values.
102 * These are often alternatives to nx_pull_entry/header() and
103 * nx_put_entry/header() for decoding and encoding OXM/NXM. In those cases,
104 * the nx_*() functions should be preferred because they can support the 64-bit
105 * "experimenter" OXM format (even though it is not yet implemented). */
106 uint32_t mf_nxm_header(enum mf_field_id
);
107 uint32_t nxm_header_from_mff(const struct mf_field
*);
108 const struct mf_field
*mf_from_nxm_header(uint32_t nxm_header
,
109 const struct vl_mff_map
*);
111 char *nx_match_to_string(const uint8_t *, unsigned int match_len
);
112 char *oxm_match_to_string(const struct ofpbuf
*, unsigned int match_len
);
113 int nx_match_from_string(const char *, struct ofpbuf
*);
114 int oxm_match_from_string(const char *, struct ofpbuf
*);
116 void nx_format_field_name(enum mf_field_id
, enum ofp_version
, struct ds
*);
118 char *nxm_parse_reg_move(struct ofpact_reg_move
*, const char *)
119 OVS_WARN_UNUSED_RESULT
;
121 void nxm_format_reg_move(const struct ofpact_reg_move
*, struct ds
*);
123 enum ofperr
nxm_reg_move_check(const struct ofpact_reg_move
*,
124 const struct match
*);
126 void nxm_reg_load(const struct mf_subfield
*, uint64_t src_data
,
127 struct flow
*, struct flow_wildcards
*);
129 char *nxm_parse_stack_action(struct ofpact_stack
*, const char *)
130 OVS_WARN_UNUSED_RESULT
;
132 void nxm_format_stack_push(const struct ofpact_stack
*, struct ds
*);
133 void nxm_format_stack_pop(const struct ofpact_stack
*, struct ds
*);
135 enum ofperr
nxm_stack_push_check(const struct ofpact_stack
*,
136 const struct match
*);
137 enum ofperr
nxm_stack_pop_check(const struct ofpact_stack
*,
138 const struct match
*);
139 void nx_stack_push(struct ofpbuf
*stack
, const void *v
, uint8_t bytes
);
140 void nx_stack_push_bottom(struct ofpbuf
*stack
, const void *v
, uint8_t bytes
);
141 void *nx_stack_pop(struct ofpbuf
*stack
, uint8_t *bytes
);
143 void nxm_execute_stack_push(const struct ofpact_stack
*,
144 const struct flow
*, struct flow_wildcards
*,
146 bool nxm_execute_stack_pop(const struct ofpact_stack
*,
147 struct flow
*, struct flow_wildcards
*,
150 ovs_be64
oxm_bitmap_from_mf_bitmap(const struct mf_bitmap
*, enum ofp_version
);
151 struct mf_bitmap
oxm_bitmap_to_mf_bitmap(ovs_be64 oxm_bitmap
,
153 struct mf_bitmap
oxm_writable_fields(void);
154 struct mf_bitmap
oxm_matchable_fields(void);
155 struct mf_bitmap
oxm_maskable_fields(void);
157 /* Dealing with the 'ofs_nbits' members in several Nicira extensions. */
159 static inline ovs_be16
160 nxm_encode_ofs_nbits(int ofs
, int n_bits
)
162 return htons((ofs
<< 6) | (n_bits
- 1));
166 nxm_decode_ofs(ovs_be16 ofs_nbits
)
168 return ntohs(ofs_nbits
) >> 6;
172 nxm_decode_n_bits(ovs_be16 ofs_nbits
)
174 return (ntohs(ofs_nbits
) & 0x3f) + 1;
177 /* This is my guess at the length of a "typical" nx_match, for use in
178 * predicting space requirements. */
179 #define NXM_TYPICAL_LEN 64
181 #endif /* nx-match.h */