|
 |
049c96 |
From 2d76f7483d2bf0857d325883fe22c924d1dfcb53 Mon Sep 17 00:00:00 2001
|
|
|
049c96 |
From: Phil Sutter <psutter@redhat.com>
|
|
|
049c96 |
Date: Mon, 7 Mar 2016 15:57:01 +0100
|
|
|
049c96 |
Subject: [PATCH] man: ip-link: document MACVLAN/MACVTAP interface types
|
|
|
049c96 |
|
|
|
049c96 |
Bugzilla: https://bugzilla.redhat.com/show_bug.cgi?id=1013584
|
|
|
049c96 |
Upstream Status: iproute2.git commit a60223bc1c10d
|
|
|
049c96 |
Conflicts: Changed context due to missing GENEVE support
|
|
|
049c96 |
|
|
|
049c96 |
commit a60223bc1c10d4b172caa966acebb5a1620d0d6f
|
|
|
049c96 |
Author: Phil Sutter <phil@nwl.cc>
|
|
|
049c96 |
Date: Fri Sep 25 14:09:51 2015 +0200
|
|
|
049c96 |
|
|
|
049c96 |
man: ip-link: document MACVLAN/MACVTAP interface types
|
|
|
049c96 |
|
|
|
049c96 |
Signed-off-by: Phil Sutter <phil@nwl.cc>
|
|
|
049c96 |
---
|
|
|
049c96 |
man/man8/ip-link.8.in | 50 ++++++++++++++++++++++++++++++++++++++++++++++++++
|
|
|
049c96 |
1 file changed, 50 insertions(+)
|
|
|
049c96 |
|
|
|
049c96 |
diff --git a/man/man8/ip-link.8.in b/man/man8/ip-link.8.in
|
|
|
049c96 |
index 88e014b..4614ba3 100644
|
|
|
049c96 |
--- a/man/man8/ip-link.8.in
|
|
|
049c96 |
+++ b/man/man8/ip-link.8.in
|
|
|
049c96 |
@@ -651,6 +651,56 @@ the following additional arguments are supported:
|
|
|
049c96 |
.BI mode " MODE "
|
|
|
049c96 |
- specifies the mode (datagram or connected) to use.
|
|
|
049c96 |
|
|
|
049c96 |
+.TP
|
|
|
049c96 |
+MACVLAN and MACVTAP Type Support
|
|
|
049c96 |
+For a link of type
|
|
|
049c96 |
+.I MACVLAN
|
|
|
049c96 |
+or
|
|
|
049c96 |
+.I MACVTAP
|
|
|
049c96 |
+the following additional arguments are supported:
|
|
|
049c96 |
+
|
|
|
049c96 |
+.BI "ip link add link " DEVICE " name " NAME
|
|
|
049c96 |
+.BR type " { " macvlan " | " macvtap " } "
|
|
|
049c96 |
+.BR mode " { " private " | " vepa " | " bridge " | " passthru
|
|
|
049c96 |
+.BR " [ " nopromisc " ] } "
|
|
|
049c96 |
+
|
|
|
049c96 |
+.in +8
|
|
|
049c96 |
+.sp
|
|
|
049c96 |
+.BR type " { " macvlan " | " macvtap " } "
|
|
|
049c96 |
+- specifies the link type to use.
|
|
|
049c96 |
+.BR macvlan " creates just a virtual interface, while "
|
|
|
049c96 |
+.BR macvtap " in addition creates a character device "
|
|
|
049c96 |
+.BR /dev/tapX " to be used just like a " tuntap " device."
|
|
|
049c96 |
+
|
|
|
049c96 |
+.B mode private
|
|
|
049c96 |
+- Do not allow communication between
|
|
|
049c96 |
+.B macvlan
|
|
|
049c96 |
+instances on the same physical interface, even if the external switch supports
|
|
|
049c96 |
+hairpin mode.
|
|
|
049c96 |
+
|
|
|
049c96 |
+.B mode vepa
|
|
|
049c96 |
+- Virtual Ethernet Port Aggregator mode. Data from one
|
|
|
049c96 |
+.B macvlan
|
|
|
049c96 |
+instance to the other on the same physical interface is transmitted over the
|
|
|
049c96 |
+physical interface. Either the attached switch needs to support hairpin mode,
|
|
|
049c96 |
+or there must be a TCP/IP router forwarding the packets in order to allow
|
|
|
049c96 |
+communication. This is the default mode.
|
|
|
049c96 |
+
|
|
|
049c96 |
+.B mode bridge
|
|
|
049c96 |
+- In bridge mode, all endpoints are directly connected to each other,
|
|
|
049c96 |
+communication is not redirected through the physical interface's peer.
|
|
|
049c96 |
+
|
|
|
049c96 |
+.BR mode " " passthru " [ " nopromisc " ] "
|
|
|
049c96 |
+- This mode gives more power to a single endpoint, usually in
|
|
|
049c96 |
+.BR macvtap " mode. It is not allowed for more than one endpoint on the same "
|
|
|
049c96 |
+physical interface. All traffic will be forwarded to this endpoint, allowing
|
|
|
049c96 |
+virtio guests to change MAC address or set promiscuous mode in order to bridge
|
|
|
049c96 |
+the interface or create vlan interfaces on top of it. By default, this mode
|
|
|
049c96 |
+forces the underlying interface into promiscuous mode. Passing the
|
|
|
049c96 |
+.BR nopromisc " flag prevents this, so the promisc flag may be controlled "
|
|
|
049c96 |
+using standard tools.
|
|
|
049c96 |
+.in -8
|
|
|
049c96 |
+
|
|
|
049c96 |
.SS ip link delete - delete virtual link
|
|
|
049c96 |
.I DEVICE
|
|
|
049c96 |
specifies the virtual device to act operate on.
|
|
|
049c96 |
--
|
|
|
049c96 |
1.8.3.1
|
|
|
049c96 |
|