]> git.proxmox.com Git - mirror_ifupdown2.git/blame - ifupdown2/man.rst/ifreload.8.rst
Document exclude (-X) option in ifreload
[mirror_ifupdown2.git] / ifupdown2 / man.rst / ifreload.8.rst
CommitLineData
2c8c4ce7
RP
1========
2ifreload
3========
4
5--------------------------------------
6reload network interface configuration
7--------------------------------------
8
9:Author: Roopa Prabhu <roopa@cumulusnetworks.com>
10:Date: 2014-02-05
11:Copyright: Copyright 2014 Cumulus Networks, Inc. All rights reserved.
12:Version: 0.1
13:Manual section: 8
14
15SYNOPSIS
16========
f82758bf 17 ifreload [-h] (-a|-c) [-v] [-d] [-f] [-n]
2c8c4ce7
RP
18
19DESCRIPTION
20===========
21 reloads network **interfaces(5)** file **/etc/network/interfaces**.
22
71748f7b 23 Runs **ifdown** on interfaces that were removed from the file and
2c8c4ce7
RP
24 subsequently runs **ifup** on all interfaces.
25
71748f7b
RP
26 When removing an interface (iface section) from the interfaces file
27 please make sure all its references are removed as well. Similarly
28 when renaming an interface, please make sure all references to the
29 interface are changed to the new name. Renaming an interface
30 in the interfaces file results in ifdown of the old and ifup
31 of the interface with the new name.
2c8c4ce7 32
f82758bf
RP
33 If you do not wish to execute **down** on any interfaces, but only **up** on
34 interfaces that were already **up**, please see the **--currently-up**
35 option below.
36
2c8c4ce7
RP
37
38OPTIONS
39=======
40 -h, --help show this help message and exit
41
42 -a, --all process all interfaces marked "auto"
43
44 -v, --verbose verbose
45
46 -d, --debug output debug info
47
48 -f, --force force run all operations
49
f82758bf
RP
50 -c, --currently-up only reload auto and other interfaces that are
51 currently up. This can be used as a non-disruptive
52 alternative to -a because it will not down any
53 interfaces
54
19589a0e
ST
55 -X EXCLUDEPATS, --exclude EXCLUDEPATS
56 Exclude interfaces from the list of interfaces to
57 operate on. Can be specified multiple times
58
59
2c8c4ce7
RP
60EXAMPLES
61========
62 # reload all auto interfaces in **interfaces(5)** file
63
64 **ifreload -a**
65
66 # reload all interfaces using service command
67
68 **service networking reload**
69
f82758bf
RP
70 # reload all currently up interfaces without bringing any interfaces down
71
72 **service networking reload-currently-up**
73
2c8c4ce7
RP
74SEE ALSO
75========
76 ifup(8),
77 ifdown(8),
78 ifquery(8),
79 interfaces(5),
80 ifupdown-addons-interfaces(5)