mirror of
https://git.kernel.org/pub/scm/linux/kernel/git/stable/linux.git
synced 2026-03-08 18:26:12 +01:00
2293c57484
During the connection establishment, a peer can tell the other one that
it cannot establish new subflows to the initial IP address and port by
setting the 'C' flag [1]. Doing so makes sense when the sender is behind
a strict NAT, operating behind a legacy Layer 4 load balancer, or using
anycast IP address for example.
When this 'C' flag is set, the path-managers must then not try to
establish new subflows to the other peer's initial IP address and port.
The in-kernel PM has access to this info, but the userspace PM didn't.
The RFC8684 [1] is strict about that:
(...) therefore the receiver MUST NOT try to open any additional
subflows toward this address and port.
So it is important to tell the userspace about that as it is responsible
for the respect of this flag.
When a new connection is created and established, the Netlink events
now contain the existing but not currently used 'flags' attribute. When
MPTCP_PM_EV_FLAG_DENY_JOIN_ID0 is set, it means no other subflows
to the initial IP address and port -- info that are also part of the
event -- can be established.
Link: https://datatracker.ietf.org/doc/html/rfc8684#section-3.1-20.6 [1]
Fixes: 702c2f646d ("mptcp: netlink: allow userspace-driven subflow establishment")
Reported-by: Marek Majkowski <marek@cloudflare.com>
Closes: https://github.com/multipath-tcp/mptcp_net-next/issues/532
Reviewed-by: Mat Martineau <martineau@kernel.org>
Signed-off-by: Matthieu Baerts (NGI0) <matttbe@kernel.org>
Link: https://patch.msgid.link/20250912-net-mptcp-pm-uspace-deny_join_id0-v1-2-40171884ade8@kernel.org
Signed-off-by: Jakub Kicinski <kuba@kernel.org>
153 lines
4.5 KiB
C
153 lines
4.5 KiB
C
/* SPDX-License-Identifier: ((GPL-2.0 WITH Linux-syscall-note) OR BSD-3-Clause) */
|
|
/* Do not edit directly, auto-generated from: */
|
|
/* Documentation/netlink/specs/mptcp_pm.yaml */
|
|
/* YNL-GEN uapi header */
|
|
|
|
#ifndef _UAPI_LINUX_MPTCP_PM_H
|
|
#define _UAPI_LINUX_MPTCP_PM_H
|
|
|
|
#define MPTCP_PM_NAME "mptcp_pm"
|
|
#define MPTCP_PM_VER 1
|
|
|
|
/**
|
|
* enum mptcp_event_type
|
|
* @MPTCP_EVENT_UNSPEC: unused event
|
|
* @MPTCP_EVENT_CREATED: A new MPTCP connection has been created. It is the
|
|
* good time to allocate memory and send ADD_ADDR if needed. Depending on the
|
|
* traffic-patterns it can take a long time until the MPTCP_EVENT_ESTABLISHED
|
|
* is sent. Attributes: token, family, saddr4 | saddr6, daddr4 | daddr6,
|
|
* sport, dport, server-side, [flags].
|
|
* @MPTCP_EVENT_ESTABLISHED: A MPTCP connection is established (can start new
|
|
* subflows). Attributes: token, family, saddr4 | saddr6, daddr4 | daddr6,
|
|
* sport, dport, server-side, [flags].
|
|
* @MPTCP_EVENT_CLOSED: A MPTCP connection has stopped. Attribute: token.
|
|
* @MPTCP_EVENT_ANNOUNCED: A new address has been announced by the peer.
|
|
* Attributes: token, rem_id, family, daddr4 | daddr6 [, dport].
|
|
* @MPTCP_EVENT_REMOVED: An address has been lost by the peer. Attributes:
|
|
* token, rem_id.
|
|
* @MPTCP_EVENT_SUB_ESTABLISHED: A new subflow has been established. 'error'
|
|
* should not be set. Attributes: token, family, loc_id, rem_id, saddr4 |
|
|
* saddr6, daddr4 | daddr6, sport, dport, backup, if-idx [, error].
|
|
* @MPTCP_EVENT_SUB_CLOSED: A subflow has been closed. An error (copy of
|
|
* sk_err) could be set if an error has been detected for this subflow.
|
|
* Attributes: token, family, loc_id, rem_id, saddr4 | saddr6, daddr4 |
|
|
* daddr6, sport, dport, backup, if-idx [, error].
|
|
* @MPTCP_EVENT_SUB_PRIORITY: The priority of a subflow has changed. 'error'
|
|
* should not be set. Attributes: token, family, loc_id, rem_id, saddr4 |
|
|
* saddr6, daddr4 | daddr6, sport, dport, backup, if-idx [, error].
|
|
* @MPTCP_EVENT_LISTENER_CREATED: A new PM listener is created. Attributes:
|
|
* family, sport, saddr4 | saddr6.
|
|
* @MPTCP_EVENT_LISTENER_CLOSED: A PM listener is closed. Attributes: family,
|
|
* sport, saddr4 | saddr6.
|
|
*/
|
|
enum mptcp_event_type {
|
|
MPTCP_EVENT_UNSPEC,
|
|
MPTCP_EVENT_CREATED,
|
|
MPTCP_EVENT_ESTABLISHED,
|
|
MPTCP_EVENT_CLOSED,
|
|
MPTCP_EVENT_ANNOUNCED = 6,
|
|
MPTCP_EVENT_REMOVED,
|
|
MPTCP_EVENT_SUB_ESTABLISHED = 10,
|
|
MPTCP_EVENT_SUB_CLOSED,
|
|
MPTCP_EVENT_SUB_PRIORITY = 13,
|
|
MPTCP_EVENT_LISTENER_CREATED = 15,
|
|
MPTCP_EVENT_LISTENER_CLOSED,
|
|
};
|
|
|
|
enum {
|
|
MPTCP_PM_ADDR_ATTR_UNSPEC,
|
|
MPTCP_PM_ADDR_ATTR_FAMILY,
|
|
MPTCP_PM_ADDR_ATTR_ID,
|
|
MPTCP_PM_ADDR_ATTR_ADDR4,
|
|
MPTCP_PM_ADDR_ATTR_ADDR6,
|
|
MPTCP_PM_ADDR_ATTR_PORT,
|
|
MPTCP_PM_ADDR_ATTR_FLAGS,
|
|
MPTCP_PM_ADDR_ATTR_IF_IDX,
|
|
|
|
__MPTCP_PM_ADDR_ATTR_MAX
|
|
};
|
|
#define MPTCP_PM_ADDR_ATTR_MAX (__MPTCP_PM_ADDR_ATTR_MAX - 1)
|
|
|
|
enum {
|
|
MPTCP_SUBFLOW_ATTR_UNSPEC,
|
|
MPTCP_SUBFLOW_ATTR_TOKEN_REM,
|
|
MPTCP_SUBFLOW_ATTR_TOKEN_LOC,
|
|
MPTCP_SUBFLOW_ATTR_RELWRITE_SEQ,
|
|
MPTCP_SUBFLOW_ATTR_MAP_SEQ,
|
|
MPTCP_SUBFLOW_ATTR_MAP_SFSEQ,
|
|
MPTCP_SUBFLOW_ATTR_SSN_OFFSET,
|
|
MPTCP_SUBFLOW_ATTR_MAP_DATALEN,
|
|
MPTCP_SUBFLOW_ATTR_FLAGS,
|
|
MPTCP_SUBFLOW_ATTR_ID_REM,
|
|
MPTCP_SUBFLOW_ATTR_ID_LOC,
|
|
MPTCP_SUBFLOW_ATTR_PAD,
|
|
|
|
__MPTCP_SUBFLOW_ATTR_MAX
|
|
};
|
|
#define MPTCP_SUBFLOW_ATTR_MAX (__MPTCP_SUBFLOW_ATTR_MAX - 1)
|
|
|
|
enum {
|
|
MPTCP_PM_ENDPOINT_ADDR = 1,
|
|
|
|
__MPTCP_PM_ENDPOINT_MAX
|
|
};
|
|
#define MPTCP_PM_ENDPOINT_MAX (__MPTCP_PM_ENDPOINT_MAX - 1)
|
|
|
|
enum {
|
|
MPTCP_PM_ATTR_UNSPEC,
|
|
MPTCP_PM_ATTR_ADDR,
|
|
MPTCP_PM_ATTR_RCV_ADD_ADDRS,
|
|
MPTCP_PM_ATTR_SUBFLOWS,
|
|
MPTCP_PM_ATTR_TOKEN,
|
|
MPTCP_PM_ATTR_LOC_ID,
|
|
MPTCP_PM_ATTR_ADDR_REMOTE,
|
|
|
|
__MPTCP_ATTR_AFTER_LAST
|
|
};
|
|
#define MPTCP_PM_ATTR_MAX (__MPTCP_ATTR_AFTER_LAST - 1)
|
|
|
|
enum mptcp_event_attr {
|
|
MPTCP_ATTR_UNSPEC,
|
|
MPTCP_ATTR_TOKEN,
|
|
MPTCP_ATTR_FAMILY,
|
|
MPTCP_ATTR_LOC_ID,
|
|
MPTCP_ATTR_REM_ID,
|
|
MPTCP_ATTR_SADDR4,
|
|
MPTCP_ATTR_SADDR6,
|
|
MPTCP_ATTR_DADDR4,
|
|
MPTCP_ATTR_DADDR6,
|
|
MPTCP_ATTR_SPORT,
|
|
MPTCP_ATTR_DPORT,
|
|
MPTCP_ATTR_BACKUP,
|
|
MPTCP_ATTR_ERROR,
|
|
MPTCP_ATTR_FLAGS,
|
|
MPTCP_ATTR_TIMEOUT,
|
|
MPTCP_ATTR_IF_IDX,
|
|
MPTCP_ATTR_RESET_REASON,
|
|
MPTCP_ATTR_RESET_FLAGS,
|
|
MPTCP_ATTR_SERVER_SIDE,
|
|
|
|
__MPTCP_ATTR_MAX
|
|
};
|
|
#define MPTCP_ATTR_MAX (__MPTCP_ATTR_MAX - 1)
|
|
|
|
enum {
|
|
MPTCP_PM_CMD_UNSPEC,
|
|
MPTCP_PM_CMD_ADD_ADDR,
|
|
MPTCP_PM_CMD_DEL_ADDR,
|
|
MPTCP_PM_CMD_GET_ADDR,
|
|
MPTCP_PM_CMD_FLUSH_ADDRS,
|
|
MPTCP_PM_CMD_SET_LIMITS,
|
|
MPTCP_PM_CMD_GET_LIMITS,
|
|
MPTCP_PM_CMD_SET_FLAGS,
|
|
MPTCP_PM_CMD_ANNOUNCE,
|
|
MPTCP_PM_CMD_REMOVE,
|
|
MPTCP_PM_CMD_SUBFLOW_CREATE,
|
|
MPTCP_PM_CMD_SUBFLOW_DESTROY,
|
|
|
|
__MPTCP_PM_CMD_AFTER_LAST
|
|
};
|
|
#define MPTCP_PM_CMD_MAX (__MPTCP_PM_CMD_AFTER_LAST - 1)
|
|
|
|
#endif /* _UAPI_LINUX_MPTCP_PM_H */
|