First check in - not complete! The ifup script is functional though.
This commit is contained in:
89
SRC/network.conf.5
Normal file
89
SRC/network.conf.5
Normal file
@@ -0,0 +1,89 @@
|
||||
.TH network.conf 5 "May 2017" "iftools" "File formats"
|
||||
.SH NAME
|
||||
/etc/network.conf \- network interface configuration for iftools
|
||||
.SH DESCRIPTION
|
||||
/etc/network.conf contains network interface configuration
|
||||
information for the
|
||||
.BR ifup (8)
|
||||
and
|
||||
.BR ifdown (8)
|
||||
commands.
|
||||
This is where you configure how your system is connected to the network.
|
||||
.P
|
||||
Lines starting with `#' are ignored. Note that end-of-line comments are
|
||||
NOT supported, comments must be on a line of their own.
|
||||
.P
|
||||
The file consists of any number of "iface", "auto", and
|
||||
.nh
|
||||
"source\-directory" stanzas. Here is an example:
|
||||
.P
|
||||
.RS
|
||||
.EX
|
||||
auto eth0
|
||||
iface eth0 inet static
|
||||
address 192.168.1.10
|
||||
netmask 255.255.255.0
|
||||
gateway 192.168.1.1
|
||||
|
||||
iface eth1 inet dhcp
|
||||
|
||||
iface eth1:1
|
||||
address 192.168.1.2
|
||||
netmask 255.255.255.0
|
||||
|
||||
source-directory network.d
|
||||
.EE
|
||||
.RE
|
||||
.P
|
||||
Lines beginning with the word "auto" are used to identify the physical
|
||||
interfaces to be brought up when
|
||||
.B ifup
|
||||
is run with the
|
||||
.B \-a
|
||||
option. (This option is used by the system boot scripts.)
|
||||
There can be multiple "auto" stanzas.
|
||||
.B ifup
|
||||
brings the named interfaces up in the order listed.
|
||||
.P
|
||||
Lines beginning with "source-directory" are used to source multiple
|
||||
files at once. All non-dotted files within the directory are sourced
|
||||
in lexical order.
|
||||
.P
|
||||
When sourcing directories, if a path doesn't have a leading slash
|
||||
it's considered relative to the directory containing the network.conf
|
||||
file (/etc). In the example above, files in /etc/network.d are sourced.
|
||||
.P
|
||||
By default, on a freshly installed system, the network.conf file includes
|
||||
a line to source files in the
|
||||
.IR /etc/network.d
|
||||
directory.
|
||||
.P
|
||||
Stanzas defining logical interfaces start with a line consisting of the
|
||||
word "iface" followed by the name of the logical interface. The name
|
||||
should be the name of the physical interface, a colon, and the logical
|
||||
name. This is shown in the example above as eth1:1.
|
||||
.P
|
||||
Additional options can be given on subsequent lines in the stanza.
|
||||
Options are usually indented for clarity (as in the example above)
|
||||
but are not required to be.
|
||||
.P
|
||||
.SH OPTIONS
|
||||
The following additional options are available:
|
||||
.TP
|
||||
.BR macaddr " XX:XX:XX:XX:XX:XX"
|
||||
Set the MAC address to be used by a physical interface. This option
|
||||
cannot be applied to logical interfaces.
|
||||
.TP
|
||||
.BR route " [NETWORK|IP] " via " [GATEWAY]"
|
||||
Specify a gateway for a particular network or IP address. The network
|
||||
or IP address can be specified in CIDR notation. This option is also
|
||||
only available for physical devices.
|
||||
.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 ifup (8),
|
||||
.BR ip (8),
|
||||
.BR ifconfig (8),
|
||||
.BR run\-parts (8),
|
||||
.BR resolvconf (8).
|
||||
Reference in New Issue
Block a user