xref: /openbmc/linux/include/uapi/linux/mptcp.h (revision c0891ac1)
1 /* SPDX-License-Identifier: GPL-2.0+ WITH Linux-syscall-note */
2 #ifndef _UAPI_MPTCP_H
3 #define _UAPI_MPTCP_H
4 
5 #include <linux/const.h>
6 #include <linux/types.h>
7 
8 #define MPTCP_SUBFLOW_FLAG_MCAP_REM		_BITUL(0)
9 #define MPTCP_SUBFLOW_FLAG_MCAP_LOC		_BITUL(1)
10 #define MPTCP_SUBFLOW_FLAG_JOIN_REM		_BITUL(2)
11 #define MPTCP_SUBFLOW_FLAG_JOIN_LOC		_BITUL(3)
12 #define MPTCP_SUBFLOW_FLAG_BKUP_REM		_BITUL(4)
13 #define MPTCP_SUBFLOW_FLAG_BKUP_LOC		_BITUL(5)
14 #define MPTCP_SUBFLOW_FLAG_FULLY_ESTABLISHED	_BITUL(6)
15 #define MPTCP_SUBFLOW_FLAG_CONNECTED		_BITUL(7)
16 #define MPTCP_SUBFLOW_FLAG_MAPVALID		_BITUL(8)
17 
18 enum {
19 	MPTCP_SUBFLOW_ATTR_UNSPEC,
20 	MPTCP_SUBFLOW_ATTR_TOKEN_REM,
21 	MPTCP_SUBFLOW_ATTR_TOKEN_LOC,
22 	MPTCP_SUBFLOW_ATTR_RELWRITE_SEQ,
23 	MPTCP_SUBFLOW_ATTR_MAP_SEQ,
24 	MPTCP_SUBFLOW_ATTR_MAP_SFSEQ,
25 	MPTCP_SUBFLOW_ATTR_SSN_OFFSET,
26 	MPTCP_SUBFLOW_ATTR_MAP_DATALEN,
27 	MPTCP_SUBFLOW_ATTR_FLAGS,
28 	MPTCP_SUBFLOW_ATTR_ID_REM,
29 	MPTCP_SUBFLOW_ATTR_ID_LOC,
30 	MPTCP_SUBFLOW_ATTR_PAD,
31 	__MPTCP_SUBFLOW_ATTR_MAX
32 };
33 
34 #define MPTCP_SUBFLOW_ATTR_MAX (__MPTCP_SUBFLOW_ATTR_MAX - 1)
35 
36 /* netlink interface */
37 #define MPTCP_PM_NAME		"mptcp_pm"
38 #define MPTCP_PM_CMD_GRP_NAME	"mptcp_pm_cmds"
39 #define MPTCP_PM_EV_GRP_NAME	"mptcp_pm_events"
40 #define MPTCP_PM_VER		0x1
41 
42 /*
43  * ATTR types defined for MPTCP
44  */
45 enum {
46 	MPTCP_PM_ATTR_UNSPEC,
47 
48 	MPTCP_PM_ATTR_ADDR,				/* nested address */
49 	MPTCP_PM_ATTR_RCV_ADD_ADDRS,			/* u32 */
50 	MPTCP_PM_ATTR_SUBFLOWS,				/* u32 */
51 
52 	__MPTCP_PM_ATTR_MAX
53 };
54 
55 #define MPTCP_PM_ATTR_MAX (__MPTCP_PM_ATTR_MAX - 1)
56 
57 enum {
58 	MPTCP_PM_ADDR_ATTR_UNSPEC,
59 
60 	MPTCP_PM_ADDR_ATTR_FAMILY,			/* u16 */
61 	MPTCP_PM_ADDR_ATTR_ID,				/* u8 */
62 	MPTCP_PM_ADDR_ATTR_ADDR4,			/* struct in_addr */
63 	MPTCP_PM_ADDR_ATTR_ADDR6,			/* struct in6_addr */
64 	MPTCP_PM_ADDR_ATTR_PORT,			/* u16 */
65 	MPTCP_PM_ADDR_ATTR_FLAGS,			/* u32 */
66 	MPTCP_PM_ADDR_ATTR_IF_IDX,			/* s32 */
67 
68 	__MPTCP_PM_ADDR_ATTR_MAX
69 };
70 
71 #define MPTCP_PM_ADDR_ATTR_MAX (__MPTCP_PM_ADDR_ATTR_MAX - 1)
72 
73 #define MPTCP_PM_ADDR_FLAG_SIGNAL			(1 << 0)
74 #define MPTCP_PM_ADDR_FLAG_SUBFLOW			(1 << 1)
75 #define MPTCP_PM_ADDR_FLAG_BACKUP			(1 << 2)
76 
77 enum {
78 	MPTCP_PM_CMD_UNSPEC,
79 
80 	MPTCP_PM_CMD_ADD_ADDR,
81 	MPTCP_PM_CMD_DEL_ADDR,
82 	MPTCP_PM_CMD_GET_ADDR,
83 	MPTCP_PM_CMD_FLUSH_ADDRS,
84 	MPTCP_PM_CMD_SET_LIMITS,
85 	MPTCP_PM_CMD_GET_LIMITS,
86 	MPTCP_PM_CMD_SET_FLAGS,
87 
88 	__MPTCP_PM_CMD_AFTER_LAST
89 };
90 
91 #define MPTCP_INFO_FLAG_FALLBACK		_BITUL(0)
92 #define MPTCP_INFO_FLAG_REMOTE_KEY_RECEIVED	_BITUL(1)
93 
94 struct mptcp_info {
95 	__u8	mptcpi_subflows;
96 	__u8	mptcpi_add_addr_signal;
97 	__u8	mptcpi_add_addr_accepted;
98 	__u8	mptcpi_subflows_max;
99 	__u8	mptcpi_add_addr_signal_max;
100 	__u8	mptcpi_add_addr_accepted_max;
101 	__u32	mptcpi_flags;
102 	__u32	mptcpi_token;
103 	__u64	mptcpi_write_seq;
104 	__u64	mptcpi_snd_una;
105 	__u64	mptcpi_rcv_nxt;
106 	__u8	mptcpi_local_addr_used;
107 	__u8	mptcpi_local_addr_max;
108 	__u8	mptcpi_csum_enabled;
109 };
110 
111 /*
112  * MPTCP_EVENT_CREATED: token, family, saddr4 | saddr6, daddr4 | daddr6,
113  *                      sport, dport
114  * A new MPTCP connection has been created. It is the good time to allocate
115  * memory and send ADD_ADDR if needed. Depending on the traffic-patterns
116  * it can take a long time until the MPTCP_EVENT_ESTABLISHED is sent.
117  *
118  * MPTCP_EVENT_ESTABLISHED: token, family, saddr4 | saddr6, daddr4 | daddr6,
119  *			    sport, dport
120  * A MPTCP connection is established (can start new subflows).
121  *
122  * MPTCP_EVENT_CLOSED: token
123  * A MPTCP connection has stopped.
124  *
125  * MPTCP_EVENT_ANNOUNCED: token, rem_id, family, daddr4 | daddr6 [, dport]
126  * A new address has been announced by the peer.
127  *
128  * MPTCP_EVENT_REMOVED: token, rem_id
129  * An address has been lost by the peer.
130  *
131  * MPTCP_EVENT_SUB_ESTABLISHED: token, family, saddr4 | saddr6,
132  *                              daddr4 | daddr6, sport, dport, backup,
133  *                              if_idx [, error]
134  * A new subflow has been established. 'error' should not be set.
135  *
136  * MPTCP_EVENT_SUB_CLOSED: token, family, saddr4 | saddr6, daddr4 | daddr6,
137  *                         sport, dport, backup, if_idx [, error]
138  * A subflow has been closed. An error (copy of sk_err) could be set if an
139  * error has been detected for this subflow.
140  *
141  * MPTCP_EVENT_SUB_PRIORITY: token, family, saddr4 | saddr6, daddr4 | daddr6,
142  *                           sport, dport, backup, if_idx [, error]
143  *       The priority of a subflow has changed. 'error' should not be set.
144  */
145 enum mptcp_event_type {
146 	MPTCP_EVENT_UNSPEC = 0,
147 	MPTCP_EVENT_CREATED = 1,
148 	MPTCP_EVENT_ESTABLISHED = 2,
149 	MPTCP_EVENT_CLOSED = 3,
150 
151 	MPTCP_EVENT_ANNOUNCED = 6,
152 	MPTCP_EVENT_REMOVED = 7,
153 
154 	MPTCP_EVENT_SUB_ESTABLISHED = 10,
155 	MPTCP_EVENT_SUB_CLOSED = 11,
156 
157 	MPTCP_EVENT_SUB_PRIORITY = 13,
158 };
159 
160 enum mptcp_event_attr {
161 	MPTCP_ATTR_UNSPEC = 0,
162 
163 	MPTCP_ATTR_TOKEN,	/* u32 */
164 	MPTCP_ATTR_FAMILY,	/* u16 */
165 	MPTCP_ATTR_LOC_ID,	/* u8 */
166 	MPTCP_ATTR_REM_ID,	/* u8 */
167 	MPTCP_ATTR_SADDR4,	/* be32 */
168 	MPTCP_ATTR_SADDR6,	/* struct in6_addr */
169 	MPTCP_ATTR_DADDR4,	/* be32 */
170 	MPTCP_ATTR_DADDR6,	/* struct in6_addr */
171 	MPTCP_ATTR_SPORT,	/* be16 */
172 	MPTCP_ATTR_DPORT,	/* be16 */
173 	MPTCP_ATTR_BACKUP,	/* u8 */
174 	MPTCP_ATTR_ERROR,	/* u8 */
175 	MPTCP_ATTR_FLAGS,	/* u16 */
176 	MPTCP_ATTR_TIMEOUT,	/* u32 */
177 	MPTCP_ATTR_IF_IDX,	/* s32 */
178 	MPTCP_ATTR_RESET_REASON,/* u32 */
179 	MPTCP_ATTR_RESET_FLAGS, /* u32 */
180 
181 	__MPTCP_ATTR_AFTER_LAST
182 };
183 
184 #define MPTCP_ATTR_MAX (__MPTCP_ATTR_AFTER_LAST - 1)
185 
186 /* MPTCP Reset reason codes, rfc8684 */
187 #define MPTCP_RST_EUNSPEC	0
188 #define MPTCP_RST_EMPTCP	1
189 #define MPTCP_RST_ERESOURCE	2
190 #define MPTCP_RST_EPROHIBIT	3
191 #define MPTCP_RST_EWQ2BIG	4
192 #define MPTCP_RST_EBADPERF	5
193 #define MPTCP_RST_EMIDDLEBOX	6
194 
195 #endif /* _UAPI_MPTCP_H */
196