First check in - not complete! The ifup script is functional though.
This commit is contained in:
98
SRC/ifup.8
Normal file
98
SRC/ifup.8
Normal file
@@ -0,0 +1,98 @@
|
||||
.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)
|
||||
Reference in New Issue
Block a user