• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1.. SPDX-License-Identifier: GPL-2.0
2
3=====================
4MPTCP Sysfs variables
5=====================
6
7/proc/sys/net/mptcp/* Variables
8===============================
9
10add_addr_timeout - INTEGER (seconds)
11	Set the timeout after which an ADD_ADDR control message will be
12	resent to an MPTCP peer that has not acknowledged a previous
13	ADD_ADDR message.
14
15	Do not retransmit if set to 0.
16
17	The default value matches TCP_RTO_MAX. This is a per-namespace
18	sysctl.
19
20	Default: 120
21
22allow_join_initial_addr_port - BOOLEAN
23	Allow peers to send join requests to the IP address and port number used
24	by the initial subflow if the value is 1. This controls a flag that is
25	sent to the peer at connection time, and whether such join requests are
26	accepted or denied.
27
28	Joins to addresses advertised with ADD_ADDR are not affected by this
29	value.
30
31	This is a per-namespace sysctl.
32
33	Default: 1
34
35available_schedulers - STRING
36	Shows the available schedulers choices that are registered. More packet
37	schedulers may be available, but not loaded.
38
39blackhole_timeout - INTEGER (seconds)
40	Initial time period in second to disable MPTCP on active MPTCP sockets
41	when a MPTCP firewall blackhole issue happens. This time period will
42	grow exponentially when more blackhole issues get detected right after
43	MPTCP is re-enabled and will reset to the initial value when the
44	blackhole issue goes away.
45
46	0 to disable the blackhole detection.
47
48	Default: 3600
49
50checksum_enabled - BOOLEAN
51	Control whether DSS checksum can be enabled.
52
53	DSS checksum can be enabled if the value is nonzero. This is a
54	per-namespace sysctl.
55
56	Default: 0
57
58close_timeout - INTEGER (seconds)
59	Set the make-after-break timeout: in absence of any close or
60	shutdown syscall, MPTCP sockets will maintain the status
61	unchanged for such time, after the last subflow removal, before
62	moving to TCP_CLOSE.
63
64	The default value matches TCP_TIMEWAIT_LEN. This is a per-namespace
65	sysctl.
66
67	Default: 60
68
69enabled - BOOLEAN
70	Control whether MPTCP sockets can be created.
71
72	MPTCP sockets can be created if the value is 1. This is a
73	per-namespace sysctl.
74
75	Default: 1 (enabled)
76
77pm_type - INTEGER
78	Set the default path manager type to use for each new MPTCP
79	socket. In-kernel path management will control subflow
80	connections and address advertisements according to
81	per-namespace values configured over the MPTCP netlink
82	API. Userspace path management puts per-MPTCP-connection subflow
83	connection decisions and address advertisements under control of
84	a privileged userspace program, at the cost of more netlink
85	traffic to propagate all of the related events and commands.
86
87	This is a per-namespace sysctl.
88
89	* 0 - In-kernel path manager
90	* 1 - Userspace path manager
91
92	Default: 0
93
94scheduler - STRING
95	Select the scheduler of your choice.
96
97	Support for selection of different schedulers. This is a per-namespace
98	sysctl.
99
100	Default: "default"
101
102stale_loss_cnt - INTEGER
103	The number of MPTCP-level retransmission intervals with no traffic and
104	pending outstanding data on a given subflow required to declare it stale.
105	The packet scheduler ignores stale subflows.
106	A low stale_loss_cnt  value allows for fast active-backup switch-over,
107	an high value maximize links utilization on edge scenarios e.g. lossy
108	link with high BER or peer pausing the data processing.
109
110	This is a per-namespace sysctl.
111
112	Default: 4
113