mirror/CumulusNetworks-ifupdown2
1
0
Fork 0
mirror of https://github.com/CumulusNetworks/ifupdown2.git synced 2024-05-06 15:54:50 +00:00
Code
CumulusNetworks-ifupdown2/ifupdown2/man/ifreload.8.rst

94 lines
3.1 KiB
ReStructuredText
Raw Normal View History

cleanup, documentation and enable ifupdown2 by default Ticket: CM-1438 Reviewed By: Testing Done: There are a few known issues listed in the TODO and KNOWN_ISSUES files
2014-02-14 09:55:19 -08:00
========
ifreload
========
--------------------------------------
reload network interface configuration
--------------------------------------
prefix ethtool attributes with "link-" to be compatible with native ifupdown + documentation fixes Ticket: CM-3000 Reviewed By: trivial + doc related Testing Done: Ran precommit
2014-06-12 06:27:29 -07:00
:Author: Roopa Prabhu <roopa@cumulusnetworks.com>
cleanup, documentation and enable ifupdown2 by default Ticket: CM-1438 Reviewed By: Testing Done: There are a few known issues listed in the TODO and KNOWN_ISSUES files
2014-02-14 09:55:19 -08:00
:Date: 2014-02-05
:Copyright: Copyright 2014 Cumulus Networks, Inc. All rights reserved.
:Version: 0.1
:Manual section: 8
SYNOPSIS
========
ifupdown2: syntax-check: exit with 1 if syntax errors Ticket: CM-7995 Reviewed By: CCR-3850 Testing Done: Tested exit code on syntax errors This patch adds members 'errors' and 'warns' to networkinterfaces.py to track errors and warns during parsing interfaces file. This patch also adds --syntax-check option to ifreload given people seem to use ifreload more than ifup these days. $ ifreload --syntax-check -a error: /etc/network/interfaces: iface swp1.200: unsupported keyword (roopa-attr) $ echo $? 1 (cherry picked from commit e643a136fcf5d387ff0f9a31cb6a6af4983e1012)
2015-11-22 16:26:14 -08:00
ifreload [-h] (-a|-c) [-v] [-d] [-f] [-n] [-s]
cleanup, documentation and enable ifupdown2 by default Ticket: CM-1438 Reviewed By: Testing Done: There are a few known issues listed in the TODO and KNOWN_ISSUES files
2014-02-14 09:55:19 -08:00
DESCRIPTION
===========
add param in ifupdown2.conf to prevent fupdown2 users from specify interface config file on the CLI Ticket: CM-7066 Reviewed By: scotte,roopa,olson Testing Done: Unit testing and regression testing This patch does two things: 1. It moves the interfaces config file name to the ifupdown2.conf file in /etc/network/ifupdown2. This should allow administrators to specify a config file location different from the default and allow subsets of users to use it without giving them access to specifying their own with the -i option in ifup/ifdown. 2. It also adds a new config setting called "disable_cli_interfacesfile" used to prevent users from specifying their own interfaces file. This defaults to "1" (even if it is not configured). Note: this new default takes away users ability to specify an interfaces file. This should close the vulnerability where users could specify their own interfaces file and add arbitrary user commands. This leaves the shell=True option in the user commands add-on module since the ifup/ifdown/ifreload/ifquery commands already require root access to run and the interfaces config file also requires root access to modify.
2015-08-20 22:59:44 -04:00
reloads network **interfaces(5)** file **/etc/network/interfaces**
or config file defined in ifupdown2.conf file.
cleanup, documentation and enable ifupdown2 by default Ticket: CM-1438 Reviewed By: Testing Done: There are a few known issues listed in the TODO and KNOWN_ISSUES files
2014-02-14 09:55:19 -08:00
Fix ifreload man page to include the new behaviour where it does not down all changed interfaces Ticket: CM-5819 Reviewed By: trivial Testing Done: Tested man page (cherry picked from commit 93ecf73b22d317dcf2a0924030f34f008fc25c33)
2015-04-28 05:38:15 -07:00
Runs **ifdown** on interfaces that were removed from the file and
prefix ethtool attributes with "link-" to be compatible with native ifupdown + documentation fixes Ticket: CM-3000 Reviewed By: trivial + doc related Testing Done: Ran precommit
2014-06-12 06:27:29 -07:00
subsequently runs **ifup** on all interfaces.
Remove batch support when deleting addresses. batching code does not update the cache yet and that can cause problems during add Ticket: CM-2491 Reviewed By: Testing Done: Still working on the cache update support during batching.
2014-03-27 16:36:54 -07:00
man: update ifreload man page to indicate that ifreload is non-disruptive Ticket: CM-12655 Reviewed By: julien Testing Done: tested build and help Signed-off-by: Roopa Prabhu <roopa@cumulusnetworks.com>
2016-11-17 09:19:53 -08:00
ifreload is non-disruptive. It will fix running config to match what
is configured in the interfaces file without bringing the interface
down. There are some cases where on linux an interface config cannot
be applied unless the interface is brought down...eg: change of mac
address and a few bond attributes. For such attribute changes, it may
flap the interface only if the linux kernel requires it to.
Fix ifreload man page to include the new behaviour where it does not down all changed interfaces Ticket: CM-5819 Reviewed By: trivial Testing Done: Tested man page (cherry picked from commit 93ecf73b22d317dcf2a0924030f34f008fc25c33)
2015-04-28 05:38:15 -07:00
When removing an interface (iface section) from the interfaces file
please make sure all its references are removed as well. Similarly
when renaming an interface, please make sure all references to the
interface are changed to the new name. Renaming an interface
in the interfaces file results in ifdown of the old and ifup
of the interface with the new name.
Remove batch support when deleting addresses. batching code does not update the cache yet and that can cause problems during add Ticket: CM-2491 Reviewed By: Testing Done: Still working on the cache update support during batching.
2014-03-27 16:36:54 -07:00
Document ifreload new option + add it into init.d networking script Ticket: Reviewed By: trivial Testing Done: Tested build/install/boot + ifupdown2 sanity
2015-01-03 00:27:35 -08:00
If you do not wish to execute **down** on any interfaces, but only **up** on
interfaces that were already **up**, please see the **--currently-up**
option below.
cleanup, documentation and enable ifupdown2 by default Ticket: CM-1438 Reviewed By: Testing Done: There are a few known issues listed in the TODO and KNOWN_ISSUES files
2014-02-14 09:55:19 -08:00
OPTIONS
=======
-h, --help show this help message and exit
-a, --all process all interfaces marked "auto"
-v, --verbose verbose
-d, --debug output debug info
-f, --force force run all operations
ifupdown2 2.0.0 release This is a major update coming all at once from master-next branch master-next branch was started with --orphan option which is basically a new branch without history. The major changes are: - repackaging - cleanup the directory tree - rewritte setup.py to allow install from deb file or pypi (pip install) - add a Makefile to make things (like building a deb) easier - review all debian files Signed-off-by: Julien Fortin <julien@cumulusnetworks.com>
2018-12-13 11:43:32 -08:00
-c, --currently-up Reload the configuration for all interfaces which
are currently up regardless of whether an interface
has "auto <interface>" configuration within the
/etc/network/interfaces file.
Document ifreload new option + add it into init.d networking script Ticket: Reviewed By: trivial Testing Done: Tested build/install/boot + ifupdown2 sanity
2015-01-03 00:27:35 -08:00
Document exclude (-X) option in ifreload Ticket: CM-5419 Reviewed By: Trivial Testing Done: built ifupdown2 deb and tested on switch This patch adds man page mention of undocumented (but working) option to exclude interfaces from a reload (-X option) (cherry picked from commit 0358905782a4c0290a967d6f730fdcb27f2af3d9)
2015-05-20 10:15:39 -04:00
-X EXCLUDEPATS, --exclude EXCLUDEPATS
Exclude interfaces from the list of interfaces to
operate on. Can be specified multiple times
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).
2015-07-30 11:15:17 -04:00
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.
Document exclude (-X) option in ifreload Ticket: CM-5419 Reviewed By: Trivial Testing Done: built ifupdown2 deb and tested on switch This patch adds man page mention of undocumented (but working) option to exclude interfaces from a reload (-X option) (cherry picked from commit 0358905782a4c0290a967d6f730fdcb27f2af3d9)
2015-05-20 10:15:39 -04:00
ifupdown2: syntax-check: exit with 1 if syntax errors Ticket: CM-7995 Reviewed By: CCR-3850 Testing Done: Tested exit code on syntax errors This patch adds members 'errors' and 'warns' to networkinterfaces.py to track errors and warns during parsing interfaces file. This patch also adds --syntax-check option to ifreload given people seem to use ifreload more than ifup these days. $ ifreload --syntax-check -a error: /etc/network/interfaces: iface swp1.200: unsupported keyword (roopa-attr) $ echo $? 1 (cherry picked from commit e643a136fcf5d387ff0f9a31cb6a6af4983e1012)
2015-11-22 16:26:14 -08:00
-s, --syntax-check Only run the interfaces file parser
Document exclude (-X) option in ifreload Ticket: CM-5419 Reviewed By: Trivial Testing Done: built ifupdown2 deb and tested on switch This patch adds man page mention of undocumented (but working) option to exclude interfaces from a reload (-X option) (cherry picked from commit 0358905782a4c0290a967d6f730fdcb27f2af3d9)
2015-05-20 10:15:39 -04:00
Remove batch support when deleting addresses. batching code does not update the cache yet and that can cause problems during add Ticket: CM-2491 Reviewed By: Testing Done: Still working on the cache update support during batching.
2014-03-27 16:36:54 -07:00
EXAMPLES
========
man page cleanup + cleanup + minor fixes Ticket: CM-1438 Reviewed By: Testing Done: Tested ifupdown sanity
2014-04-25 16:09:14 -07:00
# reload all auto interfaces in **interfaces(5)** file
**ifreload -a**
cleanup, documentation and enable ifupdown2 by default Ticket: CM-1438 Reviewed By: Testing Done: There are a few known issues listed in the TODO and KNOWN_ISSUES files
2014-02-14 09:55:19 -08:00
# reload all interfaces using service command
man page cleanup + cleanup + minor fixes Ticket: CM-1438 Reviewed By: Testing Done: Tested ifupdown sanity
2014-04-25 16:09:14 -07:00
**service networking reload**
cleanup, documentation and enable ifupdown2 by default Ticket: CM-1438 Reviewed By: Testing Done: There are a few known issues listed in the TODO and KNOWN_ISSUES files
2014-02-14 09:55:19 -08:00
Document ifreload new option + add it into init.d networking script Ticket: Reviewed By: trivial Testing Done: Tested build/install/boot + ifupdown2 sanity
2015-01-03 00:27:35 -08:00
# reload all currently up interfaces without bringing any interfaces down
**service networking reload-currently-up**
cleanup, documentation and enable ifupdown2 by default Ticket: CM-1438 Reviewed By: Testing Done: There are a few known issues listed in the TODO and KNOWN_ISSUES files
2014-02-14 09:55:19 -08:00
SEE ALSO
========
man page cleanup + cleanup + minor fixes Ticket: CM-1438 Reviewed By: Testing Done: Tested ifupdown sanity
2014-04-25 16:09:14 -07:00
ifup(8),
ifdown(8),
ifquery(8),
interfaces(5),
remove native ifupdown support from bridge-utils, vlan, ifenslave and mstpctl + some ifupdown2 documentation cleanup Ticket: CM-1438 Reviewed By: Testing Done: ifupdown2 sanity testing Conflicts: patches/bridge-utils/series
2014-05-29 12:43:03 -07:00
ifupdown-addons-interfaces(5)
Copy Permalink