.\" Man page generated from reStructuredText.
.
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.TH "IFUP" 8 "2014-02-05" "0.1" ""
.SH NAME
ifup \- network interface management commands
.SH NAME
.INDENT 0.0
.INDENT 3.5
\fBifup\fP \- bring a network interface up
.sp
\fBifdown\fP \- take a network interface down
.UNINDENT
.UNINDENT
.SH SYNOPSIS
.INDENT 0.0
.INDENT 3.5
.INDENT 0.0
.TP
.B ifup [\-h] [\-a] [\-v] [\-d] [\-\-allow CLASS] [\-\-with\-depends]
\fB[\-X EXCLUDEPATS] [\-f] [\-n] [\-s] [\-\-print\-dependency {list,dot}]\fP
\fB[IFACE [IFACE ...]]\fP
.TP
.B ifdown [\-h] [\-a] [\-v] [\-d] [\-\-allow CLASS] [\-\-with\-depends]
\fB[\-X EXCLUDEPATS] [\-f] [\-n] [\-\-print\-dependency {list,dot}]\fP
\fB[IFACE [IFACE ...]]\fP
.UNINDENT
.UNINDENT
.UNINDENT
.SH DESCRIPTION
.INDENT 0.0
.INDENT 3.5
\fBifup\fP and \fBifdown\fP commands can be used to configure (or, respectively,
deconfigure) network interfaces based on interface definitions in the
config file ifupdown2.conf (defaults to \fB/etc/network/interfaces/\fP file).
.sp
\fBifquery(8)\fP maybe used in conjunction with \fBifup\fP and \fBifdown\fP
commands to query and validate applied/running configuration.
.sp
\fBifup\fP always works on the current \fBinterfaces(5)\fP file defined in ifupdown2.conf
(default \fB/etc/network/interfaces\fP). \fBifdown\fP works on the last applied interface
configuration.
.sp
\fBifup\fP on an already ifup\(aqed 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.
.sp
\fBifup\fP and \fBifdown\fP understands interface dependency order.
.sp
For logical interfaces like vlans, bridges, bonds, \fBifup\fP creates the
interface and \fBifdown\fP deletes the interface. Use \fB\-\-admin\-state\fP
option if you only want to administratively bring the interface up/down.
.sp
When \fBifup\fP and \fBifdown\fP are used with interfaces on command line,
they must be have a \fBiface\fP section in the \fBinterfaces(5)\fP file.
.UNINDENT
.UNINDENT
.SH OPTIONS
.INDENT 0.0
.INDENT 3.5
positional arguments:
.sp
\fBIFACE\fP  interface list separated by spaces. \fBIFACE\fP list and \fB\(aq\-a\(aq\fP
argument are mutually exclusive.
.sp
optional arguments:
.INDENT 0.0
.TP
.B  \-h\fP,\fB  \-\-help
show this help message and exit
.TP
.B  \-a\fP,\fB  \-\-all
process all interfaces marked "auto"
.TP
.B  \-v\fP,\fB  \-\-verbose
verbose
.TP
.B  \-d\fP,\fB  \-\-debug
output debug info
.TP
.BI \-\-allow \ CLASS
ignore non\-"allow\-CLASS" interfaces
.TP
.B  \-w\fP,\fB  \-\-with\-depends
run with all dependent interfaces. This option
is redundant when \-a is specified. When \(aq\-a\(aq is
specified, interfaces are always executed in
dependency order.
.TP
.BI \-X \ EXCLUDEPATS\fR,\fB \ \-\-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.
.TP
.BI \-i \ INTERFACESFILE\fR,\fB \ \-\-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).
.UNINDENT
.INDENT 0.0
.TP
.B \-t {native,json}, \-\-interfaces\-format {native,json}
interfaces file format
.UNINDENT
.INDENT 0.0
.TP
.B  \-f\fP,\fB  \-\-force
force run all operations
.TP
.B  \-n\fP,\fB  \-\-no\-act
print out what would happen, but don\(aqt do it
.UNINDENT
.INDENT 0.0
.TP
.B \-p, \-\-print\-dependency {list,dot}
print iface dependency in list or dot format
.UNINDENT
.INDENT 0.0
.TP
.B  \-m\fP,\fB  \-\-admin\-state\fP,\fB  \-\-no\-scripts
don\(aqt run any addon modules/scripts. Only bring
the interface administratively up/down
.TP
.B  \-u\fP,\fB  \-\-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
.TP
.B  \-s\fP,\fB  \-\-syntax\-check
Only run the interfaces file parser
.UNINDENT
.UNINDENT
.UNINDENT
.SH EXAMPLES
.INDENT 0.0
.INDENT 3.5
# bringing up all interfaces
.INDENT 0.0
.INDENT 3.5
\fBifup \-a\fP
.UNINDENT
.UNINDENT
.sp
# bringing up interface list
.INDENT 0.0
.INDENT 3.5
\fBifup swp1 swp2\fP
.UNINDENT
.UNINDENT
.sp
# bringing up interface with its dependents
.INDENT 0.0
.INDENT 3.5
\fBifup br0 \-\-with\-depends\fP
.UNINDENT
.UNINDENT
.sp
# bringing down all interfaces
.INDENT 0.0
.INDENT 3.5
\fBifdown \-a\fP
.UNINDENT
.UNINDENT
.sp
# bringing down a single interface
.INDENT 0.0
.INDENT 3.5
\fBifdown swp1\fP
.UNINDENT
.UNINDENT
.sp
# excluding interfaces using \-X option
.INDENT 0.0
.INDENT 3.5
\fBifdown \-X eth0 \-a\fP
.sp
\fBifup \-X eth0 \-a\fP
.sp
\fBifdown \-X eth0 \-X lo \-a\fP
.UNINDENT
.UNINDENT
.sp
# using verbose \-v option to see what is going on
.INDENT 0.0
.INDENT 3.5
\fBifup \-v \-a\fP
.UNINDENT
.UNINDENT
.sp
# using debug \-d option to see more of what is going on
.INDENT 0.0
.INDENT 3.5
\fBifup \-d \-a\fP
.UNINDENT
.UNINDENT
.sp
# ignore errors
.INDENT 0.0
.INDENT 3.5
\fBifup \-a \-f\fP
.sp
\fBifdown \-a \-f\fP
.UNINDENT
.UNINDENT
.sp
# run ifdown and ifup on all interfaces using service command/init script
.INDENT 0.0
.INDENT 3.5
\fBservice networking restart\fP
.UNINDENT
.UNINDENT
.sp
# run ifup on all interfaces using service command/init script
.INDENT 0.0
.INDENT 3.5
\fBservice networking start\fP
.UNINDENT
.UNINDENT
.sp
# ifdown on all interfaces using service command/init script
.INDENT 0.0
.INDENT 3.5
\fBservice networking stop\fP
.UNINDENT
.UNINDENT
.sp
# To run ifup/ifdown on only interfaces that changed see \fBifreload(8)\fP
.UNINDENT
.UNINDENT
.SH SEE ALSO
.INDENT 0.0
.INDENT 3.5
ifquery(8),
ifreload(8),
interfaces(5),
ifupdown\-addons\-interfaces(5)
.UNINDENT
.UNINDENT
.SH AUTHOR
Roopa Prabhu <roopa@cumulusnetworks.com>
.SH COPYRIGHT
Copyright 2014 Cumulus Networks, Inc.  All rights reserved.
.\" Generated by docutils manpage writer.
.