FD.io VPP  v21.06-3-gbb25fbf28
Vector Packet Processing
mpls_label_dpo.h
Go to the documentation of this file.
1 /*
2  * Copyright (c) 2016 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 
16 #ifndef __MPLS_LABEL_DPO_H__
17 #define __MPLS_LABEL_DPO_H__
18 
19 #include <vnet/vnet.h>
20 #include <vnet/mpls/packet.h>
21 #include <vnet/dpo/dpo.h>
22 
23 /**
24  * Flags present on an MPLS label sourced path-extension
25  */
27 {
28  /**
29  * Do not decrement the TTL of IP packet during imposition
30  */
34 
35 #define MPLS_LABEL_DPO_ATTR_MAX (MPLS_LABEL_DPO_ATTR_UNIFORM_MODE+1)
36 
38 {
42 } __attribute__ ((packed)) mpls_label_dpo_flags_t;
43 
44 #define MPLS_LABEL_DPO_ATTR_NAMES { \
45  [MPLS_LABEL_DPO_ATTR_NO_IP_TTL_DECR] = "no-ip-tll-decr", \
46  [MPLS_LABEL_DPO_ATTR_UNIFORM_MODE] = "uniform-mode", \
47 }
48 
49 #define FOR_EACH_MPLS_LABEL_DPO_ATTR(_item) \
50  for (_item = MPLS_LABEL_DPO_ATTR_NO_IP_TTL_DECR; \
51  _item <= MPLS_LABEL_DPO_ATTR_UNIFORM_MODE; \
52  _item++)
53 
54 /**
55  * Format the flags variable
56  */
57 extern u8* format_mpls_label_dpo_flags(u8 *s, va_list *args);
58 
59 /**
60  * Maximum number of labels in one DPO
61  */
62 #define MPLS_LABEL_DPO_MAX_N_LABELS 12
63 
64 /**
65  * A representation of an MPLS label for imposition in the data-path
66  */
67 typedef struct mpls_label_dpo_t
68 {
69  /**
70  * required for pool_get_aligned.
71  * memebers used in the switch path come first!
72  */
73  CLIB_CACHE_LINE_ALIGN_MARK(cacheline0);
74 
75  /**
76  * The MPLS label header to impose. Outer most label first.
77  * Each DPO will occupy one cache line, stuff that many labels in.
78  */
80 
81  /**
82  * Next DPO in the graph
83  */
85 
86  /**
87  * The protocol of the payload/packets that are being encapped
88  */
90 
91  /**
92  * Flags
93  */
95 
96  /**
97  * Size of the label stack
98  */
100 
101  /**
102  * Cached amount of header bytes to paint
103  */
105 
106  /**
107  * Number of locks/users of the label
108  */
111 
112 /**
113  * @brief Assert that the MPLS label object is less than a cache line in size.
114  * Should this get any bigger then we will need to reconsider how many labels
115  * can be pushed in one object.
116  */
118  "MPLS label DPO is larger than one cache line.");
119 
120 /**
121  * @brief Create an MPLS label object
122  *
123  * @param label_stack The stack if labels to impose, outer most label first
124  * @param eos The inner most label's EOS bit
125  * @param payload_proto The ptocool of the payload packets that will
126  * be imposed with this label header.
127  * @param parent The parent of the created MPLS label object
128  * @param dpo The MPLS label DPO created
129  */
131  mpls_eos_bit_t eos,
132  dpo_proto_t payload_proto,
134  const dpo_id_t *paremt,
135  dpo_id_t *dpo);
136 
137 extern u8* format_mpls_label_dpo(u8 *s, va_list *args);
138 
139 
140 /*
141  * Encapsulation violation for fast data-path access
142  */
144 
145 static inline mpls_label_dpo_t *
147 {
149 }
150 
151 extern void mpls_label_dpo_module_init(void);
152 
153 /*
154  * test function to get the registered DPO type for the flags
155  */
157 
158 #endif
mpls_label_dpo_create
void mpls_label_dpo_create(fib_mpls_label_t *label_stack, mpls_eos_bit_t eos, dpo_proto_t payload_proto, mpls_label_dpo_flags_t flags, const dpo_id_t *paremt, dpo_id_t *dpo)
Create an MPLS label object.
Definition: mpls_label_dpo.c:65
mpls_label_dpo_flags_t_
mpls_label_dpo_flags_t_
Definition: mpls_label_dpo.h:37
mpls_label_dpo_t::mld_hdr
mpls_unicast_header_t mld_hdr[MPLS_LABEL_DPO_MAX_N_LABELS]
The MPLS label header to impose.
Definition: mpls_label_dpo.h:79
dpo_proto_t
enum dpo_proto_t_ dpo_proto_t
Data path protocol.
pool_elt_at_index
#define pool_elt_at_index(p, i)
Returns pointer to element at given index.
Definition: pool.h:553
u16
unsigned short u16
Definition: types.h:57
mpls_label_dpo_t::mld_n_labels
u8 mld_n_labels
Size of the label stack.
Definition: mpls_label_dpo.h:99
mpls_unicast_header_t
Definition: packet.h:28
packet.h
label_stack
vl_api_fib_mpls_label_t label_stack[16]
Definition: fib_types.api:128
mpls_label_dpo_pool
mpls_label_dpo_t * mpls_label_dpo_pool
Definition: mpls_label_dpo.c:27
MPLS_LABEL_DPO_FLAG_NONE
@ MPLS_LABEL_DPO_FLAG_NONE
Definition: mpls_label_dpo.h:39
mpls_label_dpo_attr_t
enum mpls_label_dpo_attr_t_ mpls_label_dpo_attr_t
Flags present on an MPLS label sourced path-extension.
mpls_label_dpo_t::mld_n_hdr_bytes
u16 mld_n_hdr_bytes
Cached amount of header bytes to paint.
Definition: mpls_label_dpo.h:104
mpls_label_dpo_module_init
void mpls_label_dpo_module_init(void)
Definition: mpls_label_dpo.c:1332
mpls_label_dpo_t
struct mpls_label_dpo_t mpls_label_dpo_t
A representation of an MPLS label for imposition in the data-path.
dpo.h
index_t
u32 index_t
A Data-Path Object is an object that represents actions that are applied to packets are they are swit...
Definition: dpo.h:43
format_mpls_label_dpo_flags
u8 * format_mpls_label_dpo_flags(u8 *s, va_list *args)
Format the flags variable.
Definition: mpls_label_dpo.c:182
dpo_type_t
enum dpo_type_t_ dpo_type_t
Common types of data-path objects New types can be dynamically added using dpo_register_new_type()
mpls_label_dpo_flags_t
enum mpls_label_dpo_flags_t_ mpls_label_dpo_flags_t
CLIB_CACHE_LINE_BYTES
#define CLIB_CACHE_LINE_BYTES
Definition: cache.h:59
MPLS_LABEL_DPO_ATTR_UNIFORM_MODE
@ MPLS_LABEL_DPO_ATTR_UNIFORM_MODE
Definition: mpls_label_dpo.h:32
mpls_label_dpo_t::mld_flags
mpls_label_dpo_flags_t mld_flags
Flags.
Definition: mpls_label_dpo.h:94
index
u32 index
Definition: flow_types.api:221
mpls_label_dpo_attr_t_
mpls_label_dpo_attr_t_
Flags present on an MPLS label sourced path-extension.
Definition: mpls_label_dpo.h:26
MPLS_LABEL_DPO_FLAG_NO_IP_TTL_DECR
@ MPLS_LABEL_DPO_FLAG_NO_IP_TTL_DECR
Definition: mpls_label_dpo.h:40
mpls_label_dpo_get
static mpls_label_dpo_t * mpls_label_dpo_get(index_t index)
Definition: mpls_label_dpo.h:146
MPLS_LABEL_DPO_FLAG_UNIFORM_MODE
@ MPLS_LABEL_DPO_FLAG_UNIFORM_MODE
Definition: mpls_label_dpo.h:41
format_mpls_label_dpo
u8 * format_mpls_label_dpo(u8 *s, va_list *args)
Definition: mpls_label_dpo.c:199
mpls_label_dpo_t::mld_payload_proto
dpo_proto_t mld_payload_proto
The protocol of the payload/packets that are being encapped.
Definition: mpls_label_dpo.h:89
fib_mpls_label_t_
Configuration for each label value in the output-stack.
Definition: fib_types.h:455
u8
unsigned char u8
Definition: types.h:56
mpls_label_dpo_t
A representation of an MPLS label for imposition in the data-path.
Definition: mpls_label_dpo.h:67
dpo_id_t_
The identity of a DPO is a combination of its type and its instance number/index of objects of that t...
Definition: dpo.h:172
MPLS_LABEL_DPO_MAX_N_LABELS
#define MPLS_LABEL_DPO_MAX_N_LABELS
Maximum number of labels in one DPO.
Definition: mpls_label_dpo.h:62
vnet.h
mpls_label_dpo_t::mld_locks
u16 mld_locks
Number of locks/users of the label.
Definition: mpls_label_dpo.h:109
mpls_label_dpo_t::CLIB_CACHE_LINE_ALIGN_MARK
CLIB_CACHE_LINE_ALIGN_MARK(cacheline0)
required for pool_get_aligned.
mpls_eos_bit_t
enum mpls_eos_bit_t_ mpls_eos_bit_t
mpls_label_dpo_get_type
dpo_type_t mpls_label_dpo_get_type(mpls_label_dpo_flags_t flags)
Definition: mpls_label_dpo.c:1350
STATIC_ASSERT
STATIC_ASSERT((sizeof(mpls_label_dpo_t)<=CLIB_CACHE_LINE_BYTES), "MPLS label DPO is larger than one cache line.")
Assert that the MPLS label object is less than a cache line in size.
mpls_label_dpo_t::mld_dpo
dpo_id_t mld_dpo
Next DPO in the graph.
Definition: mpls_label_dpo.h:84
MPLS_LABEL_DPO_ATTR_NO_IP_TTL_DECR
@ MPLS_LABEL_DPO_ATTR_NO_IP_TTL_DECR
Do not decrement the TTL of IP packet during imposition.
Definition: mpls_label_dpo.h:31
flags
vl_api_wireguard_peer_flags_t flags
Definition: wireguard.api:105