mirror of
https://github.com/CumulusNetworks/ifupdown2.git
synced 2024-05-06 15:54:50 +00:00
e37ad4a607
Ticket: CM-1438 Reviewed By: Testing Done: There are a few known issues listed in the TODO and KNOWN_ISSUES files
133 lines
3.7 KiB
ReStructuredText
133 lines
3.7 KiB
ReStructuredText
====
|
|
ifup
|
|
====
|
|
|
|
-------------------------------------
|
|
network interface management commands
|
|
-------------------------------------
|
|
|
|
:Author: roopa@cumulusnetworks.com
|
|
:Date: 2014-02-05
|
|
:Copyright: Copyright 2014 Cumulus Networks, Inc. All rights reserved.
|
|
:Version: 0.1
|
|
:Manual section: 8
|
|
|
|
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] [--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
|
|
===========
|
|
The ifup and ifdown commands may be used to configure (or, respectively,
|
|
deconfigure) network interfaces based on interface definitions in the
|
|
file /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 under
|
|
/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 whereever 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.
|
|
|
|
|
|
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
|
|
|
|
--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
|
|
|
|
-f, --force force run all operations
|
|
|
|
-n, --no-act print out what would happen,but don't do it
|
|
|
|
--print-dependency {list,dot} print iface dependency in list or dot format.
|
|
|
|
CHEATSHEET
|
|
==========
|
|
# 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
|
|
|
|
# ifdown and ifup on all interfaces using service command/init script
|
|
service networking restart
|
|
|
|
# ifup on all interfaces using service command/init script
|
|
service networking start
|
|
|
|
# ifdown on all interfaces using service command/init script
|
|
service networking stop
|
|
|
|
# Also see ifreload(8)
|
|
|
|
SEE ALSO
|
|
========
|
|
ifquery(8)
|
|
ifreload(8)
|
|
interfaces(5)
|
|
interfaces-addons(5)
|