|
Packit Service |
3880ab |
.TH IP\-MPTCP 8 "4 Apr 2020" "iproute2" "Linux"
|
|
Packit Service |
3880ab |
.SH "NAME"
|
|
Packit Service |
3880ab |
ip-mptcp \- MPTCP path manager configuration
|
|
Packit Service |
3880ab |
.SH "SYNOPSIS"
|
|
Packit Service |
3880ab |
.ad l
|
|
Packit Service |
3880ab |
.in +8
|
|
Packit Service |
3880ab |
.ti -8
|
|
Packit Service |
3880ab |
.B ip
|
|
Packit Service |
3880ab |
.RI "[ " OPTIONS " ]"
|
|
Packit Service |
3880ab |
.B mptcp
|
|
Packit Service |
3880ab |
.RB "{ "
|
|
Packit Service |
3880ab |
.B endpoint
|
|
Packit Service |
3880ab |
.RB " | "
|
|
Packit Service |
3880ab |
.B limits
|
|
Packit Service |
3880ab |
.RB " | "
|
|
Packit Service |
3880ab |
.B help
|
|
Packit Service |
3880ab |
.RB " }"
|
|
Packit Service |
3880ab |
.sp
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.ti -8
|
|
Packit Service |
3880ab |
.BR "ip mptcp endpoint add "
|
|
Packit Service |
3880ab |
.IR IFADDR
|
|
Packit Service |
3880ab |
.RB "[ " dev
|
|
Packit Service |
3880ab |
.IR IFNAME " ]"
|
|
Packit Service |
3880ab |
.RB "[ " id
|
|
Packit Service |
3880ab |
.I ID
|
|
Packit Service |
3880ab |
.RB "] [ "
|
|
Packit Service |
3880ab |
.I FLAG-LIST
|
|
Packit Service |
3880ab |
.RB "] "
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.ti -8
|
|
Packit Service |
3880ab |
.BR "ip mptcp endpoint del id "
|
|
Packit Service |
3880ab |
.I ID
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.ti -8
|
|
Packit Service |
3880ab |
.BR "ip mptcp endpoint show "
|
|
Packit Service |
3880ab |
.RB "[ " id
|
|
Packit Service |
3880ab |
.I ID
|
|
Packit Service |
3880ab |
.RB "]"
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.ti -8
|
|
Packit Service |
3880ab |
.BR "ip mptcp endpoint flush"
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.ti -8
|
|
Packit Service |
3880ab |
.IR FLAG-LIST " := [ " FLAG-LIST " ] " FLAG
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.ti -8
|
|
Packit Service |
3880ab |
.IR FLAG " := ["
|
|
Packit Service |
3880ab |
.B signal
|
|
Packit Service |
3880ab |
.RB "|"
|
|
Packit Service |
3880ab |
.B subflow
|
|
Packit Service |
3880ab |
.RB "|"
|
|
Packit Service |
3880ab |
.B backup
|
|
Packit Service |
3880ab |
.RB "]"
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.ti -8
|
|
Packit Service |
3880ab |
.BR "ip mptcp limits set "
|
|
Packit Service |
3880ab |
.RB "[ "
|
|
Packit Service |
3880ab |
.B subflow
|
|
Packit Service |
3880ab |
.IR SUBFLOW_NR " ]"
|
|
Packit Service |
3880ab |
.RB "[ "
|
|
Packit Service |
3880ab |
.B add_addr_accepted
|
|
Packit Service |
3880ab |
.IR ADD_ADDR_ACCEPTED_NR " ]"
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.ti -8
|
|
Packit Service |
3880ab |
.BR "ip mptcp limits show"
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.SH DESCRIPTION
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
MPTCP is a transport protocol built on top of TCP that allows TCP
|
|
Packit Service |
3880ab |
connections to use multiple paths to maximize resource usage and increase
|
|
Packit Service |
3880ab |
redundancy. The ip-mptcp sub-commands allow configuring several aspects of the
|
|
Packit Service |
3880ab |
MPTCP path manager, which is in charge of subflows creation:
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.P
|
|
Packit Service |
3880ab |
The
|
|
Packit Service |
3880ab |
.B endpoint
|
|
Packit Service |
3880ab |
object specifies the IP addresses that will be used and/or announced for
|
|
Packit Service |
3880ab |
additional subflows:
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.TS
|
|
Packit Service |
3880ab |
l l.
|
|
Packit Service |
3880ab |
ip mptcp endpoint add add new MPTCP endpoint
|
|
Packit Service |
3880ab |
ip mptcp endpoint delete delete existing MPTCP endpoint
|
|
Packit Service |
3880ab |
ip mptcp endpoint show get existing MPTCP endpoint
|
|
Packit Service |
3880ab |
ip mptcp endpoint flush flush all existing MPTCP endpoints
|
|
Packit Service |
3880ab |
.TE
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.TP
|
|
Packit Service |
3880ab |
.IR ID
|
|
Packit Service |
3880ab |
is a unique numeric identifier for the given endpoint
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.TP
|
|
Packit Service |
3880ab |
.BR signal
|
|
Packit Service |
3880ab |
the endpoint will be announced/signalled to each peer via an ADD_ADDR MPTCP
|
|
Packit Service |
3880ab |
sub-option
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.TP
|
|
Packit Service |
3880ab |
.BR subflow
|
|
Packit Service |
3880ab |
if additional subflow creation is allowed by MPTCP limits, the endpoint will
|
|
Packit Service |
3880ab |
be used as the source address to create an additional subflow after that
|
|
Packit Service |
3880ab |
the MPTCP connection is established.
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.TP
|
|
Packit Service |
3880ab |
.BR backup
|
|
Packit Service |
3880ab |
the endpoint will be announced as a backup address, if this is a
|
|
Packit Service |
3880ab |
.BR signal
|
|
Packit Service |
3880ab |
endpoint, or the subflow will be created as a backup one if this is a
|
|
Packit Service |
3880ab |
.BR subflow
|
|
Packit Service |
3880ab |
endpoint
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.sp
|
|
Packit Service |
3880ab |
.PP
|
|
Packit Service |
3880ab |
The
|
|
Packit Service |
3880ab |
.B limits
|
|
Packit Service |
3880ab |
object specifies the constraints for subflow creations:
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.TS
|
|
Packit Service |
3880ab |
l l.
|
|
Packit Service |
3880ab |
ip mptcp limits show get current MPTCP subflow creation limits
|
|
Packit Service |
3880ab |
ip mptcp limits set change the MPTCP subflow creation limits
|
|
Packit Service |
3880ab |
.TE
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.TP
|
|
Packit Service |
3880ab |
.IR SUBFLOW_NR
|
|
Packit Service |
3880ab |
specifies the maximum number of additional subflows allowed for each MPTCP
|
|
Packit Service |
3880ab |
connection. Additional subflows can be created due to: incoming accepted
|
|
Packit Service |
3880ab |
ADD_ADDR option, local
|
|
Packit Service |
3880ab |
.BR subflow
|
|
Packit Service |
3880ab |
endpoints, additional subflows started by the peer.
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.TP
|
|
Packit Service |
3880ab |
.IR ADD_ADDR_ACCEPTED_NR
|
|
Packit Service |
3880ab |
specifies the maximum number of ADD_ADDR suboptions accepted for each MPTCP
|
|
Packit Service |
3880ab |
connection. The MPTCP path manager will try to create a new subflow for
|
|
Packit Service |
3880ab |
each accepted ADD_ADDR option, respecting the
|
|
Packit Service |
3880ab |
.IR SUBFLOW_NR
|
|
Packit Service |
3880ab |
limit.
|
|
Packit Service |
3880ab |
|
|
Packit Service |
3880ab |
.SH AUTHOR
|
|
Packit Service |
3880ab |
Original Manpage by Paolo Abeni <pabeni@redhat.com>
|