xref: /aosp_15_r20/external/curl/docs/cmdline-opts/mptcp.md (revision 6236dae45794135f37c4eb022389c904c8b0090d)
1*6236dae4SAndroid Build Coastguard Worker---
2*6236dae4SAndroid Build Coastguard Workerc: Copyright (C) Dorian Craps, <[email protected]>
3*6236dae4SAndroid Build Coastguard WorkerSPDX-License-Identifier: curl
4*6236dae4SAndroid Build Coastguard WorkerLong: mptcp
5*6236dae4SAndroid Build Coastguard WorkerAdded: 8.9.0
6*6236dae4SAndroid Build Coastguard WorkerHelp: Enable Multipath TCP
7*6236dae4SAndroid Build Coastguard WorkerCategory: connection
8*6236dae4SAndroid Build Coastguard WorkerMulti: boolean
9*6236dae4SAndroid Build Coastguard WorkerSee-also:
10*6236dae4SAndroid Build Coastguard Worker  - tcp-fastopen
11*6236dae4SAndroid Build Coastguard WorkerExample:
12*6236dae4SAndroid Build Coastguard Worker  - --mptcp $URL
13*6236dae4SAndroid Build Coastguard Worker---
14*6236dae4SAndroid Build Coastguard Worker
15*6236dae4SAndroid Build Coastguard Worker# `--mptcp`
16*6236dae4SAndroid Build Coastguard Worker
17*6236dae4SAndroid Build Coastguard WorkerEnables the use of Multipath TCP (MPTCP) for connections. MPTCP is an extension
18*6236dae4SAndroid Build Coastguard Workerto the standard TCP that allows multiple TCP streams over different network
19*6236dae4SAndroid Build Coastguard Workerpaths between the same source and destination. This can enhance bandwidth and
20*6236dae4SAndroid Build Coastguard Workerimprove reliability by using multiple paths simultaneously.
21*6236dae4SAndroid Build Coastguard Worker
22*6236dae4SAndroid Build Coastguard WorkerMPTCP is beneficial in networks where multiple paths exist between clients and
23*6236dae4SAndroid Build Coastguard Workerservers, such as mobile networks where a device may switch between WiFi and
24*6236dae4SAndroid Build Coastguard Workercellular data or in wired networks with multiple Internet Service Providers.
25*6236dae4SAndroid Build Coastguard Worker
26*6236dae4SAndroid Build Coastguard WorkerThis option is currently only supported on Linux starting from kernel 5.6. Only
27*6236dae4SAndroid Build Coastguard WorkerTCP connections are modified, hence this option does not effect HTTP/3 (QUIC)
28*6236dae4SAndroid Build Coastguard Workeror UDP connections.
29*6236dae4SAndroid Build Coastguard Worker
30*6236dae4SAndroid Build Coastguard WorkerThe server curl connects to must also support MPTCP. If not, the connection
31*6236dae4SAndroid Build Coastguard Workerseamlessly falls back to TCP.
32