xref: /openbmc/linux/include/net/inet_connection_sock.h (revision 0760aad038b5a032c31ea124feed63d88627d2f1)
1 /* SPDX-License-Identifier: GPL-2.0-or-later */
2 /*
3  * NET		Generic infrastructure for INET connection oriented protocols.
4  *
5  *		Definitions for inet_connection_sock
6  *
7  * Authors:	Many people, see the TCP sources
8  *
9  * 		From code originally in TCP
10  */
11 #ifndef _INET_CONNECTION_SOCK_H
12 #define _INET_CONNECTION_SOCK_H
13 
14 #include <linux/compiler.h>
15 #include <linux/string.h>
16 #include <linux/timer.h>
17 #include <linux/poll.h>
18 #include <linux/kernel.h>
19 #include <linux/sockptr.h>
20 
21 #include <net/inet_sock.h>
22 #include <net/request_sock.h>
23 
24 /* Cancel timers, when they are not required. */
25 #undef INET_CSK_CLEAR_TIMERS
26 
27 struct inet_bind_bucket;
28 struct tcp_congestion_ops;
29 
30 /*
31  * Pointers to address related TCP functions
32  * (i.e. things that depend on the address family)
33  */
34 struct inet_connection_sock_af_ops {
35 	int	    (*queue_xmit)(struct sock *sk, struct sk_buff *skb, struct flowi *fl);
36 	void	    (*send_check)(struct sock *sk, struct sk_buff *skb);
37 	int	    (*rebuild_header)(struct sock *sk);
38 	void	    (*sk_rx_dst_set)(struct sock *sk, const struct sk_buff *skb);
39 	int	    (*conn_request)(struct sock *sk, struct sk_buff *skb);
40 	struct sock *(*syn_recv_sock)(const struct sock *sk, struct sk_buff *skb,
41 				      struct request_sock *req,
42 				      struct dst_entry *dst,
43 				      struct request_sock *req_unhash,
44 				      bool *own_req);
45 	u16	    net_header_len;
46 	u16	    net_frag_header_len;
47 	u16	    sockaddr_len;
48 	int	    (*setsockopt)(struct sock *sk, int level, int optname,
49 				  sockptr_t optval, unsigned int optlen);
50 	int	    (*getsockopt)(struct sock *sk, int level, int optname,
51 				  char __user *optval, int __user *optlen);
52 	void	    (*addr2sockaddr)(struct sock *sk, struct sockaddr *);
53 	void	    (*mtu_reduced)(struct sock *sk);
54 };
55 
56 /** inet_connection_sock - INET connection oriented sock
57  *
58  * @icsk_accept_queue:	   FIFO of established children
59  * @icsk_bind_hash:	   Bind node
60  * @icsk_timeout:	   Timeout
61  * @icsk_retransmit_timer: Resend (no ack)
62  * @icsk_rto:		   Retransmit timeout
63  * @icsk_pmtu_cookie	   Last pmtu seen by socket
64  * @icsk_ca_ops		   Pluggable congestion control hook
65  * @icsk_af_ops		   Operations which are AF_INET{4,6} specific
66  * @icsk_ulp_ops	   Pluggable ULP control hook
67  * @icsk_ulp_data	   ULP private data
68  * @icsk_clean_acked	   Clean acked data hook
69  * @icsk_listen_portaddr_node	hash to the portaddr listener hashtable
70  * @icsk_ca_state:	   Congestion control state
71  * @icsk_retransmits:	   Number of unrecovered [RTO] timeouts
72  * @icsk_pending:	   Scheduled timer event
73  * @icsk_backoff:	   Backoff
74  * @icsk_syn_retries:      Number of allowed SYN (or equivalent) retries
75  * @icsk_probes_out:	   unanswered 0 window probes
76  * @icsk_ext_hdr_len:	   Network protocol overhead (IP/IPv6 options)
77  * @icsk_ack:		   Delayed ACK control data
78  * @icsk_mtup;		   MTU probing control data
79  */
80 struct inet_connection_sock {
81 	/* inet_sock has to be the first member! */
82 	struct inet_sock	  icsk_inet;
83 	struct request_sock_queue icsk_accept_queue;
84 	struct inet_bind_bucket	  *icsk_bind_hash;
85 	unsigned long		  icsk_timeout;
86  	struct timer_list	  icsk_retransmit_timer;
87  	struct timer_list	  icsk_delack_timer;
88 	__u32			  icsk_rto;
89 	__u32                     icsk_rto_min;
90 	__u32                     icsk_delack_max;
91 	__u32			  icsk_pmtu_cookie;
92 	const struct tcp_congestion_ops *icsk_ca_ops;
93 	const struct inet_connection_sock_af_ops *icsk_af_ops;
94 	const struct tcp_ulp_ops  *icsk_ulp_ops;
95 	void __rcu		  *icsk_ulp_data;
96 	void (*icsk_clean_acked)(struct sock *sk, u32 acked_seq);
97 	struct hlist_node         icsk_listen_portaddr_node;
98 	unsigned int		  (*icsk_sync_mss)(struct sock *sk, u32 pmtu);
99 	__u8			  icsk_ca_state:6,
100 				  icsk_ca_setsockopt:1,
101 				  icsk_ca_dst_locked:1;
102 	__u8			  icsk_retransmits;
103 	__u8			  icsk_pending;
104 	__u8			  icsk_backoff;
105 	__u8			  icsk_syn_retries;
106 	__u8			  icsk_probes_out;
107 	__u16			  icsk_ext_hdr_len;
108 	struct {
109 		__u8		  pending;	 /* ACK is pending			   */
110 		__u8		  quick;	 /* Scheduled number of quick acks	   */
111 		__u8		  pingpong;	 /* The session is interactive		   */
112 		__u8		  blocked;	 /* Delayed ACK was blocked by socket lock */
113 		__u32		  ato;		 /* Predicted tick of soft clock	   */
114 		unsigned long	  timeout;	 /* Currently scheduled timeout		   */
115 		__u32		  lrcvtime;	 /* timestamp of last received data packet */
116 		__u16		  last_seg_size; /* Size of last incoming segment	   */
117 		__u16		  rcv_mss;	 /* MSS used for delayed ACK decisions	   */
118 	} icsk_ack;
119 	struct {
120 		int		  enabled;
121 
122 		/* Range of MTUs to search */
123 		int		  search_high;
124 		int		  search_low;
125 
126 		/* Information on the current probe. */
127 		int		  probe_size;
128 
129 		u32		  probe_timestamp;
130 	} icsk_mtup;
131 	u32			  icsk_user_timeout;
132 
133 	u64			  icsk_ca_priv[104 / sizeof(u64)];
134 #define ICSK_CA_PRIV_SIZE      (13 * sizeof(u64))
135 };
136 
137 #define ICSK_TIME_RETRANS	1	/* Retransmit timer */
138 #define ICSK_TIME_DACK		2	/* Delayed ack timer */
139 #define ICSK_TIME_PROBE0	3	/* Zero window probe timer */
140 #define ICSK_TIME_EARLY_RETRANS 4	/* Early retransmit timer */
141 #define ICSK_TIME_LOSS_PROBE	5	/* Tail loss probe timer */
142 #define ICSK_TIME_REO_TIMEOUT	6	/* Reordering timer */
143 
144 static inline struct inet_connection_sock *inet_csk(const struct sock *sk)
145 {
146 	return (struct inet_connection_sock *)sk;
147 }
148 
149 static inline void *inet_csk_ca(const struct sock *sk)
150 {
151 	return (void *)inet_csk(sk)->icsk_ca_priv;
152 }
153 
154 struct sock *inet_csk_clone_lock(const struct sock *sk,
155 				 const struct request_sock *req,
156 				 const gfp_t priority);
157 
158 enum inet_csk_ack_state_t {
159 	ICSK_ACK_SCHED	= 1,
160 	ICSK_ACK_TIMER  = 2,
161 	ICSK_ACK_PUSHED = 4,
162 	ICSK_ACK_PUSHED2 = 8,
163 	ICSK_ACK_NOW = 16	/* Send the next ACK immediately (once) */
164 };
165 
166 void inet_csk_init_xmit_timers(struct sock *sk,
167 			       void (*retransmit_handler)(struct timer_list *),
168 			       void (*delack_handler)(struct timer_list *),
169 			       void (*keepalive_handler)(struct timer_list *));
170 void inet_csk_clear_xmit_timers(struct sock *sk);
171 
172 static inline void inet_csk_schedule_ack(struct sock *sk)
173 {
174 	inet_csk(sk)->icsk_ack.pending |= ICSK_ACK_SCHED;
175 }
176 
177 static inline int inet_csk_ack_scheduled(const struct sock *sk)
178 {
179 	return inet_csk(sk)->icsk_ack.pending & ICSK_ACK_SCHED;
180 }
181 
182 static inline void inet_csk_delack_init(struct sock *sk)
183 {
184 	memset(&inet_csk(sk)->icsk_ack, 0, sizeof(inet_csk(sk)->icsk_ack));
185 }
186 
187 void inet_csk_delete_keepalive_timer(struct sock *sk);
188 void inet_csk_reset_keepalive_timer(struct sock *sk, unsigned long timeout);
189 
190 static inline void inet_csk_clear_xmit_timer(struct sock *sk, const int what)
191 {
192 	struct inet_connection_sock *icsk = inet_csk(sk);
193 
194 	if (what == ICSK_TIME_RETRANS || what == ICSK_TIME_PROBE0) {
195 		icsk->icsk_pending = 0;
196 #ifdef INET_CSK_CLEAR_TIMERS
197 		sk_stop_timer(sk, &icsk->icsk_retransmit_timer);
198 #endif
199 	} else if (what == ICSK_TIME_DACK) {
200 		icsk->icsk_ack.blocked = icsk->icsk_ack.pending = 0;
201 #ifdef INET_CSK_CLEAR_TIMERS
202 		sk_stop_timer(sk, &icsk->icsk_delack_timer);
203 #endif
204 	} else {
205 		pr_debug("inet_csk BUG: unknown timer value\n");
206 	}
207 }
208 
209 /*
210  *	Reset the retransmission timer
211  */
212 static inline void inet_csk_reset_xmit_timer(struct sock *sk, const int what,
213 					     unsigned long when,
214 					     const unsigned long max_when)
215 {
216 	struct inet_connection_sock *icsk = inet_csk(sk);
217 
218 	if (when > max_when) {
219 		pr_debug("reset_xmit_timer: sk=%p %d when=0x%lx, caller=%p\n",
220 			 sk, what, when, (void *)_THIS_IP_);
221 		when = max_when;
222 	}
223 
224 	if (what == ICSK_TIME_RETRANS || what == ICSK_TIME_PROBE0 ||
225 	    what == ICSK_TIME_EARLY_RETRANS || what == ICSK_TIME_LOSS_PROBE ||
226 	    what == ICSK_TIME_REO_TIMEOUT) {
227 		icsk->icsk_pending = what;
228 		icsk->icsk_timeout = jiffies + when;
229 		sk_reset_timer(sk, &icsk->icsk_retransmit_timer, icsk->icsk_timeout);
230 	} else if (what == ICSK_TIME_DACK) {
231 		icsk->icsk_ack.pending |= ICSK_ACK_TIMER;
232 		icsk->icsk_ack.timeout = jiffies + when;
233 		sk_reset_timer(sk, &icsk->icsk_delack_timer, icsk->icsk_ack.timeout);
234 	} else {
235 		pr_debug("inet_csk BUG: unknown timer value\n");
236 	}
237 }
238 
239 static inline unsigned long
240 inet_csk_rto_backoff(const struct inet_connection_sock *icsk,
241 		     unsigned long max_when)
242 {
243         u64 when = (u64)icsk->icsk_rto << icsk->icsk_backoff;
244 
245         return (unsigned long)min_t(u64, when, max_when);
246 }
247 
248 struct sock *inet_csk_accept(struct sock *sk, int flags, int *err, bool kern);
249 
250 int inet_csk_get_port(struct sock *sk, unsigned short snum);
251 
252 struct dst_entry *inet_csk_route_req(const struct sock *sk, struct flowi4 *fl4,
253 				     const struct request_sock *req);
254 struct dst_entry *inet_csk_route_child_sock(const struct sock *sk,
255 					    struct sock *newsk,
256 					    const struct request_sock *req);
257 
258 struct sock *inet_csk_reqsk_queue_add(struct sock *sk,
259 				      struct request_sock *req,
260 				      struct sock *child);
261 void inet_csk_reqsk_queue_hash_add(struct sock *sk, struct request_sock *req,
262 				   unsigned long timeout);
263 struct sock *inet_csk_complete_hashdance(struct sock *sk, struct sock *child,
264 					 struct request_sock *req,
265 					 bool own_req);
266 
267 static inline void inet_csk_reqsk_queue_added(struct sock *sk)
268 {
269 	reqsk_queue_added(&inet_csk(sk)->icsk_accept_queue);
270 }
271 
272 static inline int inet_csk_reqsk_queue_len(const struct sock *sk)
273 {
274 	return reqsk_queue_len(&inet_csk(sk)->icsk_accept_queue);
275 }
276 
277 static inline int inet_csk_reqsk_queue_is_full(const struct sock *sk)
278 {
279 	return inet_csk_reqsk_queue_len(sk) >= sk->sk_max_ack_backlog;
280 }
281 
282 void inet_csk_reqsk_queue_drop(struct sock *sk, struct request_sock *req);
283 void inet_csk_reqsk_queue_drop_and_put(struct sock *sk, struct request_sock *req);
284 
285 static inline void inet_csk_prepare_for_destroy_sock(struct sock *sk)
286 {
287 	/* The below has to be done to allow calling inet_csk_destroy_sock */
288 	sock_set_flag(sk, SOCK_DEAD);
289 	percpu_counter_inc(sk->sk_prot->orphan_count);
290 }
291 
292 void inet_csk_destroy_sock(struct sock *sk);
293 void inet_csk_prepare_forced_close(struct sock *sk);
294 
295 /*
296  * LISTEN is a special case for poll..
297  */
298 static inline __poll_t inet_csk_listen_poll(const struct sock *sk)
299 {
300 	return !reqsk_queue_empty(&inet_csk(sk)->icsk_accept_queue) ?
301 			(EPOLLIN | EPOLLRDNORM) : 0;
302 }
303 
304 int inet_csk_listen_start(struct sock *sk, int backlog);
305 void inet_csk_listen_stop(struct sock *sk);
306 
307 void inet_csk_addr2sockaddr(struct sock *sk, struct sockaddr *uaddr);
308 
309 /* update the fast reuse flag when adding a socket */
310 void inet_csk_update_fastreuse(struct inet_bind_bucket *tb,
311 			       struct sock *sk);
312 
313 struct dst_entry *inet_csk_update_pmtu(struct sock *sk, u32 mtu);
314 
315 #define TCP_PINGPONG_THRESH	3
316 
317 static inline void inet_csk_enter_pingpong_mode(struct sock *sk)
318 {
319 	inet_csk(sk)->icsk_ack.pingpong = TCP_PINGPONG_THRESH;
320 }
321 
322 static inline void inet_csk_exit_pingpong_mode(struct sock *sk)
323 {
324 	inet_csk(sk)->icsk_ack.pingpong = 0;
325 }
326 
327 static inline bool inet_csk_in_pingpong_mode(struct sock *sk)
328 {
329 	return inet_csk(sk)->icsk_ack.pingpong >= TCP_PINGPONG_THRESH;
330 }
331 
332 static inline void inet_csk_inc_pingpong_cnt(struct sock *sk)
333 {
334 	struct inet_connection_sock *icsk = inet_csk(sk);
335 
336 	if (icsk->icsk_ack.pingpong < U8_MAX)
337 		icsk->icsk_ack.pingpong++;
338 }
339 
340 static inline bool inet_csk_has_ulp(struct sock *sk)
341 {
342 	return inet_sk(sk)->is_icsk && !!inet_csk(sk)->icsk_ulp_ops;
343 }
344 
345 #endif /* _INET_CONNECTION_SOCK_H */
346