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:
7 * http://www.apache.org/licenses/LICENSE-2.0
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.
16 #ifndef VNET_VNET_URI_TRANSPORT_TYPES_H_
17 #define VNET_VNET_URI_TRANSPORT_TYPES_H_
19 #include <vnet/vnet.h>
20 #include <vnet/ip/ip.h>
21 #include <vnet/tcp/tcp_debug.h>
23 #define TRANSPORT_MAX_HDRS_LEN 100 /* Max number of bytes for headers */
25 typedef enum transport_dequeue_type_
27 TRANSPORT_TX_PEEK, /**< reliable transport protos */
28 TRANSPORT_TX_DEQUEUE, /**< unreliable transport protos */
29 TRANSPORT_TX_INTERNAL, /**< apps acting as transports */
30 TRANSPORT_TX_DGRAM, /**< datagram mode */
32 } transport_tx_fn_type_t;
34 typedef enum transport_service_type_
36 TRANSPORT_SERVICE_VC, /**< virtual circuit service */
37 TRANSPORT_SERVICE_CL, /**< connectionless service */
38 TRANSPORT_SERVICE_APP, /**< app transport service */
40 } transport_service_type_t;
42 typedef enum transport_connection_flags_
44 TRANSPORT_CONNECTION_F_IS_TX_PACED = 1 << 0,
45 TRANSPORT_CONNECTION_F_NO_LOOKUP = 1 << 1, /**< Don't register connection in lookup
46 Does not apply to local apps and
47 transports using the network layer (udp/tcp) */
48 } transport_connection_flags_t;
50 typedef struct _spacer
54 f32 tokens_per_period;
57 #define TRANSPORT_CONN_ID_LEN 44
60 * Protocol independent transport properties associated to a session
62 typedef struct _transport_connection
68 * Network connection ID tuple
72 ip46_address_t rmt_ip; /**< Remote IP */
73 ip46_address_t lcl_ip; /**< Local IP */
74 u32 fib_index; /**< Network namespace */
75 u16 rmt_port; /**< Remote port */
76 u16 lcl_port; /**< Local port */
77 u8 is_ip4; /**< Flag if IP4 connection */
78 u8 proto; /**< Protocol id */
79 u8 unused[2]; /**< First field after id wants to be
83 * Opaque connection ID
85 u8 opaque_conn_id[TRANSPORT_CONN_ID_LEN];
88 u32 s_index; /**< Parent session index */
89 u32 c_index; /**< Connection index in transport pool */
90 u32 thread_index; /**< Worker-thread index */
91 u8 flags; /**< Transport specific flags */
93 /*fib_node_index_t rmt_fei;
96 spacer_t pacer; /**< Simple transport pacer */
99 elog_track_t elog_track; /**< Event logging */
100 u32 cc_stat_tstamp; /**< CC stats timestamp */
104 * Transport specific state starts in next cache line. Meant to avoid
105 * alignment surprises in transports when base class changes.
107 CLIB_CACHE_LINE_ALIGN_MARK (end);
109 /** Macros for 'derived classes' where base is named "connection" */
110 #define c_lcl_ip connection.lcl_ip
111 #define c_rmt_ip connection.rmt_ip
112 #define c_lcl_ip4 connection.lcl_ip.ip4
113 #define c_rmt_ip4 connection.rmt_ip.ip4
114 #define c_lcl_ip6 connection.lcl_ip.ip6
115 #define c_rmt_ip6 connection.rmt_ip.ip6
116 #define c_lcl_port connection.lcl_port
117 #define c_rmt_port connection.rmt_port
118 #define c_proto connection.proto
119 #define c_fib_index connection.fib_index
120 #define c_s_index connection.s_index
121 #define c_c_index connection.c_index
122 #define c_is_ip4 connection.is_ip4
123 #define c_thread_index connection.thread_index
124 #define c_elog_track connection.elog_track
125 #define c_cc_stat_tstamp connection.cc_stat_tstamp
126 #define c_rmt_fei connection.rmt_fei
127 #define c_rmt_dpo connection.rmt_dpo
128 #define c_opaque_id connection.opaque_conn_id
129 #define c_stats connection.stats
130 #define c_pacer connection.pacer
131 #define c_flags connection.flags
132 } transport_connection_t;
134 STATIC_ASSERT (STRUCT_OFFSET_OF (transport_connection_t, s_index)
135 == TRANSPORT_CONN_ID_LEN, "update conn id len");
137 /* Warn if size changes. Two cache lines is already generous, hopefully we
138 * won't have to outgrow that. */
139 STATIC_ASSERT (sizeof (transport_connection_t) <= 128,
140 "moved into 3rd cache line");
142 typedef enum _transport_proto
146 TRANSPORT_PROTO_SCTP,
147 TRANSPORT_PROTO_NONE,
149 TRANSPORT_PROTO_UDPC,
150 TRANSPORT_PROTO_QUIC,
154 u8 *format_transport_proto (u8 * s, va_list * args);
155 u8 *format_transport_proto_short (u8 * s, va_list * args);
156 u8 *format_transport_connection (u8 * s, va_list * args);
157 u8 *format_transport_listen_connection (u8 * s, va_list * args);
158 u8 *format_transport_half_open_connection (u8 * s, va_list * args);
160 uword unformat_transport_proto (unformat_input_t * input, va_list * args);
162 #define foreach_transport_endpoint_fields \
163 _(ip46_address_t, ip) /**< ip address in net order */ \
164 _(u16, port) /**< port in net order */ \
165 _(u8, is_ip4) /**< set if ip4 */ \
166 _(u32, sw_if_index) /**< interface endpoint is associated with */ \
167 _(u32, fib_index) /**< fib table endpoint is associated with */ \
169 typedef struct transport_endpoint_
171 #define _(type, name) type name;
172 foreach_transport_endpoint_fields
174 } transport_endpoint_t;
176 #define foreach_transport_endpoint_cfg_fields \
177 foreach_transport_endpoint_fields \
178 _(transport_endpoint_t, peer) \
180 typedef struct transport_endpoint_pair_
182 #define _(type, name) type name;
183 foreach_transport_endpoint_cfg_fields
185 } transport_endpoint_cfg_t;
187 typedef clib_bihash_24_8_t transport_endpoint_table_t;
189 #define ENDPOINT_INVALID_INDEX ((u32)~0)
192 transport_connection_fib_proto (transport_connection_t * tc)
194 return tc->is_ip4 ? FIB_PROTOCOL_IP4 : FIB_PROTOCOL_IP6;
198 transport_endpoint_fib_proto (transport_endpoint_t * tep)
200 return tep->is_ip4 ? FIB_PROTOCOL_IP4 : FIB_PROTOCOL_IP6;
203 u8 transport_protocol_is_cl (transport_proto_t tp);
204 u8 transport_half_open_has_fifos (transport_proto_t tp);
205 transport_service_type_t transport_protocol_service_type (transport_proto_t);
206 transport_tx_fn_type_t transport_protocol_tx_fn_type (transport_proto_t tp);
208 #endif /* VNET_VNET_URI_TRANSPORT_TYPES_H_ */
211 * fd.io coding-style-patch-verification: ON
214 * eval: (c-set-style "gnu")