]> git.proxmox.com Git - mirror_ifupdown2.git/blob - ifupdown2/man.rst/ifreload.8.rst
Document exclude (-X) option in ifreload
[mirror_ifupdown2.git] / ifupdown2 / man.rst / ifreload.8.rst
1 ========
2 ifreload
3 ========
4
5 --------------------------------------
6 reload 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
15 SYNOPSIS
16 ========
17 ifreload [-h] (-a|-c) [-v] [-d] [-f] [-n]
18
19 DESCRIPTION
20 ===========
21 reloads network **interfaces(5)** file **/etc/network/interfaces**.
22
23 Runs **ifdown** on interfaces that were removed from the file and
24 subsequently runs **ifup** on all interfaces.
25
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.
32
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
37
38 OPTIONS
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
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
55 -X EXCLUDEPATS, --exclude EXCLUDEPATS
56 Exclude interfaces from the list of interfaces to
57 operate on. Can be specified multiple times
58
59
60 EXAMPLES
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
70 # reload all currently up interfaces without bringing any interfaces down
71
72 **service networking reload-currently-up**
73
74 SEE ALSO
75 ========
76 ifup(8),
77 ifdown(8),
78 ifquery(8),
79 interfaces(5),
80 ifupdown-addons-interfaces(5)