|
 |
0ac2f3 |
From af65892658d7c271d1fb328065a35f8017610418 Mon Sep 17 00:00:00 2001
|
|
|
0ac2f3 |
From: Andrea Claudi <aclaudi@redhat.com>
|
|
|
0ac2f3 |
Date: Thu, 4 Jun 2020 19:28:45 +0200
|
|
|
0ac2f3 |
Subject: [PATCH] man: mptcp man page
|
|
|
0ac2f3 |
|
|
|
0ac2f3 |
Bugzilla: https://bugzilla.redhat.com/show_bug.cgi?id=1812207
|
|
|
0ac2f3 |
Upstream Status: unknown commit 2d8b5fe93e9de
|
|
|
0ac2f3 |
|
|
|
0ac2f3 |
commit 2d8b5fe93e9decb56acc243905d82fb22d6c4cfd
|
|
|
0ac2f3 |
Author: Paolo Abeni <pabeni@redhat.com>
|
|
|
0ac2f3 |
Date: Thu Apr 23 15:37:10 2020 +0200
|
|
|
0ac2f3 |
|
|
|
0ac2f3 |
man: mptcp man page
|
|
|
0ac2f3 |
|
|
|
0ac2f3 |
describe the mptcp subcommands implemented so far.
|
|
|
0ac2f3 |
|
|
|
0ac2f3 |
Signed-off-by: Paolo Abeni <pabeni@redhat.com>
|
|
|
0ac2f3 |
Signed-off-by: David Ahern <dsahern@gmail.com>
|
|
|
0ac2f3 |
---
|
|
|
0ac2f3 |
man/man8/ip-mptcp.8 | 142 ++++++++++++++++++++++++++++++++++++++++++++
|
|
|
0ac2f3 |
1 file changed, 142 insertions(+)
|
|
|
0ac2f3 |
create mode 100644 man/man8/ip-mptcp.8
|
|
|
0ac2f3 |
|
|
|
0ac2f3 |
diff --git a/man/man8/ip-mptcp.8 b/man/man8/ip-mptcp.8
|
|
|
0ac2f3 |
new file mode 100644
|
|
|
0ac2f3 |
index 0000000000000..f6457e97efbe8
|
|
|
0ac2f3 |
--- /dev/null
|
|
|
0ac2f3 |
+++ b/man/man8/ip-mptcp.8
|
|
|
0ac2f3 |
@@ -0,0 +1,142 @@
|
|
|
0ac2f3 |
+.TH IP\-MPTCP 8 "4 Apr 2020" "iproute2" "Linux"
|
|
|
0ac2f3 |
+.SH "NAME"
|
|
|
0ac2f3 |
+ip-mptcp \- MPTCP path manager configuration
|
|
|
0ac2f3 |
+.SH "SYNOPSIS"
|
|
|
0ac2f3 |
+.sp
|
|
|
0ac2f3 |
+.ad l
|
|
|
0ac2f3 |
+.in +8
|
|
|
0ac2f3 |
+.ti -8
|
|
|
0ac2f3 |
+.B ip
|
|
|
0ac2f3 |
+.RI "[ " OPTIONS " ]"
|
|
|
0ac2f3 |
+.B mptcp
|
|
|
0ac2f3 |
+.RB "{ "
|
|
|
0ac2f3 |
+.B endpoint
|
|
|
0ac2f3 |
+.RB " | "
|
|
|
0ac2f3 |
+.B limits
|
|
|
0ac2f3 |
+.RB " | "
|
|
|
0ac2f3 |
+.B help
|
|
|
0ac2f3 |
+.RB " }"
|
|
|
0ac2f3 |
+.sp
|
|
|
0ac2f3 |
+
|
|
|
0ac2f3 |
+.ti -8
|
|
|
0ac2f3 |
+.BR "ip mptcp endpoint add "
|
|
|
0ac2f3 |
+.IR IFADDR
|
|
|
0ac2f3 |
+.RB "[ " dev
|
|
|
0ac2f3 |
+.IR IFNAME " ]"
|
|
|
0ac2f3 |
+.RB "[ " id
|
|
|
0ac2f3 |
+.I ID
|
|
|
0ac2f3 |
+.RB "] [ "
|
|
|
0ac2f3 |
+.I FLAG-LIST
|
|
|
0ac2f3 |
+.RB "] "
|
|
|
0ac2f3 |
+
|
|
|
0ac2f3 |
+.ti -8
|
|
|
0ac2f3 |
+.BR "ip mptcp endpoint del id "
|
|
|
0ac2f3 |
+.I ID
|
|
|
0ac2f3 |
+
|
|
|
0ac2f3 |
+.ti -8
|
|
|
0ac2f3 |
+.BR "ip mptcp endpoint show "
|
|
|
0ac2f3 |
+.RB "[ " id
|
|
|
0ac2f3 |
+.I ID
|
|
|
0ac2f3 |
+.RB "]"
|
|
|
0ac2f3 |
+
|
|
|
0ac2f3 |
+.ti -8
|
|
|
0ac2f3 |
+.BR "ip mptcp endpoint flush"
|
|
|
0ac2f3 |
+
|
|
|
0ac2f3 |
+.ti -8
|
|
|
0ac2f3 |
+.IR FLAG-LIST " := [ " FLAG-LIST " ] " FLAG
|
|
|
0ac2f3 |
+
|
|
|
0ac2f3 |
+.ti -8
|
|
|
0ac2f3 |
+.IR FLAG " := ["
|
|
|
0ac2f3 |
+.B signal
|
|
|
0ac2f3 |
+.RB "|"
|
|
|
0ac2f3 |
+.B subflow
|
|
|
0ac2f3 |
+.RB "|"
|
|
|
0ac2f3 |
+.B backup
|
|
|
0ac2f3 |
+.RB "]"
|
|
|
0ac2f3 |
+
|
|
|
0ac2f3 |
+.ti -8
|
|
|
0ac2f3 |
+.BR "ip mptcp limits set "
|
|
|
0ac2f3 |
+.RB "[ "
|
|
|
0ac2f3 |
+.B subflow
|
|
|
0ac2f3 |
+.IR SUBFLOW_NR " ]"
|
|
|
0ac2f3 |
+.RB "[ "
|
|
|
0ac2f3 |
+.B add_addr_accepted
|
|
|
0ac2f3 |
+.IR ADD_ADDR_ACCEPTED_NR " ]"
|
|
|
0ac2f3 |
+
|
|
|
0ac2f3 |
+.ti -8
|
|
|
0ac2f3 |
+.BR "ip mptcp limits show"
|
|
|
0ac2f3 |
+
|
|
|
0ac2f3 |
+.SH DESCRIPTION
|
|
|
0ac2f3 |
+
|
|
|
0ac2f3 |
+MPTCP is a transport protocol built on top of TCP that allows TCP
|
|
|
0ac2f3 |
+connections to use multiple paths to maximize resource usage and increase
|
|
|
0ac2f3 |
+redundancy. The ip-mptcp sub-commands allow configuring several aspects of the
|
|
|
0ac2f3 |
+MPTCP path manager, which is in charge of subflows creation:
|
|
|
0ac2f3 |
+
|
|
|
0ac2f3 |
+.P
|
|
|
0ac2f3 |
+The
|
|
|
0ac2f3 |
+.B endpoint
|
|
|
0ac2f3 |
+object specifies the IP addresses that will be used and/or announced for
|
|
|
0ac2f3 |
+additional subflows:
|
|
|
0ac2f3 |
+
|
|
|
0ac2f3 |
+.TS
|
|
|
0ac2f3 |
+l l.
|
|
|
0ac2f3 |
+ip mptcp endpoint add add new MPTCP endpoint
|
|
|
0ac2f3 |
+ip mptcp endpoint delete delete existing MPTCP endpoint
|
|
|
0ac2f3 |
+ip mptcp endpoint show get existing MPTCP endpoint
|
|
|
0ac2f3 |
+ip mptcp endpoint flush flush all existing MPTCP endpoints
|
|
|
0ac2f3 |
+.TE
|
|
|
0ac2f3 |
+
|
|
|
0ac2f3 |
+.TP
|
|
|
0ac2f3 |
+.IR ID
|
|
|
0ac2f3 |
+is a unique numeric identifier for the given endpoint
|
|
|
0ac2f3 |
+
|
|
|
0ac2f3 |
+.TP
|
|
|
0ac2f3 |
+.BR signal
|
|
|
0ac2f3 |
+the endpoint will be announced/signalled to each peer via an ADD_ADDR MPTCP
|
|
|
0ac2f3 |
+sub-option
|
|
|
0ac2f3 |
+
|
|
|
0ac2f3 |
+.TP
|
|
|
0ac2f3 |
+.BR subflow
|
|
|
0ac2f3 |
+if additional subflow creation is allowed by MPTCP limits, the endpoint will
|
|
|
0ac2f3 |
+be used as the source address to create an additional subflow after that
|
|
|
0ac2f3 |
+the MPTCP connection is established.
|
|
|
0ac2f3 |
+
|
|
|
0ac2f3 |
+.TP
|
|
|
0ac2f3 |
+.BR backup
|
|
|
0ac2f3 |
+the endpoint will be announced as a backup address, if this is a
|
|
|
0ac2f3 |
+.BR signal
|
|
|
0ac2f3 |
+endpoint, or the subflow will be created as a backup one if this is a
|
|
|
0ac2f3 |
+.BR subflow
|
|
|
0ac2f3 |
+endpoint
|
|
|
0ac2f3 |
+
|
|
|
0ac2f3 |
+.sp
|
|
|
0ac2f3 |
+.PP
|
|
|
0ac2f3 |
+The
|
|
|
0ac2f3 |
+.B limits
|
|
|
0ac2f3 |
+object specifies the constraints for subflow creations:
|
|
|
0ac2f3 |
+
|
|
|
0ac2f3 |
+.TS
|
|
|
0ac2f3 |
+l l.
|
|
|
0ac2f3 |
+ip mptcp limits show get current MPTCP subflow creation limits
|
|
|
0ac2f3 |
+ip mptcp limits set change the MPTCP subflow creation limits
|
|
|
0ac2f3 |
+.TE
|
|
|
0ac2f3 |
+
|
|
|
0ac2f3 |
+.TP
|
|
|
0ac2f3 |
+.IR SUBFLOW_NR
|
|
|
0ac2f3 |
+specifies the maximum number of additional subflows allowed for each MPTCP
|
|
|
0ac2f3 |
+connection. Additional subflows can be created due to: incoming accepted
|
|
|
0ac2f3 |
+ADD_ADDR option, local
|
|
|
0ac2f3 |
+.BR subflow
|
|
|
0ac2f3 |
+endpoints, additional subflows started by the peer.
|
|
|
0ac2f3 |
+
|
|
|
0ac2f3 |
+.TP
|
|
|
0ac2f3 |
+.IR ADD_ADDR_ACCEPTED_NR
|
|
|
0ac2f3 |
+specifies the maximum number of ADD_ADDR suboptions accepted for each MPTCP
|
|
|
0ac2f3 |
+connection. The MPTCP path manager will try to create a new subflow for
|
|
|
0ac2f3 |
+each accepted ADD_ADDR option, respecting the
|
|
|
0ac2f3 |
+.IR SUBFLOW_NR
|
|
|
0ac2f3 |
+limit.
|
|
|
0ac2f3 |
+
|
|
|
0ac2f3 |
+.SH AUTHOR
|
|
|
0ac2f3 |
+Original Manpage by Paolo Abeni <pabeni@redhat.com>
|
|
|
0ac2f3 |
--
|
|
|
0ac2f3 |
2.26.2
|
|
|
0ac2f3 |
|