99 lines
2.4 KiB
Groff
99 lines
2.4 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
|
|
.br
|
|
ifquery \- view current state of interfaces
|
|
.SH SYNOPSIS
|
|
.B ifup
|
|
\f |
|
|
.B ifdown
|
|
\f |
|
|
.B ifreload
|
|
\f |
|
|
.B ifquery
|
|
\f <OPTIONS> <INTERFACES>
|
|
.SH DESCRIPTION
|
|
The
|
|
.BR ifup " and " ifdown
|
|
commands may be used to configure (or, respectively, 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."
|
|
.BR ifquery " may be used to display the running configuration."
|
|
.SH OPTIONS
|
|
A summary of options is included below.
|
|
.TP
|
|
.BR \-a ", " \-\-all
|
|
If given to \fBifup\fP, affect all interfaces marked \fBauto\fP.
|
|
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 ", " \-\-help
|
|
Show summary of options.
|
|
.TP
|
|
.BR \-n ", " \-\-no\-act
|
|
Don't configure any interfaces or run any "up" or "down" commands.
|
|
.TP
|
|
.BR \-V ", " \-\-version
|
|
Show copyright and version information.
|
|
.TP
|
|
.BR \-v ", " \-\-verbose
|
|
Show commands as they are executed.
|
|
.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.
|
|
.TP
|
|
.B ifquery eth0
|
|
Print the running configuration of eth0
|
|
.SH NOTES
|
|
.BR ifup ,
|
|
.BR ifdown ,
|
|
.BR ifreload ,
|
|
and
|
|
.BR ifquery
|
|
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.
|
|
.P
|
|
When invoked a check will be performed to verify that there
|
|
are no other instances running. If another instance is
|
|
detected the program will exit with an error.
|
|
.SH FILES
|
|
.TP
|
|
.I /etc/network.conf
|
|
definitions of network interfaces
|
|
See
|
|
.BR network.conf (5)
|
|
for more information.
|
|
.TP
|
|
.I /run/network/ifstate
|
|
current state of network interfaces
|
|
.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)
|