Family mptcp_pm netlink specification¶
Summary¶
Multipath TCP.
Operations¶
unspec¶
unused
- value
0
add-addr¶
Add endpoint
- attribute-set
endpoint
- dont-validate
['strict']
- flags
['uns-admin-perm']
- do
- request
- attributes
[
addr]
del-addr¶
Delete endpoint
- attribute-set
endpoint
- dont-validate
['strict']
- flags
['uns-admin-perm']
- do
- request
- attributes
[
addr]
get-addr¶
Get endpoint information
- attribute-set
endpoint
- dont-validate
['strict']
- flags
['uns-admin-perm']
- do
- request
- attributes
[
addr]
- reply
- attributes
[
addr]
- dump
- reply
- attributes
[
addr]
flush-addrs¶
flush addresses
- attribute-set
endpoint
- dont-validate
['strict']
- flags
['uns-admin-perm']
- do
- request
- attributes
[
addr]
set-limits¶
Set protocol limits
- attribute-set
attr
- dont-validate
['strict']
- flags
['uns-admin-perm']
- do
- request
- attributes
[
rcv-add-addrs,subflows]
get-limits¶
Get protocol limits
- attribute-set
attr
- dont-validate
['strict']
- do
- request
- attributes
[
rcv-add-addrs,subflows]
- reply
- attributes
[
rcv-add-addrs,subflows]
set-flags¶
Change endpoint flags
- attribute-set
attr
- dont-validate
['strict']
- flags
['uns-admin-perm']
- do
- request
- attributes
[
addr,token,addr-remote]
announce¶
announce new sf
- attribute-set
attr
- dont-validate
['strict']
- flags
['uns-admin-perm']
- do
- request
- attributes
[
addr,token]
remove¶
announce removal
- attribute-set
attr
- dont-validate
['strict']
- flags
['uns-admin-perm']
- do
- request
- attributes
[
token,loc-id]
subflow-create¶
todo
- attribute-set
attr
- dont-validate
['strict']
- flags
['uns-admin-perm']
- do
- request
- attributes
[
addr,token,addr-remote]
subflow-destroy¶
todo
- attribute-set
attr
- dont-validate
['strict']
- flags
['uns-admin-perm']
- do
- request
- attributes
[
addr,token,addr-remote]
Definitions¶
event-type¶
- type
enum
- enum-name
mptcp-event-type
- name-prefix
mptcp-event-
- entries
- unspec
unused event
- created
token, family, saddr4 | saddr6, daddr4 | daddr6, sport, dport 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.
- established
token, family, saddr4 | saddr6, daddr4 | daddr6, sport, dport A MPTCP connection is established (can start new subflows).
- closed
token A MPTCP connection has stopped.
- announced
token, rem_id, family, daddr4 | daddr6 [, dport] A new address has been announced by the peer.
- removed
token, rem_id An address has been lost by the peer.
- sub-established
token, family, loc_id, rem_id, saddr4 | saddr6, daddr4 | daddr6, sport, dport, backup, if_idx [, error] A new subflow has been established. 'error' should not be set.
- sub-closed
token, family, loc_id, rem_id, saddr4 | saddr6, daddr4 | daddr6, sport, dport, backup, if_idx [, error] A subflow has been closed. An error (copy of sk_err) could be set if an error has been detected for this subflow.
- sub-priority
token, family, loc_id, rem_id, saddr4 | saddr6, daddr4 | daddr6, sport, dport, backup, if_idx [, error] The priority of a subflow has changed. 'error' should not be set.
- listener-created
family, sport, saddr4 | saddr6 A new PM listener is created.
- listener-closed
family, sport, saddr4 | saddr6 A PM listener is closed.
Attribute sets¶
address¶
unspec (unused)¶
- value
0
family (u16)¶
id (u8)¶
addr4 (u32)¶
- byte-order
big-endian
addr6 (binary)¶
port (u16)¶
- byte-order
big-endian
flags (u32)¶
if-idx (s32)¶
subflow-attribute¶
unspec (unused)¶
- value
0
token-rem (u32)¶
token-loc (u32)¶
relwrite-seq (u32)¶
map-seq (u64)¶
map-sfseq (u32)¶
ssn-offset (u32)¶
map-datalen (u16)¶
flags (u32)¶
id-rem (u8)¶
id-loc (u8)¶
pad (pad)¶
endpoint¶
addr (nest)¶
- nested-attributes
address
attr¶
unspec (unused)¶
- value
0
addr (nest)¶
- nested-attributes
address
rcv-add-addrs (u32)¶
subflows (u32)¶
token (u32)¶
loc-id (u8)¶
addr-remote (nest)¶
- nested-attributes
address
event-attr¶
unspec (unused)¶
- value
0
token (u32)¶
family (u16)¶
loc-id (u8)¶
rem-id (u8)¶
saddr4 (u32)¶
- byte-order
big-endian
saddr6 (binary)¶
daddr4 (u32)¶
- byte-order
big-endian
daddr6 (binary)¶
sport (u16)¶
- byte-order
big-endian
dport (u16)¶
- byte-order
big-endian