2 * Copyright (c) 2017 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 SRC_VNET_SESSION_TRANSPORT_INTERFACE_H_
17 #define SRC_VNET_SESSION_TRANSPORT_INTERFACE_H_
19 #include <vnet/vnet.h>
20 #include <vnet/session/transport.h>
22 typedef enum transport_dequeue_type_
24 TRANSPORT_TX_PEEK, /**< reliable transport protos */
25 TRANSPORT_TX_DEQUEUE, /**< unreliable transport protos */
26 TRANSPORT_TX_INTERNAL, /**< apps acting as transports */
27 TRANSPORT_TX_DGRAM, /**< datagram mode */
29 } transport_tx_fn_type_t;
31 typedef enum transport_service_type_
33 TRANSPORT_SERVICE_VC, /**< virtual circuit service */
34 TRANSPORT_SERVICE_CL, /**< connectionless service */
35 TRANSPORT_SERVICE_APP, /**< app transport service */
37 } transport_service_type_t;
40 * Transport protocol virtual function table
43 typedef struct _transport_proto_vft
48 u32 (*bind) (u32 session_index, transport_endpoint_t * lcl);
50 int (*open) (transport_endpoint_cfg_t * rmt);
51 void (*close) (u32 conn_index, u32 thread_index);
52 void (*cleanup) (u32 conn_index, u32 thread_index);
53 clib_error_t *(*enable) (vlib_main_t * vm, u8 is_en);
59 u32 (*push_header) (transport_connection_t * tconn, vlib_buffer_t * b);
60 u16 (*send_mss) (transport_connection_t * tc);
61 u32 (*send_space) (transport_connection_t * tc);
62 u32 (*tx_fifo_offset) (transport_connection_t * tc);
63 void (*update_time) (f64 time_now, u8 thread_index);
66 * Connection retrieval
68 transport_connection_t *(*get_connection) (u32 conn_idx, u32 thread_idx);
69 transport_connection_t *(*get_listener) (u32 conn_index);
70 transport_connection_t *(*get_half_open) (u32 conn_index);
75 u8 *(*format_connection) (u8 * s, va_list * args);
76 u8 *(*format_listener) (u8 * s, va_list * args);
77 u8 *(*format_half_open) (u8 * s, va_list * args);
82 transport_tx_fn_type_t tx_type;
83 transport_service_type_t service_type;
84 } transport_proto_vft_t;
87 extern transport_proto_vft_t *tp_vfts;
89 #define transport_proto_foreach(VAR, BODY) \
91 for (VAR = 0; VAR < vec_len (tp_vfts); VAR++) \
92 if (tp_vfts[VAR].push_header != 0) \
93 do { BODY; } while (0); \
96 void transport_register_protocol (transport_proto_t transport_proto,
97 const transport_proto_vft_t * vft,
98 fib_protocol_t fib_proto, u32 output_node);
99 transport_proto_vft_t *transport_protocol_get_vft (transport_proto_t tp);
100 transport_service_type_t transport_protocol_service_type (transport_proto_t);
101 transport_tx_fn_type_t transport_protocol_tx_fn_type (transport_proto_t tp);
102 void transport_update_time (f64 time_now, u8 thread_index);
103 void transport_enable_disable (vlib_main_t * vm, u8 is_en);
105 void transport_connection_tx_pacer_reset (transport_connection_t * tc,
106 u32 rate_bytes_per_sec,
107 u32 initial_bucket, u64 time_now);
109 * Initialize tx pacer for connection
111 * @param tc transport connection
112 * @param rate_bytes_per_second initial byte rate
113 * @param burst_bytes initial burst size in bytes
115 void transport_connection_tx_pacer_init (transport_connection_t * tc,
116 u32 rate_bytes_per_sec,
120 * Update tx pacer pacing rate
122 * @param tc transport connection
123 * @param bytes_per_sec new pacing rate
125 void transport_connection_tx_pacer_update (transport_connection_t * tc,
129 * Get maximum tx burst allowed for transport connection
131 * @param tc transport connection
132 * @param time_now current cpu time as returned by @ref clib_cpu_time_now
133 * @param mss transport's mss
135 u32 transport_connection_snd_space (transport_connection_t * tc,
136 u64 time_now, u16 mss);
138 u32 transport_connection_tx_pacer_burst (transport_connection_t * tc,
142 * Initialize period for tx pacers
144 * Defines a unit of time with respect to number of cpu cycles that is to
145 * be used by all tx pacers.
147 void transport_init_tx_pacers_period (void);
150 * Check if transport connection is paced
153 transport_connection_is_tx_paced (transport_connection_t * tc)
155 return (tc->flags & TRANSPORT_CONNECTION_F_IS_TX_PACED);
158 u8 *format_transport_pacer (u8 * s, va_list * args);
161 * Update tx byte stats for transport connection
163 * If tx pacing is enabled, this also updates pacer bucket to account for the
164 * amount of bytes that have been sent.
166 * @param tc transport connection
167 * @param pkts packets recently sent
168 * @param bytes bytes recently sent
170 void transport_connection_update_tx_stats (transport_connection_t * tc,
174 transport_connection_tx_pacer_update_bytes (transport_connection_t * tc,
177 #endif /* SRC_VNET_SESSION_TRANSPORT_INTERFACE_H_ */
180 * fd.io coding-style-patch-verification: ON
183 * eval: (c-set-style "gnu")