Linux kernel mirror (for testing)
git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel
os
linux
1/* SPDX-License-Identifier: GPL-2.0 */
2/* Multipath TCP
3 *
4 * Copyright (c) 2017 - 2019, Intel Corporation.
5 */
6
7#ifndef __MPTCP_PROTOCOL_H
8#define __MPTCP_PROTOCOL_H
9
10#include <linux/random.h>
11#include <net/tcp.h>
12#include <net/inet_connection_sock.h>
13#include <uapi/linux/mptcp.h>
14#include <net/genetlink.h>
15
16#define MPTCP_SUPPORTED_VERSION 1
17
18/* MPTCP option bits */
19#define OPTION_MPTCP_MPC_SYN BIT(0)
20#define OPTION_MPTCP_MPC_SYNACK BIT(1)
21#define OPTION_MPTCP_MPC_ACK BIT(2)
22#define OPTION_MPTCP_MPJ_SYN BIT(3)
23#define OPTION_MPTCP_MPJ_SYNACK BIT(4)
24#define OPTION_MPTCP_MPJ_ACK BIT(5)
25#define OPTION_MPTCP_ADD_ADDR BIT(6)
26#define OPTION_MPTCP_RM_ADDR BIT(7)
27#define OPTION_MPTCP_FASTCLOSE BIT(8)
28#define OPTION_MPTCP_PRIO BIT(9)
29#define OPTION_MPTCP_RST BIT(10)
30#define OPTION_MPTCP_DSS BIT(11)
31#define OPTION_MPTCP_FAIL BIT(12)
32
33#define OPTION_MPTCP_CSUMREQD BIT(13)
34
35#define OPTIONS_MPTCP_MPC (OPTION_MPTCP_MPC_SYN | OPTION_MPTCP_MPC_SYNACK | \
36 OPTION_MPTCP_MPC_ACK)
37#define OPTIONS_MPTCP_MPJ (OPTION_MPTCP_MPJ_SYN | OPTION_MPTCP_MPJ_SYNACK | \
38 OPTION_MPTCP_MPJ_ACK)
39
40/* MPTCP option subtypes */
41#define MPTCPOPT_MP_CAPABLE 0
42#define MPTCPOPT_MP_JOIN 1
43#define MPTCPOPT_DSS 2
44#define MPTCPOPT_ADD_ADDR 3
45#define MPTCPOPT_RM_ADDR 4
46#define MPTCPOPT_MP_PRIO 5
47#define MPTCPOPT_MP_FAIL 6
48#define MPTCPOPT_MP_FASTCLOSE 7
49#define MPTCPOPT_RST 8
50
51/* MPTCP suboption lengths */
52#define TCPOLEN_MPTCP_MPC_SYN 4
53#define TCPOLEN_MPTCP_MPC_SYNACK 12
54#define TCPOLEN_MPTCP_MPC_ACK 20
55#define TCPOLEN_MPTCP_MPC_ACK_DATA 22
56#define TCPOLEN_MPTCP_MPJ_SYN 12
57#define TCPOLEN_MPTCP_MPJ_SYNACK 16
58#define TCPOLEN_MPTCP_MPJ_ACK 24
59#define TCPOLEN_MPTCP_DSS_BASE 4
60#define TCPOLEN_MPTCP_DSS_ACK32 4
61#define TCPOLEN_MPTCP_DSS_ACK64 8
62#define TCPOLEN_MPTCP_DSS_MAP32 10
63#define TCPOLEN_MPTCP_DSS_MAP64 14
64#define TCPOLEN_MPTCP_DSS_CHECKSUM 2
65#define TCPOLEN_MPTCP_ADD_ADDR 16
66#define TCPOLEN_MPTCP_ADD_ADDR_PORT 18
67#define TCPOLEN_MPTCP_ADD_ADDR_BASE 8
68#define TCPOLEN_MPTCP_ADD_ADDR_BASE_PORT 10
69#define TCPOLEN_MPTCP_ADD_ADDR6 28
70#define TCPOLEN_MPTCP_ADD_ADDR6_PORT 30
71#define TCPOLEN_MPTCP_ADD_ADDR6_BASE 20
72#define TCPOLEN_MPTCP_ADD_ADDR6_BASE_PORT 22
73#define TCPOLEN_MPTCP_PORT_LEN 2
74#define TCPOLEN_MPTCP_PORT_ALIGN 2
75#define TCPOLEN_MPTCP_RM_ADDR_BASE 3
76#define TCPOLEN_MPTCP_PRIO 3
77#define TCPOLEN_MPTCP_PRIO_ALIGN 4
78#define TCPOLEN_MPTCP_FASTCLOSE 12
79#define TCPOLEN_MPTCP_RST 4
80#define TCPOLEN_MPTCP_FAIL 12
81
82#define TCPOLEN_MPTCP_MPC_ACK_DATA_CSUM (TCPOLEN_MPTCP_DSS_CHECKSUM + TCPOLEN_MPTCP_MPC_ACK_DATA)
83
84/* MPTCP MP_JOIN flags */
85#define MPTCPOPT_BACKUP BIT(0)
86#define MPTCPOPT_THMAC_LEN 8
87
88/* MPTCP MP_CAPABLE flags */
89#define MPTCP_VERSION_MASK (0x0F)
90#define MPTCP_CAP_CHECKSUM_REQD BIT(7)
91#define MPTCP_CAP_EXTENSIBILITY BIT(6)
92#define MPTCP_CAP_DENY_JOIN_ID0 BIT(5)
93#define MPTCP_CAP_HMAC_SHA256 BIT(0)
94#define MPTCP_CAP_FLAG_MASK (0x1F)
95
96/* MPTCP DSS flags */
97#define MPTCP_DSS_DATA_FIN BIT(4)
98#define MPTCP_DSS_DSN64 BIT(3)
99#define MPTCP_DSS_HAS_MAP BIT(2)
100#define MPTCP_DSS_ACK64 BIT(1)
101#define MPTCP_DSS_HAS_ACK BIT(0)
102#define MPTCP_DSS_FLAG_MASK (0x1F)
103
104/* MPTCP ADD_ADDR flags */
105#define MPTCP_ADDR_ECHO BIT(0)
106
107/* MPTCP MP_PRIO flags */
108#define MPTCP_PRIO_BKUP BIT(0)
109
110/* MPTCP TCPRST flags */
111#define MPTCP_RST_TRANSIENT BIT(0)
112
113/* MPTCP socket atomic flags */
114#define MPTCP_NOSPACE 1
115#define MPTCP_WORK_RTX 2
116#define MPTCP_WORK_EOF 3
117#define MPTCP_FALLBACK_DONE 4
118#define MPTCP_WORK_CLOSE_SUBFLOW 5
119
120/* MPTCP socket release cb flags */
121#define MPTCP_PUSH_PENDING 1
122#define MPTCP_CLEAN_UNA 2
123#define MPTCP_ERROR_REPORT 3
124#define MPTCP_RETRANSMIT 4
125#define MPTCP_FLUSH_JOIN_LIST 5
126#define MPTCP_CONNECTED 6
127#define MPTCP_RESET_SCHEDULER 7
128
129struct mptcp_skb_cb {
130 u64 map_seq;
131 u64 end_seq;
132 u32 offset;
133 u8 has_rxtstamp:1;
134};
135
136#define MPTCP_SKB_CB(__skb) ((struct mptcp_skb_cb *)&((__skb)->cb[0]))
137
138static inline bool before64(__u64 seq1, __u64 seq2)
139{
140 return (__s64)(seq1 - seq2) < 0;
141}
142
143#define after64(seq2, seq1) before64(seq1, seq2)
144
145struct mptcp_options_received {
146 u64 sndr_key;
147 u64 rcvr_key;
148 u64 data_ack;
149 u64 data_seq;
150 u32 subflow_seq;
151 u16 data_len;
152 __sum16 csum;
153 u16 suboptions;
154 u32 token;
155 u32 nonce;
156 u16 use_map:1,
157 dsn64:1,
158 data_fin:1,
159 use_ack:1,
160 ack64:1,
161 mpc_map:1,
162 reset_reason:4,
163 reset_transient:1,
164 echo:1,
165 backup:1,
166 deny_join_id0:1,
167 __unused:2;
168 u8 join_id;
169 u64 thmac;
170 u8 hmac[MPTCPOPT_HMAC_LEN];
171 struct mptcp_addr_info addr;
172 struct mptcp_rm_list rm_list;
173 u64 ahmac;
174 u64 fail_seq;
175};
176
177static inline __be32 mptcp_option(u8 subopt, u8 len, u8 nib, u8 field)
178{
179 return htonl((TCPOPT_MPTCP << 24) | (len << 16) | (subopt << 12) |
180 ((nib & 0xF) << 8) | field);
181}
182
183enum mptcp_pm_status {
184 MPTCP_PM_ADD_ADDR_RECEIVED,
185 MPTCP_PM_ADD_ADDR_SEND_ACK,
186 MPTCP_PM_RM_ADDR_RECEIVED,
187 MPTCP_PM_ESTABLISHED,
188 MPTCP_PM_SUBFLOW_ESTABLISHED,
189 MPTCP_PM_ALREADY_ESTABLISHED, /* persistent status, set after ESTABLISHED event */
190 MPTCP_PM_MPC_ENDPOINT_ACCOUNTED /* persistent status, set after MPC local address is
191 * accounted int id_avail_bitmap
192 */
193};
194
195enum mptcp_pm_type {
196 MPTCP_PM_TYPE_KERNEL = 0,
197 MPTCP_PM_TYPE_USERSPACE,
198
199 __MPTCP_PM_TYPE_NR,
200 __MPTCP_PM_TYPE_MAX = __MPTCP_PM_TYPE_NR - 1,
201};
202
203/* Status bits below MPTCP_PM_ALREADY_ESTABLISHED need pm worker actions */
204#define MPTCP_PM_WORK_MASK ((1 << MPTCP_PM_ALREADY_ESTABLISHED) - 1)
205
206enum mptcp_addr_signal_status {
207 MPTCP_ADD_ADDR_SIGNAL,
208 MPTCP_ADD_ADDR_ECHO,
209 MPTCP_RM_ADDR_SIGNAL,
210};
211
212/* max value of mptcp_addr_info.id */
213#define MPTCP_PM_MAX_ADDR_ID U8_MAX
214
215struct mptcp_pm_data {
216 struct mptcp_addr_info local;
217 struct mptcp_addr_info remote;
218 struct list_head anno_list;
219 struct list_head userspace_pm_local_addr_list;
220
221 spinlock_t lock; /*protects the whole PM data */
222
223 u8 addr_signal;
224 bool server_side;
225 bool work_pending;
226 bool accept_addr;
227 bool accept_subflow;
228 bool remote_deny_join_id0;
229 u8 add_addr_signaled;
230 u8 add_addr_accepted;
231 u8 local_addr_used;
232 u8 pm_type;
233 u8 subflows;
234 u8 status;
235 DECLARE_BITMAP(id_avail_bitmap, MPTCP_PM_MAX_ADDR_ID + 1);
236 struct mptcp_rm_list rm_list_tx;
237 struct mptcp_rm_list rm_list_rx;
238};
239
240struct mptcp_pm_addr_entry {
241 struct list_head list;
242 struct mptcp_addr_info addr;
243 u8 flags;
244 int ifindex;
245 struct socket *lsk;
246};
247
248struct mptcp_data_frag {
249 struct list_head list;
250 u64 data_seq;
251 u16 data_len;
252 u16 offset;
253 u16 overhead;
254 u16 already_sent;
255 struct page *page;
256};
257
258/* MPTCP connection sock */
259struct mptcp_sock {
260 /* inet_connection_sock must be the first member */
261 struct inet_connection_sock sk;
262 u64 local_key;
263 u64 remote_key;
264 u64 write_seq;
265 u64 snd_nxt;
266 u64 ack_seq;
267 atomic64_t rcv_wnd_sent;
268 u64 rcv_data_fin_seq;
269 int rmem_fwd_alloc;
270 struct sock *last_snd;
271 int snd_burst;
272 int old_wspace;
273 u64 recovery_snd_nxt; /* in recovery mode accept up to this seq;
274 * recovery related fields are under data_lock
275 * protection
276 */
277 u64 snd_una;
278 u64 wnd_end;
279 unsigned long timer_ival;
280 u32 token;
281 int rmem_released;
282 unsigned long flags;
283 unsigned long cb_flags;
284 unsigned long push_pending;
285 bool recovery; /* closing subflow write queue reinjected */
286 bool can_ack;
287 bool fully_established;
288 bool rcv_data_fin;
289 bool snd_data_fin_enable;
290 bool rcv_fastclose;
291 bool use_64bit_ack; /* Set when we received a 64-bit DSN */
292 bool csum_enabled;
293 bool allow_infinite_fallback;
294 u8 mpc_endpoint_id;
295 u8 recvmsg_inq:1,
296 cork:1,
297 nodelay:1,
298 fastopening:1,
299 in_accept_queue:1;
300 int connect_flags;
301 struct work_struct work;
302 struct sk_buff *ooo_last_skb;
303 struct rb_root out_of_order_queue;
304 struct sk_buff_head receive_queue;
305 struct list_head conn_list;
306 struct list_head rtx_queue;
307 struct mptcp_data_frag *first_pending;
308 struct list_head join_list;
309 struct socket *subflow; /* outgoing connect/listener/!mp_capable */
310 struct sock *first;
311 struct mptcp_pm_data pm;
312 struct {
313 u32 space; /* bytes copied in last measurement window */
314 u32 copied; /* bytes copied in this measurement window */
315 u64 time; /* start time of measurement window */
316 u64 rtt_us; /* last maximum rtt of subflows */
317 } rcvq_space;
318
319 u32 setsockopt_seq;
320 char ca_name[TCP_CA_NAME_MAX];
321 struct mptcp_sock *dl_next;
322};
323
324#define mptcp_data_lock(sk) spin_lock_bh(&(sk)->sk_lock.slock)
325#define mptcp_data_unlock(sk) spin_unlock_bh(&(sk)->sk_lock.slock)
326
327#define mptcp_for_each_subflow(__msk, __subflow) \
328 list_for_each_entry(__subflow, &((__msk)->conn_list), node)
329#define mptcp_for_each_subflow_safe(__msk, __subflow, __tmp) \
330 list_for_each_entry_safe(__subflow, __tmp, &((__msk)->conn_list), node)
331
332static inline void msk_owned_by_me(const struct mptcp_sock *msk)
333{
334 sock_owned_by_me((const struct sock *)msk);
335}
336
337static inline struct mptcp_sock *mptcp_sk(const struct sock *sk)
338{
339 return (struct mptcp_sock *)sk;
340}
341
342/* the msk socket don't use the backlog, also account for the bulk
343 * free memory
344 */
345static inline int __mptcp_rmem(const struct sock *sk)
346{
347 return atomic_read(&sk->sk_rmem_alloc) - READ_ONCE(mptcp_sk(sk)->rmem_released);
348}
349
350static inline int __mptcp_space(const struct sock *sk)
351{
352 return tcp_win_from_space(sk, READ_ONCE(sk->sk_rcvbuf) - __mptcp_rmem(sk));
353}
354
355static inline struct mptcp_data_frag *mptcp_send_head(const struct sock *sk)
356{
357 const struct mptcp_sock *msk = mptcp_sk(sk);
358
359 return READ_ONCE(msk->first_pending);
360}
361
362static inline struct mptcp_data_frag *mptcp_send_next(struct sock *sk)
363{
364 struct mptcp_sock *msk = mptcp_sk(sk);
365 struct mptcp_data_frag *cur;
366
367 cur = msk->first_pending;
368 return list_is_last(&cur->list, &msk->rtx_queue) ? NULL :
369 list_next_entry(cur, list);
370}
371
372static inline struct mptcp_data_frag *mptcp_pending_tail(const struct sock *sk)
373{
374 struct mptcp_sock *msk = mptcp_sk(sk);
375
376 if (!msk->first_pending)
377 return NULL;
378
379 if (WARN_ON_ONCE(list_empty(&msk->rtx_queue)))
380 return NULL;
381
382 return list_last_entry(&msk->rtx_queue, struct mptcp_data_frag, list);
383}
384
385static inline struct mptcp_data_frag *mptcp_rtx_head(const struct sock *sk)
386{
387 struct mptcp_sock *msk = mptcp_sk(sk);
388
389 if (msk->snd_una == READ_ONCE(msk->snd_nxt))
390 return NULL;
391
392 return list_first_entry_or_null(&msk->rtx_queue, struct mptcp_data_frag, list);
393}
394
395struct csum_pseudo_header {
396 __be64 data_seq;
397 __be32 subflow_seq;
398 __be16 data_len;
399 __sum16 csum;
400};
401
402struct mptcp_subflow_request_sock {
403 struct tcp_request_sock sk;
404 u16 mp_capable : 1,
405 mp_join : 1,
406 backup : 1,
407 csum_reqd : 1,
408 allow_join_id0 : 1;
409 u8 local_id;
410 u8 remote_id;
411 u64 local_key;
412 u64 idsn;
413 u32 token;
414 u32 ssn_offset;
415 u64 thmac;
416 u32 local_nonce;
417 u32 remote_nonce;
418 struct mptcp_sock *msk;
419 struct hlist_nulls_node token_node;
420};
421
422static inline struct mptcp_subflow_request_sock *
423mptcp_subflow_rsk(const struct request_sock *rsk)
424{
425 return (struct mptcp_subflow_request_sock *)rsk;
426}
427
428enum mptcp_data_avail {
429 MPTCP_SUBFLOW_NODATA,
430 MPTCP_SUBFLOW_DATA_AVAIL,
431};
432
433struct mptcp_delegated_action {
434 struct napi_struct napi;
435 struct list_head head;
436};
437
438DECLARE_PER_CPU(struct mptcp_delegated_action, mptcp_delegated_actions);
439
440#define MPTCP_DELEGATE_SEND 0
441#define MPTCP_DELEGATE_ACK 1
442
443/* MPTCP subflow context */
444struct mptcp_subflow_context {
445 struct list_head node;/* conn_list of subflows */
446
447 struct_group(reset,
448
449 unsigned long avg_pacing_rate; /* protected by msk socket lock */
450 u64 local_key;
451 u64 remote_key;
452 u64 idsn;
453 u64 map_seq;
454 u32 snd_isn;
455 u32 token;
456 u32 rel_write_seq;
457 u32 map_subflow_seq;
458 u32 ssn_offset;
459 u32 map_data_len;
460 __wsum map_data_csum;
461 u32 map_csum_len;
462 u32 request_mptcp : 1, /* send MP_CAPABLE */
463 request_join : 1, /* send MP_JOIN */
464 request_bkup : 1,
465 mp_capable : 1, /* remote is MPTCP capable */
466 mp_join : 1, /* remote is JOINing */
467 fully_established : 1, /* path validated */
468 pm_notified : 1, /* PM hook called for established status */
469 conn_finished : 1,
470 map_valid : 1,
471 map_csum_reqd : 1,
472 map_data_fin : 1,
473 mpc_map : 1,
474 backup : 1,
475 send_mp_prio : 1,
476 send_mp_fail : 1,
477 send_fastclose : 1,
478 send_infinite_map : 1,
479 rx_eof : 1,
480 remote_key_valid : 1, /* received the peer key from */
481 disposable : 1, /* ctx can be free at ulp release time */
482 stale : 1, /* unable to snd/rcv data, do not use for xmit */
483 local_id_valid : 1, /* local_id is correctly initialized */
484 valid_csum_seen : 1, /* at least one csum validated */
485 is_mptfo : 1, /* subflow is doing TFO */
486 __unused : 8;
487 enum mptcp_data_avail data_avail;
488 u32 remote_nonce;
489 u64 thmac;
490 u32 local_nonce;
491 u32 remote_token;
492 union {
493 u8 hmac[MPTCPOPT_HMAC_LEN]; /* MPJ subflow only */
494 u64 iasn; /* initial ack sequence number, MPC subflows only */
495 };
496 u8 local_id;
497 u8 remote_id;
498 u8 reset_seen:1;
499 u8 reset_transient:1;
500 u8 reset_reason:4;
501 u8 stale_count;
502
503 long delegated_status;
504 unsigned long fail_tout;
505
506 );
507
508 struct list_head delegated_node; /* link into delegated_action, protected by local BH */
509
510 u32 setsockopt_seq;
511 u32 stale_rcv_tstamp;
512
513 struct sock *tcp_sock; /* tcp sk backpointer */
514 struct sock *conn; /* parent mptcp_sock */
515 const struct inet_connection_sock_af_ops *icsk_af_ops;
516 void (*tcp_state_change)(struct sock *sk);
517 void (*tcp_error_report)(struct sock *sk);
518
519 struct rcu_head rcu;
520};
521
522static inline struct mptcp_subflow_context *
523mptcp_subflow_ctx(const struct sock *sk)
524{
525 struct inet_connection_sock *icsk = inet_csk(sk);
526
527 /* Use RCU on icsk_ulp_data only for sock diag code */
528 return (__force struct mptcp_subflow_context *)icsk->icsk_ulp_data;
529}
530
531static inline struct sock *
532mptcp_subflow_tcp_sock(const struct mptcp_subflow_context *subflow)
533{
534 return subflow->tcp_sock;
535}
536
537static inline void
538mptcp_subflow_ctx_reset(struct mptcp_subflow_context *subflow)
539{
540 memset(&subflow->reset, 0, sizeof(subflow->reset));
541 subflow->request_mptcp = 1;
542}
543
544static inline u64
545mptcp_subflow_get_map_offset(const struct mptcp_subflow_context *subflow)
546{
547 return tcp_sk(mptcp_subflow_tcp_sock(subflow))->copied_seq -
548 subflow->ssn_offset -
549 subflow->map_subflow_seq;
550}
551
552static inline u64
553mptcp_subflow_get_mapped_dsn(const struct mptcp_subflow_context *subflow)
554{
555 return subflow->map_seq + mptcp_subflow_get_map_offset(subflow);
556}
557
558void mptcp_subflow_process_delegated(struct sock *ssk);
559
560static inline void mptcp_subflow_delegate(struct mptcp_subflow_context *subflow, int action)
561{
562 struct mptcp_delegated_action *delegated;
563 bool schedule;
564
565 /* the caller held the subflow bh socket lock */
566 lockdep_assert_in_softirq();
567
568 /* The implied barrier pairs with mptcp_subflow_delegated_done(), and
569 * ensures the below list check sees list updates done prior to status
570 * bit changes
571 */
572 if (!test_and_set_bit(action, &subflow->delegated_status)) {
573 /* still on delegated list from previous scheduling */
574 if (!list_empty(&subflow->delegated_node))
575 return;
576
577 delegated = this_cpu_ptr(&mptcp_delegated_actions);
578 schedule = list_empty(&delegated->head);
579 list_add_tail(&subflow->delegated_node, &delegated->head);
580 sock_hold(mptcp_subflow_tcp_sock(subflow));
581 if (schedule)
582 napi_schedule(&delegated->napi);
583 }
584}
585
586static inline struct mptcp_subflow_context *
587mptcp_subflow_delegated_next(struct mptcp_delegated_action *delegated)
588{
589 struct mptcp_subflow_context *ret;
590
591 if (list_empty(&delegated->head))
592 return NULL;
593
594 ret = list_first_entry(&delegated->head, struct mptcp_subflow_context, delegated_node);
595 list_del_init(&ret->delegated_node);
596 return ret;
597}
598
599static inline bool mptcp_subflow_has_delegated_action(const struct mptcp_subflow_context *subflow)
600{
601 return !!READ_ONCE(subflow->delegated_status);
602}
603
604static inline void mptcp_subflow_delegated_done(struct mptcp_subflow_context *subflow, int action)
605{
606 /* pairs with mptcp_subflow_delegate, ensures delegate_node is updated before
607 * touching the status bit
608 */
609 smp_wmb();
610 clear_bit(action, &subflow->delegated_status);
611}
612
613int mptcp_is_enabled(const struct net *net);
614unsigned int mptcp_get_add_addr_timeout(const struct net *net);
615int mptcp_is_checksum_enabled(const struct net *net);
616int mptcp_allow_join_id0(const struct net *net);
617unsigned int mptcp_stale_loss_cnt(const struct net *net);
618int mptcp_get_pm_type(const struct net *net);
619void mptcp_copy_inaddrs(struct sock *msk, const struct sock *ssk);
620void mptcp_subflow_fully_established(struct mptcp_subflow_context *subflow,
621 const struct mptcp_options_received *mp_opt);
622bool __mptcp_retransmit_pending_data(struct sock *sk);
623void mptcp_check_and_set_pending(struct sock *sk);
624void __mptcp_push_pending(struct sock *sk, unsigned int flags);
625bool mptcp_subflow_data_available(struct sock *sk);
626void __init mptcp_subflow_init(void);
627void mptcp_subflow_shutdown(struct sock *sk, struct sock *ssk, int how);
628void mptcp_close_ssk(struct sock *sk, struct sock *ssk,
629 struct mptcp_subflow_context *subflow);
630void __mptcp_subflow_send_ack(struct sock *ssk);
631void mptcp_subflow_reset(struct sock *ssk);
632void mptcp_subflow_queue_clean(struct sock *sk, struct sock *ssk);
633void mptcp_sock_graft(struct sock *sk, struct socket *parent);
634struct socket *__mptcp_nmpc_socket(const struct mptcp_sock *msk);
635bool __mptcp_close(struct sock *sk, long timeout);
636void mptcp_cancel_work(struct sock *sk);
637void __mptcp_unaccepted_force_close(struct sock *sk);
638void mptcp_set_owner_r(struct sk_buff *skb, struct sock *sk);
639
640bool mptcp_addresses_equal(const struct mptcp_addr_info *a,
641 const struct mptcp_addr_info *b, bool use_port);
642
643/* called with sk socket lock held */
644int __mptcp_subflow_connect(struct sock *sk, const struct mptcp_addr_info *loc,
645 const struct mptcp_addr_info *remote);
646int mptcp_subflow_create_socket(struct sock *sk, unsigned short family,
647 struct socket **new_sock);
648void mptcp_info2sockaddr(const struct mptcp_addr_info *info,
649 struct sockaddr_storage *addr,
650 unsigned short family);
651
652static inline bool __tcp_can_send(const struct sock *ssk)
653{
654 /* only send if our side has not closed yet */
655 return ((1 << inet_sk_state_load(ssk)) & (TCPF_ESTABLISHED | TCPF_CLOSE_WAIT));
656}
657
658static inline bool __mptcp_subflow_active(struct mptcp_subflow_context *subflow)
659{
660 /* can't send if JOIN hasn't completed yet (i.e. is usable for mptcp) */
661 if (subflow->request_join && !subflow->fully_established)
662 return false;
663
664 return __tcp_can_send(mptcp_subflow_tcp_sock(subflow));
665}
666
667void mptcp_subflow_set_active(struct mptcp_subflow_context *subflow);
668
669bool mptcp_subflow_active(struct mptcp_subflow_context *subflow);
670
671void mptcp_subflow_drop_ctx(struct sock *ssk);
672
673static inline void mptcp_subflow_tcp_fallback(struct sock *sk,
674 struct mptcp_subflow_context *ctx)
675{
676 sk->sk_data_ready = sock_def_readable;
677 sk->sk_state_change = ctx->tcp_state_change;
678 sk->sk_write_space = sk_stream_write_space;
679 sk->sk_error_report = ctx->tcp_error_report;
680
681 inet_csk(sk)->icsk_af_ops = ctx->icsk_af_ops;
682}
683
684void __init mptcp_proto_init(void);
685#if IS_ENABLED(CONFIG_MPTCP_IPV6)
686int __init mptcp_proto_v6_init(void);
687#endif
688
689struct sock *mptcp_sk_clone(const struct sock *sk,
690 const struct mptcp_options_received *mp_opt,
691 struct request_sock *req);
692void mptcp_get_options(const struct sk_buff *skb,
693 struct mptcp_options_received *mp_opt);
694
695void mptcp_finish_connect(struct sock *sk);
696void __mptcp_set_connected(struct sock *sk);
697void mptcp_reset_timeout(struct mptcp_sock *msk, unsigned long fail_tout);
698static inline bool mptcp_is_fully_established(struct sock *sk)
699{
700 return inet_sk_state_load(sk) == TCP_ESTABLISHED &&
701 READ_ONCE(mptcp_sk(sk)->fully_established);
702}
703void mptcp_rcv_space_init(struct mptcp_sock *msk, const struct sock *ssk);
704void mptcp_data_ready(struct sock *sk, struct sock *ssk);
705bool mptcp_finish_join(struct sock *sk);
706bool mptcp_schedule_work(struct sock *sk);
707int mptcp_setsockopt(struct sock *sk, int level, int optname,
708 sockptr_t optval, unsigned int optlen);
709int mptcp_getsockopt(struct sock *sk, int level, int optname,
710 char __user *optval, int __user *option);
711
712u64 __mptcp_expand_seq(u64 old_seq, u64 cur_seq);
713static inline u64 mptcp_expand_seq(u64 old_seq, u64 cur_seq, bool use_64bit)
714{
715 if (use_64bit)
716 return cur_seq;
717
718 return __mptcp_expand_seq(old_seq, cur_seq);
719}
720void __mptcp_check_push(struct sock *sk, struct sock *ssk);
721void __mptcp_data_acked(struct sock *sk);
722void __mptcp_error_report(struct sock *sk);
723void mptcp_subflow_eof(struct sock *sk);
724bool mptcp_update_rcv_data_fin(struct mptcp_sock *msk, u64 data_fin_seq, bool use_64bit);
725static inline bool mptcp_data_fin_enabled(const struct mptcp_sock *msk)
726{
727 return READ_ONCE(msk->snd_data_fin_enable) &&
728 READ_ONCE(msk->write_seq) == READ_ONCE(msk->snd_nxt);
729}
730
731static inline bool mptcp_propagate_sndbuf(struct sock *sk, struct sock *ssk)
732{
733 if ((sk->sk_userlocks & SOCK_SNDBUF_LOCK) || ssk->sk_sndbuf <= READ_ONCE(sk->sk_sndbuf))
734 return false;
735
736 WRITE_ONCE(sk->sk_sndbuf, ssk->sk_sndbuf);
737 return true;
738}
739
740static inline void mptcp_write_space(struct sock *sk)
741{
742 if (sk_stream_is_writeable(sk)) {
743 /* pairs with memory barrier in mptcp_poll */
744 smp_mb();
745 if (test_and_clear_bit(MPTCP_NOSPACE, &mptcp_sk(sk)->flags))
746 sk_stream_write_space(sk);
747 }
748}
749
750void mptcp_destroy_common(struct mptcp_sock *msk, unsigned int flags);
751
752#define MPTCP_TOKEN_MAX_RETRIES 4
753
754void __init mptcp_token_init(void);
755static inline void mptcp_token_init_request(struct request_sock *req)
756{
757 mptcp_subflow_rsk(req)->token_node.pprev = NULL;
758}
759
760int mptcp_token_new_request(struct request_sock *req);
761void mptcp_token_destroy_request(struct request_sock *req);
762int mptcp_token_new_connect(struct sock *ssk);
763void mptcp_token_accept(struct mptcp_subflow_request_sock *r,
764 struct mptcp_sock *msk);
765bool mptcp_token_exists(u32 token);
766struct mptcp_sock *mptcp_token_get_sock(struct net *net, u32 token);
767struct mptcp_sock *mptcp_token_iter_next(const struct net *net, long *s_slot,
768 long *s_num);
769void mptcp_token_destroy(struct mptcp_sock *msk);
770
771void mptcp_crypto_key_sha(u64 key, u32 *token, u64 *idsn);
772
773void mptcp_crypto_hmac_sha(u64 key1, u64 key2, u8 *msg, int len, void *hmac);
774__sum16 __mptcp_make_csum(u64 data_seq, u32 subflow_seq, u16 data_len, __wsum sum);
775
776void __init mptcp_pm_init(void);
777void mptcp_pm_data_init(struct mptcp_sock *msk);
778void mptcp_pm_data_reset(struct mptcp_sock *msk);
779int mptcp_pm_parse_addr(struct nlattr *attr, struct genl_info *info,
780 struct mptcp_addr_info *addr);
781int mptcp_pm_parse_entry(struct nlattr *attr, struct genl_info *info,
782 bool require_family,
783 struct mptcp_pm_addr_entry *entry);
784bool mptcp_pm_addr_families_match(const struct sock *sk,
785 const struct mptcp_addr_info *loc,
786 const struct mptcp_addr_info *rem);
787void mptcp_pm_subflow_chk_stale(const struct mptcp_sock *msk, struct sock *ssk);
788void mptcp_pm_nl_subflow_chk_stale(const struct mptcp_sock *msk, struct sock *ssk);
789void mptcp_pm_new_connection(struct mptcp_sock *msk, const struct sock *ssk, int server_side);
790void mptcp_pm_fully_established(struct mptcp_sock *msk, const struct sock *ssk, gfp_t gfp);
791bool mptcp_pm_allow_new_subflow(struct mptcp_sock *msk);
792void mptcp_pm_connection_closed(struct mptcp_sock *msk);
793void mptcp_pm_subflow_established(struct mptcp_sock *msk);
794bool mptcp_pm_nl_check_work_pending(struct mptcp_sock *msk);
795void mptcp_pm_subflow_check_next(struct mptcp_sock *msk, const struct sock *ssk,
796 const struct mptcp_subflow_context *subflow);
797void mptcp_pm_add_addr_received(const struct sock *ssk,
798 const struct mptcp_addr_info *addr);
799void mptcp_pm_add_addr_echoed(struct mptcp_sock *msk,
800 const struct mptcp_addr_info *addr);
801void mptcp_pm_add_addr_send_ack(struct mptcp_sock *msk);
802void mptcp_pm_nl_addr_send_ack(struct mptcp_sock *msk);
803void mptcp_pm_rm_addr_received(struct mptcp_sock *msk,
804 const struct mptcp_rm_list *rm_list);
805void mptcp_pm_mp_prio_received(struct sock *sk, u8 bkup);
806void mptcp_pm_mp_fail_received(struct sock *sk, u64 fail_seq);
807int mptcp_pm_nl_mp_prio_send_ack(struct mptcp_sock *msk,
808 struct mptcp_addr_info *addr,
809 struct mptcp_addr_info *rem,
810 u8 bkup);
811bool mptcp_pm_alloc_anno_list(struct mptcp_sock *msk,
812 const struct mptcp_pm_addr_entry *entry);
813void mptcp_pm_free_anno_list(struct mptcp_sock *msk);
814bool mptcp_pm_sport_in_anno_list(struct mptcp_sock *msk, const struct sock *sk);
815struct mptcp_pm_add_entry *
816mptcp_pm_del_add_timer(struct mptcp_sock *msk,
817 const struct mptcp_addr_info *addr, bool check_id);
818struct mptcp_pm_add_entry *
819mptcp_lookup_anno_list_by_saddr(const struct mptcp_sock *msk,
820 const struct mptcp_addr_info *addr);
821int mptcp_pm_get_flags_and_ifindex_by_id(struct mptcp_sock *msk,
822 unsigned int id,
823 u8 *flags, int *ifindex);
824int mptcp_userspace_pm_get_flags_and_ifindex_by_id(struct mptcp_sock *msk,
825 unsigned int id,
826 u8 *flags, int *ifindex);
827int mptcp_userspace_pm_set_flags(struct net *net, struct nlattr *token,
828 struct mptcp_pm_addr_entry *loc,
829 struct mptcp_pm_addr_entry *rem, u8 bkup);
830int mptcp_pm_announce_addr(struct mptcp_sock *msk,
831 const struct mptcp_addr_info *addr,
832 bool echo);
833int mptcp_pm_remove_addr(struct mptcp_sock *msk, const struct mptcp_rm_list *rm_list);
834int mptcp_pm_remove_subflow(struct mptcp_sock *msk, const struct mptcp_rm_list *rm_list);
835void mptcp_pm_remove_addrs_and_subflows(struct mptcp_sock *msk,
836 struct list_head *rm_list);
837
838int mptcp_userspace_pm_append_new_local_addr(struct mptcp_sock *msk,
839 struct mptcp_pm_addr_entry *entry);
840void mptcp_free_local_addr_list(struct mptcp_sock *msk);
841int mptcp_nl_cmd_announce(struct sk_buff *skb, struct genl_info *info);
842int mptcp_nl_cmd_remove(struct sk_buff *skb, struct genl_info *info);
843int mptcp_nl_cmd_sf_create(struct sk_buff *skb, struct genl_info *info);
844int mptcp_nl_cmd_sf_destroy(struct sk_buff *skb, struct genl_info *info);
845
846void mptcp_event(enum mptcp_event_type type, const struct mptcp_sock *msk,
847 const struct sock *ssk, gfp_t gfp);
848void mptcp_event_addr_announced(const struct sock *ssk, const struct mptcp_addr_info *info);
849void mptcp_event_addr_removed(const struct mptcp_sock *msk, u8 id);
850void mptcp_event_pm_listener(const struct sock *ssk,
851 enum mptcp_event_type event);
852bool mptcp_userspace_pm_active(const struct mptcp_sock *msk);
853
854void mptcp_fastopen_gen_msk_ackseq(struct mptcp_sock *msk, struct mptcp_subflow_context *subflow,
855 const struct mptcp_options_received *mp_opt);
856void mptcp_fastopen_subflow_synack_set_params(struct mptcp_subflow_context *subflow,
857 struct request_sock *req);
858
859static inline bool mptcp_pm_should_add_signal(struct mptcp_sock *msk)
860{
861 return READ_ONCE(msk->pm.addr_signal) &
862 (BIT(MPTCP_ADD_ADDR_SIGNAL) | BIT(MPTCP_ADD_ADDR_ECHO));
863}
864
865static inline bool mptcp_pm_should_add_signal_addr(struct mptcp_sock *msk)
866{
867 return READ_ONCE(msk->pm.addr_signal) & BIT(MPTCP_ADD_ADDR_SIGNAL);
868}
869
870static inline bool mptcp_pm_should_add_signal_echo(struct mptcp_sock *msk)
871{
872 return READ_ONCE(msk->pm.addr_signal) & BIT(MPTCP_ADD_ADDR_ECHO);
873}
874
875static inline bool mptcp_pm_should_rm_signal(struct mptcp_sock *msk)
876{
877 return READ_ONCE(msk->pm.addr_signal) & BIT(MPTCP_RM_ADDR_SIGNAL);
878}
879
880static inline bool mptcp_pm_is_userspace(const struct mptcp_sock *msk)
881{
882 return READ_ONCE(msk->pm.pm_type) == MPTCP_PM_TYPE_USERSPACE;
883}
884
885static inline bool mptcp_pm_is_kernel(const struct mptcp_sock *msk)
886{
887 return READ_ONCE(msk->pm.pm_type) == MPTCP_PM_TYPE_KERNEL;
888}
889
890static inline unsigned int mptcp_add_addr_len(int family, bool echo, bool port)
891{
892 u8 len = TCPOLEN_MPTCP_ADD_ADDR_BASE;
893
894 if (family == AF_INET6)
895 len = TCPOLEN_MPTCP_ADD_ADDR6_BASE;
896 if (!echo)
897 len += MPTCPOPT_THMAC_LEN;
898 /* account for 2 trailing 'nop' options */
899 if (port)
900 len += TCPOLEN_MPTCP_PORT_LEN + TCPOLEN_MPTCP_PORT_ALIGN;
901
902 return len;
903}
904
905static inline int mptcp_rm_addr_len(const struct mptcp_rm_list *rm_list)
906{
907 if (rm_list->nr == 0 || rm_list->nr > MPTCP_RM_IDS_MAX)
908 return -EINVAL;
909
910 return TCPOLEN_MPTCP_RM_ADDR_BASE + roundup(rm_list->nr - 1, 4) + 1;
911}
912
913bool mptcp_pm_add_addr_signal(struct mptcp_sock *msk, const struct sk_buff *skb,
914 unsigned int opt_size, unsigned int remaining,
915 struct mptcp_addr_info *addr, bool *echo,
916 bool *drop_other_suboptions);
917bool mptcp_pm_rm_addr_signal(struct mptcp_sock *msk, unsigned int remaining,
918 struct mptcp_rm_list *rm_list);
919int mptcp_pm_get_local_id(struct mptcp_sock *msk, struct sock_common *skc);
920int mptcp_userspace_pm_get_local_id(struct mptcp_sock *msk, struct mptcp_addr_info *skc);
921
922void __init mptcp_pm_nl_init(void);
923void mptcp_pm_nl_work(struct mptcp_sock *msk);
924void mptcp_pm_nl_rm_subflow_received(struct mptcp_sock *msk,
925 const struct mptcp_rm_list *rm_list);
926int mptcp_pm_nl_get_local_id(struct mptcp_sock *msk, struct sock_common *skc);
927unsigned int mptcp_pm_get_add_addr_signal_max(const struct mptcp_sock *msk);
928unsigned int mptcp_pm_get_add_addr_accept_max(const struct mptcp_sock *msk);
929unsigned int mptcp_pm_get_subflows_max(const struct mptcp_sock *msk);
930unsigned int mptcp_pm_get_local_addr_max(const struct mptcp_sock *msk);
931
932/* called under PM lock */
933static inline void __mptcp_pm_close_subflow(struct mptcp_sock *msk)
934{
935 if (--msk->pm.subflows < mptcp_pm_get_subflows_max(msk))
936 WRITE_ONCE(msk->pm.accept_subflow, true);
937}
938
939static inline void mptcp_pm_close_subflow(struct mptcp_sock *msk)
940{
941 spin_lock_bh(&msk->pm.lock);
942 __mptcp_pm_close_subflow(msk);
943 spin_unlock_bh(&msk->pm.lock);
944}
945
946void mptcp_sockopt_sync(struct mptcp_sock *msk, struct sock *ssk);
947void mptcp_sockopt_sync_locked(struct mptcp_sock *msk, struct sock *ssk);
948
949static inline struct mptcp_ext *mptcp_get_ext(const struct sk_buff *skb)
950{
951 return (struct mptcp_ext *)skb_ext_find(skb, SKB_EXT_MPTCP);
952}
953
954void mptcp_diag_subflow_init(struct tcp_ulp_ops *ops);
955
956static inline bool __mptcp_check_fallback(const struct mptcp_sock *msk)
957{
958 return test_bit(MPTCP_FALLBACK_DONE, &msk->flags);
959}
960
961static inline bool mptcp_check_fallback(const struct sock *sk)
962{
963 struct mptcp_subflow_context *subflow = mptcp_subflow_ctx(sk);
964 struct mptcp_sock *msk = mptcp_sk(subflow->conn);
965
966 return __mptcp_check_fallback(msk);
967}
968
969static inline void __mptcp_do_fallback(struct mptcp_sock *msk)
970{
971 if (test_bit(MPTCP_FALLBACK_DONE, &msk->flags)) {
972 pr_debug("TCP fallback already done (msk=%p)", msk);
973 return;
974 }
975 set_bit(MPTCP_FALLBACK_DONE, &msk->flags);
976}
977
978static inline void mptcp_do_fallback(struct sock *ssk)
979{
980 struct mptcp_subflow_context *subflow = mptcp_subflow_ctx(ssk);
981 struct sock *sk = subflow->conn;
982 struct mptcp_sock *msk;
983
984 msk = mptcp_sk(sk);
985 __mptcp_do_fallback(msk);
986 if (READ_ONCE(msk->snd_data_fin_enable) && !(ssk->sk_shutdown & SEND_SHUTDOWN)) {
987 gfp_t saved_allocation = ssk->sk_allocation;
988
989 /* we are in a atomic (BH) scope, override ssk default for data
990 * fin allocation
991 */
992 ssk->sk_allocation = GFP_ATOMIC;
993 ssk->sk_shutdown |= SEND_SHUTDOWN;
994 tcp_shutdown(ssk, SEND_SHUTDOWN);
995 ssk->sk_allocation = saved_allocation;
996 }
997}
998
999#define pr_fallback(a) pr_debug("%s:fallback to TCP (msk=%p)", __func__, a)
1000
1001static inline bool mptcp_check_infinite_map(struct sk_buff *skb)
1002{
1003 struct mptcp_ext *mpext;
1004
1005 mpext = skb ? mptcp_get_ext(skb) : NULL;
1006 if (mpext && mpext->infinite_map)
1007 return true;
1008
1009 return false;
1010}
1011
1012static inline bool is_active_ssk(struct mptcp_subflow_context *subflow)
1013{
1014 return (subflow->request_mptcp || subflow->request_join);
1015}
1016
1017static inline bool subflow_simultaneous_connect(struct sock *sk)
1018{
1019 struct mptcp_subflow_context *subflow = mptcp_subflow_ctx(sk);
1020
1021 return sk->sk_state == TCP_ESTABLISHED &&
1022 is_active_ssk(subflow) &&
1023 !subflow->conn_finished;
1024}
1025
1026#ifdef CONFIG_SYN_COOKIES
1027void subflow_init_req_cookie_join_save(const struct mptcp_subflow_request_sock *subflow_req,
1028 struct sk_buff *skb);
1029bool mptcp_token_join_cookie_init_state(struct mptcp_subflow_request_sock *subflow_req,
1030 struct sk_buff *skb);
1031void __init mptcp_join_cookie_init(void);
1032#else
1033static inline void
1034subflow_init_req_cookie_join_save(const struct mptcp_subflow_request_sock *subflow_req,
1035 struct sk_buff *skb) {}
1036static inline bool
1037mptcp_token_join_cookie_init_state(struct mptcp_subflow_request_sock *subflow_req,
1038 struct sk_buff *skb)
1039{
1040 return false;
1041}
1042
1043static inline void mptcp_join_cookie_init(void) {}
1044#endif
1045
1046#endif /* __MPTCP_PROTOCOL_H */