]>
git.proxmox.com Git - mirror_ovs.git/blob - lib/nx-match.h
2 * Copyright (c) 2010, 2011, 2012, 2013, 2014 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 "meta-flow.h"
26 #include "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
;
39 /* Nicira Extended Match (NXM) flexible flow match helper functions.
41 * See include/openflow/nicira-ext.h for NXM specification.
44 void mf_format_subfield(const struct mf_subfield
*, struct ds
*);
45 char *mf_parse_subfield__(struct mf_subfield
*sf
, const char **s
)
47 char *mf_parse_subfield(struct mf_subfield
*, const char *s
)
50 enum ofperr
nx_pull_match(struct ofpbuf
*, unsigned int match_len
,
52 ovs_be64
*cookie
, ovs_be64
*cookie_mask
);
53 enum ofperr
nx_pull_match_loose(struct ofpbuf
*, unsigned int match_len
,
54 struct match
*, ovs_be64
*cookie
,
55 ovs_be64
*cookie_mask
);
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
*,
59 ovs_be64 cookie
, ovs_be64 cookie_mask
);
60 int oxm_put_match(struct ofpbuf
*, const struct match
*, enum ofp_version
);
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
**,
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
,
73 /* NXM and OXM protocol headers values.
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). */
79 uint32_t mf_nxm_header(enum mf_field_id
);
80 const struct mf_field
*mf_from_nxm_header(uint32_t nxm_header
);
82 char *nx_match_to_string(const uint8_t *, unsigned int match_len
);
83 char *oxm_match_to_string(const struct ofpbuf
*, unsigned int match_len
);
84 int nx_match_from_string(const char *, struct ofpbuf
*);
85 int oxm_match_from_string(const char *, struct ofpbuf
*);
87 void nx_format_field_name(enum mf_field_id
, enum ofp_version
, struct ds
*);
89 char *nxm_parse_reg_move(struct ofpact_reg_move
*, const char *)
92 void nxm_format_reg_move(const struct ofpact_reg_move
*, struct ds
*);
94 enum ofperr
nxm_reg_move_check(const struct ofpact_reg_move
*,
97 void nxm_execute_reg_move(const struct ofpact_reg_move
*, struct flow
*,
98 struct flow_wildcards
*);
99 void nxm_reg_load(const struct mf_subfield
*, uint64_t src_data
,
100 struct flow
*, struct flow_wildcards
*);
102 char *nxm_parse_stack_action(struct ofpact_stack
*, const char *)
105 void nxm_format_stack_push(const struct ofpact_stack
*, struct ds
*);
106 void nxm_format_stack_pop(const struct ofpact_stack
*, struct ds
*);
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
*);
113 void nxm_execute_stack_push(const struct ofpact_stack
*,
114 const struct flow
*, struct flow_wildcards
*,
116 void nxm_execute_stack_pop(const struct ofpact_stack
*,
117 struct flow
*, struct flow_wildcards
*,
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
,
123 struct mf_bitmap
oxm_writable_fields(void);
124 struct mf_bitmap
oxm_matchable_fields(void);
125 struct mf_bitmap
oxm_maskable_fields(void);
127 /* Dealing with the 'ofs_nbits' members in several Nicira extensions. */
129 static inline ovs_be16
130 nxm_encode_ofs_nbits(int ofs
, int n_bits
)
132 return htons((ofs
<< 6) | (n_bits
- 1));
136 nxm_decode_ofs(ovs_be16 ofs_nbits
)
138 return ntohs(ofs_nbits
) >> 6;
142 nxm_decode_n_bits(ovs_be16 ofs_nbits
)
144 return (ntohs(ofs_nbits
) & 0x3f) + 1;
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
151 #endif /* nx-match.h */