1 // SPDX-License-Identifier: GPL-2.0
4 * Copyright (c) 2017 - 2019, Intel Corporation.
7 #include <linux/kernel.h>
12 static bool mptcp_cap_flag_sha256(u8 flags)
14 return (flags & MPTCP_CAP_FLAG_MASK) == MPTCP_CAP_HMAC_SHA256;
17 void mptcp_parse_option(const struct sk_buff *skb, const unsigned char *ptr,
18 int opsize, struct tcp_options_received *opt_rx)
20 struct mptcp_options_received *mp_opt = &opt_rx->mptcp;
21 u8 subtype = *ptr >> 4;
27 case MPTCPOPT_MP_CAPABLE:
28 /* strict size checking */
29 if (!(TCP_SKB_CB(skb)->tcp_flags & TCPHDR_SYN)) {
30 if (skb->len > tcp_hdr(skb)->doff << 2)
31 expected_opsize = TCPOLEN_MPTCP_MPC_ACK_DATA;
33 expected_opsize = TCPOLEN_MPTCP_MPC_ACK;
35 if (TCP_SKB_CB(skb)->tcp_flags & TCPHDR_ACK)
36 expected_opsize = TCPOLEN_MPTCP_MPC_SYNACK;
38 expected_opsize = TCPOLEN_MPTCP_MPC_SYN;
40 if (opsize != expected_opsize)
43 /* try to be gentle vs future versions on the initial syn */
44 version = *ptr++ & MPTCP_VERSION_MASK;
45 if (opsize != TCPOLEN_MPTCP_MPC_SYN) {
46 if (version != MPTCP_SUPPORTED_VERSION)
48 } else if (version < MPTCP_SUPPORTED_VERSION) {
53 if (!mptcp_cap_flag_sha256(flags) ||
54 (flags & MPTCP_CAP_EXTENSIBILITY))
57 /* RFC 6824, Section 3.1:
58 * "For the Checksum Required bit (labeled "A"), if either
59 * host requires the use of checksums, checksums MUST be used.
60 * In other words, the only way for checksums not to be used
61 * is if both hosts in their SYNs set A=0."
64 * "If a checksum is not present when its use has been
65 * negotiated, the receiver MUST close the subflow with a RST as
66 * it is considered broken."
68 * We don't implement DSS checksum - fall back to TCP.
70 if (flags & MPTCP_CAP_CHECKSUM_REQD)
73 mp_opt->mp_capable = 1;
74 if (opsize >= TCPOLEN_MPTCP_MPC_SYNACK) {
75 mp_opt->sndr_key = get_unaligned_be64(ptr);
78 if (opsize >= TCPOLEN_MPTCP_MPC_ACK) {
79 mp_opt->rcvr_key = get_unaligned_be64(ptr);
82 if (opsize == TCPOLEN_MPTCP_MPC_ACK_DATA) {
84 * "the data parameters in a MP_CAPABLE are semantically
85 * equivalent to those in a DSS option and can be used
91 mp_opt->data_len = get_unaligned_be16(ptr);
94 pr_debug("MP_CAPABLE version=%x, flags=%x, optlen=%d sndr=%llu, rcvr=%llu len=%d",
95 version, flags, opsize, mp_opt->sndr_key,
96 mp_opt->rcvr_key, mp_opt->data_len);
103 /* we must clear 'mpc_map' be able to detect MP_CAPABLE
104 * map vs DSS map in mptcp_incoming_options(), and reconstruct
105 * map info accordingly
108 flags = (*ptr++) & MPTCP_DSS_FLAG_MASK;
109 mp_opt->data_fin = (flags & MPTCP_DSS_DATA_FIN) != 0;
110 mp_opt->dsn64 = (flags & MPTCP_DSS_DSN64) != 0;
111 mp_opt->use_map = (flags & MPTCP_DSS_HAS_MAP) != 0;
112 mp_opt->ack64 = (flags & MPTCP_DSS_ACK64) != 0;
113 mp_opt->use_ack = (flags & MPTCP_DSS_HAS_ACK);
115 pr_debug("data_fin=%d dsn64=%d use_map=%d ack64=%d use_ack=%d",
116 mp_opt->data_fin, mp_opt->dsn64,
117 mp_opt->use_map, mp_opt->ack64,
120 expected_opsize = TCPOLEN_MPTCP_DSS_BASE;
122 if (mp_opt->use_ack) {
124 expected_opsize += TCPOLEN_MPTCP_DSS_ACK64;
126 expected_opsize += TCPOLEN_MPTCP_DSS_ACK32;
129 if (mp_opt->use_map) {
131 expected_opsize += TCPOLEN_MPTCP_DSS_MAP64;
133 expected_opsize += TCPOLEN_MPTCP_DSS_MAP32;
136 /* RFC 6824, Section 3.3:
137 * If a checksum is present, but its use had
138 * not been negotiated in the MP_CAPABLE handshake,
139 * the checksum field MUST be ignored.
141 if (opsize != expected_opsize &&
142 opsize != expected_opsize + TCPOLEN_MPTCP_DSS_CHECKSUM)
147 if (mp_opt->use_ack) {
149 mp_opt->data_ack = get_unaligned_be64(ptr);
152 mp_opt->data_ack = get_unaligned_be32(ptr);
156 pr_debug("data_ack=%llu", mp_opt->data_ack);
159 if (mp_opt->use_map) {
161 mp_opt->data_seq = get_unaligned_be64(ptr);
164 mp_opt->data_seq = get_unaligned_be32(ptr);
168 mp_opt->subflow_seq = get_unaligned_be32(ptr);
171 mp_opt->data_len = get_unaligned_be16(ptr);
174 pr_debug("data_seq=%llu subflow_seq=%u data_len=%u",
175 mp_opt->data_seq, mp_opt->subflow_seq,
186 void mptcp_get_options(const struct sk_buff *skb,
187 struct tcp_options_received *opt_rx)
189 const unsigned char *ptr;
190 const struct tcphdr *th = tcp_hdr(skb);
191 int length = (th->doff * 4) - sizeof(struct tcphdr);
193 ptr = (const unsigned char *)(th + 1);
202 case TCPOPT_NOP: /* Ref: RFC 793 section 3.1 */
207 if (opsize < 2) /* "silly options" */
210 return; /* don't parse partial options */
211 if (opcode == TCPOPT_MPTCP)
212 mptcp_parse_option(skb, ptr, opsize, opt_rx);
219 bool mptcp_syn_options(struct sock *sk, const struct sk_buff *skb,
220 unsigned int *size, struct mptcp_out_options *opts)
222 struct mptcp_subflow_context *subflow = mptcp_subflow_ctx(sk);
224 /* we will use snd_isn to detect first pkt [re]transmission
225 * in mptcp_established_options_mp()
227 subflow->snd_isn = TCP_SKB_CB(skb)->end_seq;
228 if (subflow->request_mptcp) {
229 pr_debug("local_key=%llu", subflow->local_key);
230 opts->suboptions = OPTION_MPTCP_MPC_SYN;
231 opts->sndr_key = subflow->local_key;
232 *size = TCPOLEN_MPTCP_MPC_SYN;
238 void mptcp_rcv_synsent(struct sock *sk)
240 struct mptcp_subflow_context *subflow = mptcp_subflow_ctx(sk);
241 struct tcp_sock *tp = tcp_sk(sk);
243 pr_debug("subflow=%p", subflow);
244 if (subflow->request_mptcp && tp->rx_opt.mptcp.mp_capable) {
245 subflow->mp_capable = 1;
246 subflow->can_ack = 1;
247 subflow->remote_key = tp->rx_opt.mptcp.sndr_key;
249 tcp_sk(sk)->is_mptcp = 0;
253 static bool mptcp_established_options_mp(struct sock *sk, struct sk_buff *skb,
255 unsigned int remaining,
256 struct mptcp_out_options *opts)
258 struct mptcp_subflow_context *subflow = mptcp_subflow_ctx(sk);
259 struct mptcp_ext *mpext;
260 unsigned int data_len;
262 pr_debug("subflow=%p fourth_ack=%d seq=%x:%x remaining=%d", subflow,
263 subflow->fourth_ack, subflow->snd_isn,
264 skb ? TCP_SKB_CB(skb)->seq : 0, remaining);
266 if (subflow->mp_capable && !subflow->fourth_ack && skb &&
267 subflow->snd_isn == TCP_SKB_CB(skb)->seq) {
268 /* When skb is not available, we better over-estimate the
269 * emitted options len. A full DSS option is longer than
270 * TCPOLEN_MPTCP_MPC_ACK_DATA, so let's the caller try to fit
273 mpext = mptcp_get_ext(skb);
274 data_len = mpext ? mpext->data_len : 0;
276 /* we will check ext_copy.data_len in mptcp_write_options() to
277 * discriminate between TCPOLEN_MPTCP_MPC_ACK_DATA and
278 * TCPOLEN_MPTCP_MPC_ACK
280 opts->ext_copy.data_len = data_len;
281 opts->suboptions = OPTION_MPTCP_MPC_ACK;
282 opts->sndr_key = subflow->local_key;
283 opts->rcvr_key = subflow->remote_key;
286 * The MP_CAPABLE option is carried on the SYN, SYN/ACK, and ACK
287 * packets that start the first subflow of an MPTCP connection,
288 * as well as the first packet that carries data
291 *size = ALIGN(TCPOLEN_MPTCP_MPC_ACK_DATA, 4);
293 *size = TCPOLEN_MPTCP_MPC_ACK;
295 pr_debug("subflow=%p, local_key=%llu, remote_key=%llu map_len=%d",
296 subflow, subflow->local_key, subflow->remote_key,
304 static void mptcp_write_data_fin(struct mptcp_subflow_context *subflow,
305 struct mptcp_ext *ext)
310 /* RFC6824 requires a DSS mapping with specific values
311 * if DATA_FIN is set but no data payload is mapped
315 ext->data_seq = mptcp_sk(subflow->conn)->write_seq;
316 ext->subflow_seq = 0;
319 /* If there's an existing DSS mapping, DATA_FIN consumes
320 * 1 additional byte of mapping space.
326 static bool mptcp_established_options_dss(struct sock *sk, struct sk_buff *skb,
328 unsigned int remaining,
329 struct mptcp_out_options *opts)
331 struct mptcp_subflow_context *subflow = mptcp_subflow_ctx(sk);
332 unsigned int dss_size = 0;
333 struct mptcp_ext *mpext;
334 struct mptcp_sock *msk;
335 unsigned int ack_size;
340 mpext = mptcp_get_ext(skb);
341 tcp_fin = TCP_SKB_CB(skb)->tcp_flags & TCPHDR_FIN;
347 if (!skb || (mpext && mpext->use_map) || tcp_fin) {
348 unsigned int map_size;
350 map_size = TCPOLEN_MPTCP_DSS_BASE + TCPOLEN_MPTCP_DSS_MAP64;
352 remaining -= map_size;
355 opts->ext_copy = *mpext;
357 if (skb && tcp_fin &&
358 subflow->conn->sk_state != TCP_ESTABLISHED)
359 mptcp_write_data_fin(subflow, &opts->ext_copy);
363 opts->ext_copy.use_ack = 0;
364 msk = mptcp_sk(subflow->conn);
365 if (!msk || !READ_ONCE(msk->can_ack)) {
366 *size = ALIGN(dss_size, 4);
370 ack_size = TCPOLEN_MPTCP_DSS_ACK64;
372 /* Add kind/length/subtype/flag overhead if mapping is not populated */
374 ack_size += TCPOLEN_MPTCP_DSS_BASE;
376 dss_size += ack_size;
378 opts->ext_copy.data_ack = msk->ack_seq;
379 opts->ext_copy.ack64 = 1;
380 opts->ext_copy.use_ack = 1;
382 *size = ALIGN(dss_size, 4);
386 bool mptcp_established_options(struct sock *sk, struct sk_buff *skb,
387 unsigned int *size, unsigned int remaining,
388 struct mptcp_out_options *opts)
390 unsigned int opt_size = 0;
393 if (mptcp_established_options_mp(sk, skb, &opt_size, remaining, opts))
395 else if (mptcp_established_options_dss(sk, skb, &opt_size, remaining,
399 /* we reserved enough space for the above options, and exceeding the
400 * TCP option space would be fatal
402 if (WARN_ON_ONCE(opt_size > remaining))
406 remaining -= opt_size;
411 bool mptcp_synack_options(const struct request_sock *req, unsigned int *size,
412 struct mptcp_out_options *opts)
414 struct mptcp_subflow_request_sock *subflow_req = mptcp_subflow_rsk(req);
416 if (subflow_req->mp_capable) {
417 opts->suboptions = OPTION_MPTCP_MPC_SYNACK;
418 opts->sndr_key = subflow_req->local_key;
419 *size = TCPOLEN_MPTCP_MPC_SYNACK;
420 pr_debug("subflow_req=%p, local_key=%llu",
421 subflow_req, subflow_req->local_key);
427 static bool check_fourth_ack(struct mptcp_subflow_context *subflow,
429 struct mptcp_options_received *mp_opt)
431 /* here we can process OoO, in-window pkts, only in-sequence 4th ack
434 if (likely(subflow->fourth_ack ||
435 TCP_SKB_CB(skb)->seq != subflow->ssn_offset + 1))
439 subflow->fourth_ack = 1;
441 if (subflow->can_ack)
444 /* If the first established packet does not contain MP_CAPABLE + data
445 * then fallback to TCP
447 if (!mp_opt->mp_capable) {
448 subflow->mp_capable = 0;
449 tcp_sk(mptcp_subflow_tcp_sock(subflow))->is_mptcp = 0;
452 subflow->remote_key = mp_opt->sndr_key;
453 subflow->can_ack = 1;
457 void mptcp_incoming_options(struct sock *sk, struct sk_buff *skb,
458 struct tcp_options_received *opt_rx)
460 struct mptcp_subflow_context *subflow = mptcp_subflow_ctx(sk);
461 struct mptcp_options_received *mp_opt;
462 struct mptcp_ext *mpext;
464 mp_opt = &opt_rx->mptcp;
465 if (!check_fourth_ack(subflow, skb, mp_opt))
471 mpext = skb_ext_add(skb, SKB_EXT_MPTCP);
475 memset(mpext, 0, sizeof(*mpext));
477 if (mp_opt->use_map) {
478 if (mp_opt->mpc_map) {
479 /* this is an MP_CAPABLE carrying MPTCP data
480 * we know this map the first chunk of data
482 mptcp_crypto_key_sha(subflow->remote_key, NULL,
485 mpext->subflow_seq = 1;
489 mpext->data_seq = mp_opt->data_seq;
490 mpext->subflow_seq = mp_opt->subflow_seq;
491 mpext->dsn64 = mp_opt->dsn64;
493 mpext->data_len = mp_opt->data_len;
497 if (mp_opt->use_ack) {
498 mpext->data_ack = mp_opt->data_ack;
500 mpext->ack64 = mp_opt->ack64;
503 mpext->data_fin = mp_opt->data_fin;
506 void mptcp_write_options(__be32 *ptr, struct mptcp_out_options *opts)
508 if ((OPTION_MPTCP_MPC_SYN | OPTION_MPTCP_MPC_SYNACK |
509 OPTION_MPTCP_MPC_ACK) & opts->suboptions) {
512 if (OPTION_MPTCP_MPC_SYN & opts->suboptions)
513 len = TCPOLEN_MPTCP_MPC_SYN;
514 else if (OPTION_MPTCP_MPC_SYNACK & opts->suboptions)
515 len = TCPOLEN_MPTCP_MPC_SYNACK;
516 else if (opts->ext_copy.data_len)
517 len = TCPOLEN_MPTCP_MPC_ACK_DATA;
519 len = TCPOLEN_MPTCP_MPC_ACK;
521 *ptr++ = htonl((TCPOPT_MPTCP << 24) | (len << 16) |
522 (MPTCPOPT_MP_CAPABLE << 12) |
523 (MPTCP_SUPPORTED_VERSION << 8) |
524 MPTCP_CAP_HMAC_SHA256);
526 if (!((OPTION_MPTCP_MPC_SYNACK | OPTION_MPTCP_MPC_ACK) &
528 goto mp_capable_done;
530 put_unaligned_be64(opts->sndr_key, ptr);
532 if (!((OPTION_MPTCP_MPC_ACK) & opts->suboptions))
533 goto mp_capable_done;
535 put_unaligned_be64(opts->rcvr_key, ptr);
537 if (!opts->ext_copy.data_len)
538 goto mp_capable_done;
540 put_unaligned_be32(opts->ext_copy.data_len << 16 |
541 TCPOPT_NOP << 8 | TCPOPT_NOP, ptr);
546 if (opts->ext_copy.use_ack || opts->ext_copy.use_map) {
547 struct mptcp_ext *mpext = &opts->ext_copy;
548 u8 len = TCPOLEN_MPTCP_DSS_BASE;
551 if (mpext->use_ack) {
552 len += TCPOLEN_MPTCP_DSS_ACK64;
553 flags = MPTCP_DSS_HAS_ACK | MPTCP_DSS_ACK64;
556 if (mpext->use_map) {
557 len += TCPOLEN_MPTCP_DSS_MAP64;
559 /* Use only 64-bit mapping flags for now, add
560 * support for optional 32-bit mappings later.
562 flags |= MPTCP_DSS_HAS_MAP | MPTCP_DSS_DSN64;
564 flags |= MPTCP_DSS_DATA_FIN;
567 *ptr++ = htonl((TCPOPT_MPTCP << 24) |
569 (MPTCPOPT_DSS << 12) |
572 if (mpext->use_ack) {
573 put_unaligned_be64(mpext->data_ack, ptr);
577 if (mpext->use_map) {
578 put_unaligned_be64(mpext->data_seq, ptr);
580 put_unaligned_be32(mpext->subflow_seq, ptr);
582 put_unaligned_be32(mpext->data_len << 16 |
583 TCPOPT_NOP << 8 | TCPOPT_NOP, ptr);