|
 |
049c96 |
From 6d19d559d29c1060c0d472f4d6a5daf2c5e608a9 Mon Sep 17 00:00:00 2001
|
|
|
049c96 |
From: Phil Sutter <psutter@redhat.com>
|
|
|
049c96 |
Date: Mon, 7 Mar 2016 15:57:00 +0100
|
|
|
049c96 |
Subject: [PATCH] iproute: Descriptions of fou and gue options in ip-link man
|
|
|
049c96 |
pages
|
|
|
049c96 |
|
|
|
049c96 |
Bugzilla: https://bugzilla.redhat.com/show_bug.cgi?id=1013584
|
|
|
049c96 |
Upstream Status: iproute2.git commit 90f1df715eb38
|
|
|
049c96 |
|
|
|
049c96 |
commit 90f1df715eb38bbbb4554ebbad783d67690a38b2
|
|
|
049c96 |
Author: Tom Herbert <therbert@google.com>
|
|
|
049c96 |
Date: Thu Jan 29 08:52:01 2015 -0800
|
|
|
049c96 |
|
|
|
049c96 |
iproute: Descriptions of fou and gue options in ip-link man pages
|
|
|
049c96 |
|
|
|
049c96 |
Add section for additional arguments to GRE, IPIP, and SIT types
|
|
|
049c96 |
that are related to Foo-over-UDP and Generic UDP Encapsulation.
|
|
|
049c96 |
Also, added an example GUE configuration in the examples section.
|
|
|
049c96 |
|
|
|
049c96 |
Signed-off-by: Tom Herbert <therbert@google.com>
|
|
|
049c96 |
---
|
|
|
049c96 |
man/man8/ip-link.8.in | 68 ++++++++++++++++++++++++++++++++++++++++++++++++++-
|
|
|
049c96 |
1 file changed, 67 insertions(+), 1 deletion(-)
|
|
|
049c96 |
|
|
|
049c96 |
diff --git a/man/man8/ip-link.8.in b/man/man8/ip-link.8.in
|
|
|
049c96 |
index 81ef4bb..9e667a2 100644
|
|
|
049c96 |
--- a/man/man8/ip-link.8.in
|
|
|
049c96 |
+++ b/man/man8/ip-link.8.in
|
|
|
049c96 |
@@ -460,6 +460,63 @@ Example:
|
|
|
049c96 |
.in -8
|
|
|
049c96 |
|
|
|
049c96 |
.TP
|
|
|
049c96 |
+GRE, IPIP, SIT Type Support
|
|
|
049c96 |
+For a link of types
|
|
|
049c96 |
+.I GRE/IPIP/SIT
|
|
|
049c96 |
+the following additional arguments are supported:
|
|
|
049c96 |
+
|
|
|
049c96 |
+.BI "ip link add " DEVICE
|
|
|
049c96 |
+.BR type " { gre | ipip | sit } "
|
|
|
049c96 |
+.BI " remote " ADDR " local " ADDR
|
|
|
049c96 |
+.R " [ "
|
|
|
049c96 |
+.BR encap " { fou | gue | none } "
|
|
|
049c96 |
+.R " ] [ "
|
|
|
049c96 |
+.BI "encap-sport { " PORT " | auto } "
|
|
|
049c96 |
+.R " ] [ "
|
|
|
049c96 |
+.BI "encap-dport " PORT
|
|
|
049c96 |
+.R " ] [ "
|
|
|
049c96 |
+.I " [no]encap-csum "
|
|
|
049c96 |
+.R " ] [ "
|
|
|
049c96 |
+.I " [no]encap-remcsum "
|
|
|
049c96 |
+.R " ]"
|
|
|
049c96 |
+
|
|
|
049c96 |
+.in +8
|
|
|
049c96 |
+.sp
|
|
|
049c96 |
+.BI remote " ADDR "
|
|
|
049c96 |
+- specifies the remote address of the tunnel.
|
|
|
049c96 |
+
|
|
|
049c96 |
+.sp
|
|
|
049c96 |
+.BI local " ADDR "
|
|
|
049c96 |
+- specifies the fixed local address for tunneled packets.
|
|
|
049c96 |
+It must be an address on another interface on this host.
|
|
|
049c96 |
+
|
|
|
049c96 |
+.sp
|
|
|
049c96 |
+.BR encap " { fou | gue | none } "
|
|
|
049c96 |
+- specifies type of secondary UDP encapsulation. "fou" indicates
|
|
|
049c96 |
+Foo-Over-UDP, "gue" indicates Generic UDP Encapsulation.
|
|
|
049c96 |
+
|
|
|
049c96 |
+.sp
|
|
|
049c96 |
+.BI "encap-sport { " PORT " | auto } "
|
|
|
049c96 |
+- specifies the source port in UDP encapsulation.
|
|
|
049c96 |
+.IR PORT
|
|
|
049c96 |
+indicates the port by number, "auto"
|
|
|
049c96 |
+indicates that the port number should be chosen automatically
|
|
|
049c96 |
+(the kernel picks a flow based on the flow hash of the
|
|
|
049c96 |
+encapsulated packet).
|
|
|
049c96 |
+
|
|
|
049c96 |
+.sp
|
|
|
049c96 |
+.I [no]encap-csum
|
|
|
049c96 |
+- specifies if UDP checksums are enabled in the secondary
|
|
|
049c96 |
+encapsulation.
|
|
|
049c96 |
+
|
|
|
049c96 |
+.sp
|
|
|
049c96 |
+.I [no]encap-remcsum
|
|
|
049c96 |
+- specifies if Remote Checksum Offload is enabled. This is only
|
|
|
049c96 |
+applicable for Generic UDP Encapsulation.
|
|
|
049c96 |
+
|
|
|
049c96 |
+.in -8
|
|
|
049c96 |
+
|
|
|
049c96 |
+.TP
|
|
|
049c96 |
IP6GRE/IP6GRETAP Type Support
|
|
|
049c96 |
For a link of type
|
|
|
049c96 |
.I IP6GRE/IP6GRETAP
|
|
|
049c96 |
@@ -495,7 +552,7 @@ the following additional arguments are supported:
|
|
|
049c96 |
.sp
|
|
|
049c96 |
.BI local " ADDR "
|
|
|
049c96 |
- specifies the fixed local IPv6 address for tunneled packets.
|
|
|
049c96 |
-It must be and address on another interface on this host.
|
|
|
049c96 |
+It must be an address on another interface on this host.
|
|
|
049c96 |
|
|
|
049c96 |
.sp
|
|
|
049c96 |
.BI [i|o]seq
|
|
|
049c96 |
@@ -831,6 +888,15 @@ ip link help gre
|
|
|
049c96 |
.RS 4
|
|
|
049c96 |
Display help for the gre link type.
|
|
|
049c96 |
.RE
|
|
|
049c96 |
+.PP
|
|
|
049c96 |
+ip link add name tun1 type ipip remote 192.168.1.1
|
|
|
049c96 |
+local 192.168.1.2 ttl 225 encap gue encap-sport auto
|
|
|
049c96 |
+encap-dport 5555 encap-csum encap-remcsum
|
|
|
049c96 |
+.RS 4
|
|
|
049c96 |
+Creates an IPIP that is encapsulated with Generic UDP Encapsulation,
|
|
|
049c96 |
+and the outer UDP checksum and remote checksum offload are enabled.
|
|
|
049c96 |
+
|
|
|
049c96 |
+.RE
|
|
|
049c96 |
|
|
|
049c96 |
.SH SEE ALSO
|
|
|
049c96 |
.br
|
|
|
049c96 |
--
|
|
|
049c96 |
1.8.3.1
|
|
|
049c96 |
|