.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 . The functionality is loosely based on the ifupdown suite written by Anthony Towns . .SH "SEE ALSO" .BR ifup (8), .BR ip (8), .BR ifconfig (8), .BR run\-parts (8), .BR resolvconf (8).