FD.io VPP  v19.01.2-3-gf61a1a8
Vector Packet Processing
nsh.h
Go to the documentation of this file.
1 /*
2  * Copyright (c) 2015 Cisco and/or its affiliates.
3  * Licensed under the Apache License, Version 2.0 (the "License");
4  * you may not use this file except in compliance with the License.
5  * You may obtain a copy of the License at:
6  *
7  * http://www.apache.org/licenses/LICENSE-2.0
8  *
9  * Unless required by applicable law or agreed to in writing, software
10  * distributed under the License is distributed on an "AS IS" BASIS,
11  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12  * See the License for the specific language governing permissions and
13  * limitations under the License.
14  */
15 #ifndef included_nsh_h
16 #define included_nsh_h
17 
18 #include <vnet/vnet.h>
19 #include <nsh/nsh_packet.h>
20 #include <vnet/ip/ip4_packet.h>
21 
22 typedef struct {
23  u16 class;
27 
28 typedef struct {
31 
32 #define MAX_METADATA_LEN 62
33 /** Note:
34  * rewrite and rewrite_size used to support varied nsh header
35  */
36 typedef struct {
37  /* Required for pool_get_aligned */
38  CLIB_CACHE_LINE_ALIGN_MARK (cacheline0);
39 
40  nsh_base_header_t nsh_base;
41  union {
42  nsh_md1_data_t md1_data;
44  } md;
45  u8 tlvs_len; /* configured md2 metadata's length, unit: byte */
46  u8 * tlvs_data; /* configured md2 metadata, network order */
47 
48  /** Rewrite string. network order
49  * contains base header and metadata */
51  u8 rewrite_size; /* unit: byte */
52 } nsh_entry_t;
53 
54 typedef struct {
58 
59 typedef struct {
60  /* Required for pool_get_aligned */
61  CLIB_CACHE_LINE_ALIGN_MARK (cacheline0);
62 
63  /** Key for nsh_header_t entry: 24bit NSP 8bit NSI */
65  /** Key for nsh_header_t entry to map to. : 24bit NSP 8bit NSI
66  * This may be ~0 if next action is to decap to NSH next protocol
67  * Note the following heuristic:
68  * if nsp_nsi == mapped_nsp_nsi then use-case is like SFC SFF
69  * if nsp_nsi != mapped_nsp_nsi then use-case is like SFC SF
70  * Note: these are heuristics. Rules about NSI decrement are out of scope
71  */
73  /* NSH Header action: swap, push and pop */
75 
76  /** vnet intfc hw_if_index */
78  /* vnet intfc sw_if_index */
80 
81  /* encap if index */
86 } nsh_map_t;
87 
88 typedef struct {
92 
93 typedef struct {
94  u32 transport_type; /* 1:vxlan; */
95  u32 transport_index; /* transport's sw_if_index */
97 
98 typedef struct {
99  /* 24bit NSP 8bit NSI */
102 
103 #define MAX_MD2_OPTIONS 256
104 
105 typedef struct {
106  /* API message ID base */
108 
109  /* vector of nsh_header entry instances */
111 
112  /* hash lookup nsh header by key: {u32: nsp_nsi} */
114 
115  /* vector of nsh_mappings */
117 
118  /* hash lookup nsh mapping by key: {u32: nsp_nsi} */
120  uword * nsh_mapping_by_mapped_key; // for use in NSHSFC
121 
122  /* vector of nsh_proxy */
124 
125  /* hash lookup nsh_proxy by key */
127 
128  /** Free vlib hw_if_indices */
130  /** Mapping from sw_if_index to tunnel index */
132 
133  /* vector of nsh_option_map */
135  /* hash lookup nsh_option_map by key */
137 
138  /* Array of function pointers to process MD-Type 2 handling routines */
139  /*
140  * For API or CLI configuration and construct the rewrite buffer, invokes add_options() function.
141  * In the encap node, i.e. when performing PUSH nsh header, invokes options() function.
142  * In the swap node, i.e. when performing SWAP nsh header, invokes swap_options() function.
143  * In the decap node, i.e. when performing POP nsh header, invokes pop_options() function.
144  */
145  u8 options_size[MAX_MD2_OPTIONS]; /* sum of header and metadata */
146  int (*add_options[MAX_MD2_OPTIONS]) (u8 * opt,
147  u8 * opt_size);
148  int (*options[MAX_MD2_OPTIONS]) (vlib_buffer_t * b,
149  nsh_tlv_header_t * opt);
150  int (*swap_options[MAX_MD2_OPTIONS]) (vlib_buffer_t * b,
151  nsh_tlv_header_t * old_opt,
152  nsh_tlv_header_t * new_opt);
153  int (*pop_options[MAX_MD2_OPTIONS]) (vlib_buffer_t * b,
154  nsh_tlv_header_t * opt);
155  u8 *(*trace[MAX_MD2_OPTIONS]) (u8 * s, nsh_tlv_header_t * opt);
157 
158  /* Feature arc indices */
161 
162  /* convenience */
165 } nsh_main_t;
166 
168 
171 
172 typedef struct {
173  u8 trace_data[256];
175 
176 u8 * format_nsh_input_map_trace (u8 * s, va_list * args);
177 u8 * format_nsh_header_with_length (u8 * s, va_list * args);
178 
179 /* Helper macros used in nsh.c and nsh_test.c */
180 #define foreach_copy_nsh_base_hdr_field \
181 _(ver_o_c) \
182 _(length) \
183 _(md_type) \
184 _(next_protocol) \
185 _(nsp_nsi)
186 
187 /* Statistics (not really errors) */
188 #define foreach_nsh_node_error \
189 _(MAPPED, "NSH header found and mapped") \
190 _(NO_MAPPING, "no mapping for nsh key") \
191 _(NO_ENTRY, "no entry for nsh key") \
192 _(NO_PROXY, "no proxy for transport key") \
193 _(INVALID_NEXT_PROTOCOL, "invalid next protocol") \
194 _(INVALID_OPTIONS, "invalid md2 options") \
195 _(INVALID_TTL, "ttl equals zero") \
196 
197 typedef enum {
198 #define _(sym,str) NSH_NODE_ERROR_##sym,
200 #undef _
202 
204 
205 #define foreach_nsh_node_next \
206  _(DROP, "error-drop") \
207  _(ENCAP_GRE4, "gre4-input" ) \
208  _(ENCAP_GRE6, "gre6-input" ) \
209  _(ENCAP_VXLANGPE, "vxlan-gpe-encap" ) \
210  _(ENCAP_VXLAN4, "vxlan4-encap" ) \
211  _(ENCAP_VXLAN6, "vxlan6-encap" ) \
212  _(DECAP_ETH_INPUT, "ethernet-input" ) \
213  _(ENCAP_LISP_GPE, "interface-output" ) \
214  _(ENCAP_ETHERNET, "nsh-eth-output") \
215 /* _(DECAP_IP4_INPUT, "ip4-input") \ */
216 /* _(DECAP_IP6_INPUT, "ip6-input" ) \ */
217 
218 typedef enum {
219 #define _(s,n) NSH_NODE_NEXT_##s,
221 #undef _
224 
225 typedef enum {
230 
231 typedef enum {
237 
238 #define VNET_SW_INTERFACE_FLAG_ADMIN_DOWN 0
239 
240 /* md2 class and type definition */
241 #define NSH_MD2_IOAM_CLASS 0x9
242 #define NSH_MD2_IOAM_OPTION_TYPE_TRACE 0x3B
243 #define NSH_MD2_IOAM_OPTION_TYPE_PROOF_OF_TRANSIT 0x3C
244 
245 #define NSH_MD2_IOAM_TRACE_DUMMY_LEN 0x8
246 
247 #define MAX_NSH_HEADER_LEN 256
248 #define MAX_NSH_OPTION_LEN 128
249 
250 int
252  u8 type,
253  u8 option_size,
254  int add_options (u8 * opt,
255  u8 * opt_size),
256  int options(vlib_buffer_t * b,
257  nsh_tlv_header_t * opt),
258  int swap_options (vlib_buffer_t * b,
259  nsh_tlv_header_t * old_opt,
260  nsh_tlv_header_t * new_opt),
261  int pop_options (vlib_buffer_t * b,
262  nsh_tlv_header_t * opt),
263  u8 * trace (u8 * s,
264  nsh_tlv_header_t * opt));
265 
266 typedef struct _nsh_main_dummy
267 {
268  u8 output_feature_arc_index;
270 
271 #endif /* included_nsh_h */
u32 sw_if_index
Definition: nsh.h:82
u32 nsh_action
Definition: nsh.h:74
static vlib_cli_command_t trace
(constructor) VLIB_CLI_COMMAND (trace)
Definition: vlib_api_cli.c:862
#define CLIB_CACHE_LINE_ALIGN_MARK(mark)
Definition: cache.h:60
u32 * tunnel_index_by_sw_if_index
Mapping from sw_if_index to tunnel index.
Definition: nsh.h:131
nsh_entity_type
Definition: nsh.h:231
u32 next_node
Definition: nsh.h:84
#define foreach_nsh_node_next
Definition: nsh.h:205
u32 nsh_sw_if
Definition: nsh.h:79
vlib_node_registration_t nsh_eth_output_node
(constructor) VLIB_REGISTER_NODE (nsh_eth_output_node)
Definition: nsh_output.c:334
struct _nsh_main_dummy nsh_main_dummy_t
vlib_node_registration_t nsh_aware_vnf_proxy_node
(constructor) VLIB_REGISTER_NODE (nsh_aware_vnf_proxy_node)
Definition: nsh.c:2425
u8 output_feature_arc_index
Definition: nsh.h:160
unsigned char u8
Definition: types.h:56
nsh_base_header_t nsh_base
Definition: nsh.h:40
nsh_proxy_session_t * nsh_proxy_sessions
Definition: nsh.h:123
nsh_action_type
Definition: nsh.h:225
u8 input_feature_arc_index
Definition: nsh.h:159
u8 is_add
Definition: nsh.h:55
nsh_node_next_t
Definition: nsh.h:218
nsh_entry_t * nsh_entries
Definition: nsh.h:110
u32 adj_index
Definition: nsh.h:85
unsigned int u32
Definition: types.h:88
u32 * free_nsh_tunnel_hw_if_indices
Free vlib hw_if_indices.
Definition: nsh.h:129
u16 msg_id_base
Definition: nsh.h:107
nsh_md2_data_t md2_data
Definition: nsh.h:43
Definition: nsh.h:59
nsh_map_t * nsh_mappings
Definition: nsh.h:116
#define MAX_MD2_OPTIONS
Definition: nsh.h:103
uword * nsh_entry_by_key
Definition: nsh.h:113
u8 * format_nsh_input_map_trace(u8 *s, va_list *args)
u8 * rewrite
Rewrite string.
Definition: nsh.h:50
unsigned short u16
Definition: types.h:57
nsh_option_map_t * nsh_option_mappings
Definition: nsh.h:134
uword decap_v4_next_override
Definition: nsh.h:156
Definition: nsh.h:54
u8 * format_nsh_header_with_length(u8 *s, va_list *args)
uword * nsh_proxy_session_by_key
Definition: nsh.h:126
u32 nsp_nsi
Key for nsh_header_t entry: 24bit NSP 8bit NSI.
Definition: nsh.h:64
u32 nsh_hw_if
vnet intfc hw_if_index
Definition: nsh.h:77
u8 tlvs_len
Definition: nsh.h:45
#define foreach_nsh_node_error
Definition: nsh.h:188
nsh_tlv_header_t nsh_md2_data_t
Definition: nsh_packet.h:93
u32 mapped_nsp_nsi
Key for nsh_header_t entry to map to.
Definition: nsh.h:72
u32 rx_sw_if_index
Definition: nsh.h:83
u32 option_id
Definition: nsh.h:29
nsh_map_t map
Definition: nsh.h:90
nsh_md1_data_t md1_data
Definition: nsh.h:42
vlib_main_t * vlib_main
Definition: nsh.h:163
u8 rewrite_size
Definition: nsh.h:51
struct _vlib_node_registration vlib_node_registration_t
u8 * tlvs_data
Definition: nsh.h:46
nsh_input_error_t
Definition: nsh.h:197
u64 uword
Definition: types.h:112
int nsh_md2_register_option(u16 class, u8 type, u8 option_size, int add_options(u8 *opt, u8 *opt_size), int options(vlib_buffer_t *b, nsh_tlv_header_t *opt), int swap_options(vlib_buffer_t *b, nsh_tlv_header_t *old_opt, nsh_tlv_header_t *new_opt), int pop_options(vlib_buffer_t *b, nsh_tlv_header_t *opt), u8 *trace(u8 *s, nsh_tlv_header_t *opt))
Definition: nsh.c:125
uword * nsh_option_map_by_key
Definition: nsh.h:136
vnet_main_t * vnet_main
Definition: nsh.h:164
uword * nsh_mapping_by_mapped_key
Definition: nsh.h:120
Note: rewrite and rewrite_size used to support varied nsh header.
Definition: nsh.h:36
nsh_main_t nsh_main
Definition: nsh.h:167
uword * nsh_mapping_by_key
Definition: nsh.h:119
nsh_entry_t nsh_entry
Definition: nsh.h:56