FD.io VPP  v20.09-64-g4f7b92f0a
Vector Packet Processing
transport_types.h
Go to the documentation of this file.
1 /*
2  * Copyright (c) 2016-2019 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 VNET_VNET_URI_TRANSPORT_TYPES_H_
17 #define VNET_VNET_URI_TRANSPORT_TYPES_H_
18 
19 #include <vnet/vnet.h>
20 #include <vnet/ip/ip.h>
21 #include <vnet/tcp/tcp_debug.h>
22 
23 #define TRANSPORT_MAX_HDRS_LEN 140 /* Max number of bytes for headers */
24 
25 
27 {
28  TRANSPORT_TX_PEEK, /**< reliable transport protos */
29  TRANSPORT_TX_DEQUEUE, /**< unreliable transport protos */
30  TRANSPORT_TX_INTERNAL, /**< apps acting as transports */
31  TRANSPORT_TX_DGRAM, /**< datagram mode */
34 
36 {
37  TRANSPORT_SERVICE_VC, /**< virtual circuit service */
38  TRANSPORT_SERVICE_CL, /**< connectionless service */
39  TRANSPORT_SERVICE_APP, /**< app transport service */
42 
44 {
46  /**
47  * Don't register connection in lookup. Does not apply to local apps
48  * and transports using the network layer (udp/tcp)
49  */
51  /**
52  * Connection descheduled by the session layer.
53  */
55  /**
56  * Connection is "connection less". Some important implications of that
57  * are that connections are not pinned to workers and listeners will
58  * have fifos associated to them
59  */
62 
63 typedef struct _spacer
64 {
65  u64 bytes_per_sec;
66  u64 bucket;
67  clib_us_time_t last_update;
68  f32 tokens_per_period;
69  u32 idle_timeout_us;
70 } spacer_t;
71 
72 #define TRANSPORT_CONN_ID_LEN 44
73 
74 /*
75  * Protocol independent transport properties associated to a session
76  */
77 typedef struct _transport_connection
78 {
79  /** Connection ID */
80  union
81  {
82  /*
83  * Network connection ID tuple
84  */
85  struct
86  {
87  ip46_address_t rmt_ip; /**< Remote IP */
88  ip46_address_t lcl_ip; /**< Local IP */
89  u32 fib_index; /**< Network namespace */
90  u16 rmt_port; /**< Remote port */
91  u16 lcl_port; /**< Local port */
92  u8 is_ip4; /**< Flag if IP4 connection */
93  u8 proto; /**< Protocol id */
94  u8 unused[2]; /**< First field after id wants to be
95  4-byte aligned) */
96  };
97  /*
98  * Opaque connection ID
99  */
100  u8 opaque_conn_id[TRANSPORT_CONN_ID_LEN];
101  };
102 
103  u32 s_index; /**< Parent session index */
104  u32 c_index; /**< Connection index in transport pool */
105  u32 thread_index; /**< Worker-thread index */
106  u8 flags; /**< Transport specific flags */
107 
108  /*fib_node_index_t rmt_fei;
109  dpo_id_t rmt_dpo; */
110 
111  spacer_t pacer; /**< Simple transport pacer */
112 
113 #if TRANSPORT_DEBUG
114  elog_track_t elog_track; /**< Event logging */
115  u32 cc_stat_tstamp; /**< CC stats timestamp */
116 #endif
117 
118  /**
119  * Transport specific state starts in next cache line. Meant to avoid
120  * alignment surprises in transports when base class changes.
121  */
123 
124  /** Macros for 'derived classes' where base is named "connection" */
125 #define c_lcl_ip connection.lcl_ip
126 #define c_rmt_ip connection.rmt_ip
127 #define c_lcl_ip4 connection.lcl_ip.ip4
128 #define c_rmt_ip4 connection.rmt_ip.ip4
129 #define c_lcl_ip6 connection.lcl_ip.ip6
130 #define c_rmt_ip6 connection.rmt_ip.ip6
131 #define c_lcl_port connection.lcl_port
132 #define c_rmt_port connection.rmt_port
133 #define c_proto connection.proto
134 #define c_fib_index connection.fib_index
135 #define c_s_index connection.s_index
136 #define c_c_index connection.c_index
137 #define c_is_ip4 connection.is_ip4
138 #define c_thread_index connection.thread_index
139 #define c_elog_track connection.elog_track
140 #define c_cc_stat_tstamp connection.cc_stat_tstamp
141 #define c_rmt_fei connection.rmt_fei
142 #define c_rmt_dpo connection.rmt_dpo
143 #define c_opaque_id connection.opaque_conn_id
144 #define c_stats connection.stats
145 #define c_pacer connection.pacer
146 #define c_flags connection.flags
147 #define s_ho_handle pacer.bucket
148 #define c_s_ho_handle connection.pacer.bucket
150 
152  == TRANSPORT_CONN_ID_LEN, "update conn id len");
153 
154 /* Warn if size changes. Two cache lines is already generous, hopefully we
155  * won't have to outgrow that. */
156 STATIC_ASSERT (sizeof (transport_connection_t) <= 128,
157  "moved into 3rd cache line");
158 
159 #define foreach_transport_proto \
160  _(TCP, "tcp", "T") \
161  _(UDP, "udp", "U") \
162  _(NONE, "ct", "C") \
163  _(TLS, "tls", "J") \
164  _(QUIC, "quic", "Q") \
165 
166 typedef enum _transport_proto
167 {
168 #define _(sym, str, sstr) TRANSPORT_PROTO_ ## sym,
170 #undef _
172 
173 u8 *format_transport_proto (u8 * s, va_list * args);
174 u8 *format_transport_proto_short (u8 * s, va_list * args);
175 u8 *format_transport_connection (u8 * s, va_list * args);
176 u8 *format_transport_listen_connection (u8 * s, va_list * args);
177 u8 *format_transport_half_open_connection (u8 * s, va_list * args);
178 
179 uword unformat_transport_proto (unformat_input_t * input, va_list * args);
180 u8 *format_transport_protos (u8 * s, va_list * args);
181 
182 #define foreach_transport_endpoint_fields \
183  _(ip46_address_t, ip) /**< ip address in net order */ \
184  _(u16, port) /**< port in net order */ \
185  _(u8, is_ip4) /**< set if ip4 */ \
186  _(u32, sw_if_index) /**< interface endpoint is associated with */ \
187  _(u32, fib_index) /**< fib table endpoint is associated with */ \
188 
189 typedef struct transport_endpoint_
190 {
191 #define _(type, name) type name;
193 #undef _
195 
196 typedef enum transport_endpt_cfg_flags_
197 {
198  TRANSPORT_CFG_F_CONNECTED = 1 << 0,
201 
202 #define foreach_transport_endpoint_cfg_fields \
203  foreach_transport_endpoint_fields \
204  _(transport_endpoint_t, peer) \
205  _(u16, mss) \
206  _(u8, transport_flags) \
207 
208 typedef struct transport_endpoint_pair_
209 {
210 #define _(type, name) type name;
212 #undef _
214 
215 typedef clib_bihash_24_8_t transport_endpoint_table_t;
217 #define ENDPOINT_INVALID_INDEX ((u32)~0)
221 {
222  return tc->is_ip4 ? FIB_PROTOCOL_IP4 : FIB_PROTOCOL_IP6;
223 }
224 
226 transport_endpoint_fib_proto (transport_endpoint_t * tep)
227 {
228  return tep->is_ip4 ? FIB_PROTOCOL_IP4 : FIB_PROTOCOL_IP6;
229 }
230 
231 u8 transport_protocol_is_cl (transport_proto_t tp);
232 transport_service_type_t transport_protocol_service_type (transport_proto_t);
233 transport_tx_fn_type_t transport_protocol_tx_fn_type (transport_proto_t tp);
234 
235 #endif /* VNET_VNET_URI_TRANSPORT_TYPES_H_ */
236 
237 /*
238  * fd.io coding-style-patch-verification: ON
239  *
240  * Local Variables:
241  * eval: (c-set-style "gnu")
242  * End:
243  */
#define CLIB_CACHE_LINE_ALIGN_MARK(mark)
Definition: cache.h:60
uword unformat_transport_proto(unformat_input_t *input, va_list *args)
Definition: transport.c:155
vl_api_wireguard_peer_flags_t flags
Definition: wireguard.api:103
transport_dequeue_type_
static u8 transport_connection_fib_proto(transport_connection_t *tc)
transport_connection_flags_
unsigned long u64
Definition: types.h:89
struct transport_endpoint_ transport_endpoint_t
#define STRUCT_OFFSET_OF(t, f)
Definition: clib.h:70
struct _spacer spacer_t
unsigned char u8
Definition: types.h:56
#define foreach_transport_proto
Connection is "connection less".
enum transport_connection_flags_ transport_connection_flags_t
unsigned int u32
Definition: types.h:88
transport_service_type_t transport_protocol_service_type(transport_proto_t)
Definition: transport.c:290
u8 * format_transport_proto(u8 *s, va_list *args)
Definition: transport.c:52
vl_api_ip_proto_t proto
Definition: acl_types.api:50
struct _unformat_input_t unformat_input_t
unsigned short u16
Definition: types.h:57
#define foreach_transport_endpoint_cfg_fields
enum transport_service_type_ transport_service_type_t
#define always_inline
Definition: ipsec.h:28
u8 * format_transport_connection(u8 *s, va_list *args)
Definition: transport.c:80
app transport service
struct transport_endpoint_pair_ transport_endpoint_cfg_t
virtual circuit service
Don&#39;t register connection in lookup.
u8 * format_transport_protos(u8 *s, va_list *args)
Definition: transport.c:190
struct _transport_connection transport_connection_t
STATIC_ASSERT(sizeof(transport_connection_t)<=128, "moved into 3rd cache line")
#define foreach_transport_endpoint_fields
fib table endpoint is associated with
#define TRANSPORT_CONN_ID_LEN
transport_tx_fn_type_t transport_protocol_tx_fn_type(transport_proto_t tp)
Definition: transport.c:296
u8 * format_transport_listen_connection(u8 *s, va_list *args)
Definition: transport.c:110
apps acting as transports
datagram mode
enum _transport_proto transport_proto_t
reliable transport protos
float f32
Definition: types.h:143
transport_endpt_cfg_flags_
u64 uword
Definition: types.h:112
connectionless service
static u8 transport_endpoint_fib_proto(transport_endpoint_t *tep)
unreliable transport protos
static void elog_track(elog_main_t *em, elog_event_type_t *type, elog_track_t *track, u32 data)
Log a single-datum event to a specific track, non-inline version.
Definition: elog.h:398
u8 transport_protocol_is_cl(transport_proto_t tp)
Definition: transport.c:349
Connection descheduled by the session layer.
f64 end
end of the time range
Definition: mactime.api:44
u8 * format_transport_proto_short(u8 *s, va_list *args)
Definition: transport.c:65
clib_bihash_24_8_t transport_endpoint_table_t
enum transport_endpt_cfg_flags_ transport_endpt_cfg_flags_t
u8 * format_transport_half_open_connection(u8 *s, va_list *args)
Definition: transport.c:124
u64 clib_us_time_t
Definition: time.h:204
transport_service_type_
enum transport_dequeue_type_ transport_tx_fn_type_t