From 4dcac660c27898d9fd369e34063eb79082baa851 Mon Sep 17 00:00:00 2001 From: Sam Tannous Date: Thu, 30 Jul 2015 11:15:17 -0400 Subject: [PATCH] Document --exclude option a little better for ifupdown2 Ticket: CM-6587 Reviewed By: roopa Testing Done: checked man paged If we do an ifdown on all ports and try to exclude a bond or bridge port. But we also have an iface defined for swp1 or swp4 (even if these are empty). The lower interfaces will not be excluded. So if we do an "ifdown -a -X bridge", swp ports in the bridge or bond will go down effectively bringing a bond or bridge down. This patch simply adds some documentation to the man pages. ifupdown2 never follows dependents if the user has given an interface list (unless explicitly requested with --with-depends option which is available with some options). --- man.rst/ifquery.8.rst | 4 ++++ man.rst/ifreload.8.rst | 4 ++++ man.rst/ifup.8.rst | 4 ++++ 3 files changed, 12 insertions(+) diff --git a/man.rst/ifquery.8.rst b/man.rst/ifquery.8.rst index ba443ce..731bf1c 100644 --- a/man.rst/ifquery.8.rst +++ b/man.rst/ifquery.8.rst @@ -60,6 +60,10 @@ OPTIONS -X EXCLUDEPATS, --exclude EXCLUDEPATS Exclude interfaces from the list of interfaces to operate on. Can be specified multiple times + If the excluded interface has dependent interfaces, + (e.g. a bridge or a bond with multiple enslaved interfaces) + then each dependent interface must be specified in order + to be excluded. -i INTERFACESFILE, --interfaces INTERFACESFILE Use interfaces file instead of default diff --git a/man.rst/ifreload.8.rst b/man.rst/ifreload.8.rst index f26442b..4695e5b 100644 --- a/man.rst/ifreload.8.rst +++ b/man.rst/ifreload.8.rst @@ -55,6 +55,10 @@ OPTIONS -X EXCLUDEPATS, --exclude EXCLUDEPATS Exclude interfaces from the list of interfaces to operate on. Can be specified multiple times + If the excluded interface has dependent interfaces, + (e.g. a bridge or a bond with multiple enslaved interfaces) + then each dependent interface must be specified in order + to be excluded. EXAMPLES diff --git a/man.rst/ifup.8.rst b/man.rst/ifup.8.rst index 407b44b..9fdf51c 100644 --- a/man.rst/ifup.8.rst +++ b/man.rst/ifup.8.rst @@ -82,6 +82,10 @@ OPTIONS -X EXCLUDEPATS, --exclude EXCLUDEPATS Exclude interfaces from the list of interfaces to operate on. Can be specified multiple times + If the excluded interface has dependent interfaces, + (e.g. a bridge or a bond with multiple enslaved interfaces) + then each dependent interface must be specified in order + to be excluded. -i INTERFACESFILE, --interfaces INTERFACESFILE Use interfaces file instead of default