Jay Larson
68281843d3
* Completely re-written as shell script * Modified documentation to better reflect reality * Removed the rather useless 'ifquery' tool
83 lines
1.9 KiB
Groff
83 lines
1.9 KiB
Groff
.TH ifup 8 "May 2017" "iftools" "Linux System Administrator's Manual"
|
|
.SH NAME
|
|
ifup \- bring a network interface up
|
|
.br
|
|
ifdown \- take a network interface down
|
|
.br
|
|
ifreload \- reload interface configuration
|
|
.SH SYNOPSIS
|
|
.B ifup
|
|
\f |
|
|
.B ifdown
|
|
\f |
|
|
.B ifreload
|
|
\f <OPTIONS> <INTERFACES>
|
|
.SH DESCRIPTION
|
|
The
|
|
.BR ifup " and " ifdown
|
|
commands may be used to configure, or deconfigure network
|
|
interfaces based on interface definitions in the file
|
|
.IR /etc/network.conf ". The"
|
|
.BR ifreload " command will perform an ifdown and ifup in one command."
|
|
.SH OPTIONS
|
|
A summary of options is included below.
|
|
.TP
|
|
.BR \-a
|
|
If given to \fBifup\fP, all interfaces marked \fBauto\fP are brought online.
|
|
Interfaces are brought up in the order in which they are defined
|
|
in
|
|
.IR /etc/network.conf .
|
|
If given to \fBifdown\fP, affect all defined interfaces.
|
|
Interfaces are brought down in the order in which they are
|
|
listed in the configuration files.
|
|
.TP
|
|
.BR \-h
|
|
Show summary of options.
|
|
.TP
|
|
.BR \-n
|
|
Take no action, but output commands that would be executed.
|
|
.TP
|
|
.BR \-v
|
|
Show configuration steps as they are taken.
|
|
.TP
|
|
.BR \-V
|
|
Show version information.
|
|
.SH EXAMPLES
|
|
.TP
|
|
.B ifup -a
|
|
Bring up all the interfaces defined with
|
|
.I auto
|
|
in
|
|
.nh
|
|
.I /etc/network.conf
|
|
.TP
|
|
.B ifup eth0
|
|
Bring up interface
|
|
.B eth0
|
|
.TP
|
|
.B ifdown -a
|
|
Bring down all interfaces that are currently up.
|
|
.SH NOTES
|
|
.BR ifup ,
|
|
.BR ifdown ,
|
|
and
|
|
.BR ifreload
|
|
are actually the same program called by different names.
|
|
.P
|
|
The program does not configure network interfaces directly;
|
|
it runs low level utilities such as
|
|
.BR ip
|
|
to do its dirty work.
|
|
.SH FILES
|
|
.TP
|
|
.I /etc/network.conf
|
|
definitions of network interfaces
|
|
See
|
|
.BR network.conf (5)
|
|
for more information.
|
|
.SH AUTHOR
|
|
iftools was written by Jay Larson <jlarson@snaplinux.org>. The functionality is loosely based on the ifupdown suite written by Anthony Towns <aj@azure.humbug.org.au>.
|
|
.SH SEE ALSO
|
|
.BR network.conf (5),
|
|
.BR ip (8)
|