ifdown(8)
NAME
ifup - network interface management commands
NAME
ifup - bring a network interface up
ifdown - take a network interface down
SYNOPSIS
ifup [-h] [-a] [-v] [-d] [--allow CLASS] [--with-depends]
[-X EXCLUDEPATS] [-f] [-n] [-s] [--print-dependency
{list,dot}] [IFACE [IFACE ...]]
ifdown [-h] [-a] [-v] [-d] [--allow CLASS] [--with-depends]
[-X EXCLUDEPATS] [-f] [-n] [--print-dependency {list,dot}]
[IFACE [IFACE ...]]
DESCRIPTION
ifup and ifdown commands can be used to configure (or, respectively,
deconfigure) network interfaces based on interface definitions in
the config file ifupdown2.conf (defaults to /etc/network/interfaces/
file).
ifquery(8) maybe used in conjunction with ifup and ifdown commands
to query and validate applied/running configuration.
ifup always works on the current interfaces(5) file defined in
ifupdown2.conf (default /etc/network/interfaces). ifdown works on
the last applied interface configuration.
ifup on an already ifup'ed interface will re-apply the
configuration, skipping already applied configuration wherever
possible. In many cases where config commands are idempotent, you
will see that ifup/ifdown will reapply the config even if the
interface already has that config.
ifup and ifdown understands interface dependency order.
For logical interfaces like vlans, bridges, bonds, ifup creates the
interface and ifdown deletes the interface. Use --admin-state option
if you only want to administratively bring the interface up/down.
When ifup and ifdown are used with interfaces on command line, they
must be have a iface section in the interfaces(5) file.
OPTIONS
positional arguments:
IFACE interface list separated by spaces. IFACE list and '-a'
argument are mutually exclusive.
optional arguments:
-h, --help
show this help message and exit
-a, --all
process all interfaces marked "auto"
-v, --verbose
verbose
-d, --debug
output debug info
--allow CLASS
ignore non-"allow-CLASS" interfaces
-w, --with-depends
run with all dependent interfaces. This option is redundant
when -a is specified. When '-a' is specified, interfaces are
always executed in dependency order.
-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
Uses interfaces file instead of default defined in
ifupdown2.conf (default /etc/network/interfaces). Also in
ifupdown2.conf, users are not allowed to specify their own
interfaces file unless disable_cli_interfacesfile is set to 0
(default is 1).
-t {native,json}, --interfaces-format {native,json}
interfaces file format
-f, --force
force run all operations
-n, --no-act
print out what would happen, but don't do it
-p, --print-dependency {list,dot}
print iface dependency in list or dot format
-m, --admin-state, --no-scripts
don't run any addon modules/scripts. Only bring the interface
administratively up/down
-u, --use-current-config
By default ifdown looks at the saved state for interfaces to
bring down. This option allows ifdown to look at the current
interfaces file. Useful when your state file is corrupted or
you want down to use the latest from the interfaces file
-s, --syntax-check
Only run the interfaces file parser
EXAMPLES
# bringing up all interfaces
ifup -a
# bringing up interface list
ifup swp1 swp2
# bringing up interface with its dependents
ifup br0 --with-depends
# bringing down all interfaces
ifdown -a
# bringing down a single interface
ifdown swp1
# excluding interfaces using -X option
ifdown -X eth0 -a
ifup -X eth0 -a
ifdown -X eth0 -X lo -a
# using verbose -v option to see what is going on
ifup -v -a
# using debug -d option to see more of what is going on
ifup -d -a
# ignore errors
ifup -a -f
ifdown -a -f
# run ifdown and ifup on all interfaces using service command/init
script
service networking restart
# run ifup on all interfaces using service command/init script
service networking start
# ifdown on all interfaces using service command/init script
service networking stop
# To run ifup/ifdown on only interfaces that changed see ifreload(8)
SEE ALSO
ifquery(8), ifreload(8), interfaces(5),
ifupdown-addons-interfaces(5)
AUTHOR
Roopa Prabhu <roopa@cumulusnetworks.com>
COPYRIGHT
Copyright 2014 Cumulus Networks, Inc. All rights reserved.
Free and Open Source Software