90 lines
2.7 KiB
Groff
90 lines
2.7 KiB
Groff
.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).
|