naccyde / rpms / iproute

Forked from rpms/iproute 9 months ago
Clone

Blame SOURCES/0212-ip-address.8-Document-autojoin-flag.patch

049c96
From 88f9c8ccf815fdc170e0f160335acdaacadc669e Mon Sep 17 00:00:00 2001
049c96
From: Phil Sutter <psutter@redhat.com>
049c96
Date: Wed, 20 Jul 2016 22:59:33 +0200
049c96
Subject: [PATCH] ip-address.8: Document autojoin flag
049c96
049c96
Bugzilla: https://bugzilla.redhat.com/show_bug.cgi?id=1333513
049c96
Upstream Status: iproute2.git commit 6acf086c2bf3e
049c96
049c96
commit 6acf086c2bf3e94ceed984acd39936e216342e16
049c96
Author: Phil Sutter <phil@nwl.cc>
049c96
Date:   Tue Jul 12 09:56:16 2016 +0200
049c96
049c96
    ip-address.8: Document autojoin flag
049c96
049c96
    Description copied from related kernel support commit message with a
049c96
    little tailoring to fit.
049c96
049c96
    While at it, fix font of non-terminal CONFFLAG-LIST in synopsis.
049c96
049c96
    Signed-off-by: Phil Sutter <phil@nwl.cc>
049c96
---
049c96
 man/man8/ip-address.8.in | 25 +++++++++++++++++++++++--
049c96
 1 file changed, 23 insertions(+), 2 deletions(-)
049c96
049c96
diff --git a/man/man8/ip-address.8.in b/man/man8/ip-address.8.in
049c96
index 8d34adb..c954ab3 100644
049c96
--- a/man/man8/ip-address.8.in
049c96
+++ b/man/man8/ip-address.8.in
049c96
@@ -75,14 +75,15 @@ ip-address \- protocol address management
049c96
 .IR FLAG " := "
049c96
 .RB "[ " permanent " | " dynamic " | " secondary " | " primary " |"
049c96
 .RB [ - ] tentative " | [" - ] deprecated " | [" - ] dadfailed " |"
049c96
-.BR temporary " | " CONFFLAG-LIST " ]"
049c96
+.BR temporary " |"
049c96
+.IR CONFFLAG-LIST " ]"
049c96
 
049c96
 .ti -8
049c96
 .IR CONFFLAG-LIST " := [ "  CONFFLAG-LIST " ] " CONFFLAG
049c96
 
049c96
 .ti -8
049c96
 .IR CONFFLAG " := "
049c96
-.RB "[ " home " | " mngtmpaddr " | " nodad " | " noprefixroute " ]"
049c96
+.RB "[ " home " | " mngtmpaddr " | " nodad " | " noprefixroute " | " autojoin " ]"
049c96
 
049c96
 .ti -8
049c96
 .IR LIFETIME " := [ "
049c96
@@ -244,6 +245,26 @@ address, and don't search for one to delete when removing the address. Changing
049c96
 an address to add this flag will remove the automatically added prefix route,
049c96
 changing it to remove this flag will create the prefix route automatically.
049c96
 
049c96
+.TP
049c96
+.B autojoin
049c96
+Joining multicast groups on Ethernet level via
049c96
+.B "ip maddr"
049c96
+command does not work if connected to an Ethernet switch that does IGMP
049c96
+snooping since the switch would not replicate multicast packets on ports that
049c96
+did not have IGMP reports for the multicast addresses.
049c96
+
049c96
+Linux VXLAN interfaces created via
049c96
+.B "ip link add vxlan"
049c96
+have the
049c96
+.B group
049c96
+option that enables them to do the required join.
049c96
+
049c96
+Using the
049c96
+.B autojoin
049c96
+flag when adding a multicast address enables similar functionality for
049c96
+Openvswitch VXLAN interfaces as well as other tunneling mechanisms that need to
049c96
+receive multicast traffic.
049c96
+
049c96
 .SS ip address delete - delete protocol address
049c96
 .B Arguments:
049c96
 coincide with the arguments of
049c96
-- 
049c96
1.8.3.1
049c96