Manual pages › File formats and configuration files (4)
interfaces(4)
how each network interface is set up at boot
Package: amxbase, added for amigaux.
NAME
interfaces - how each network interface is set up at boot
SYNOPSIS
/etc/inet/interfaces
DESCRIPTION
/etc/inet/interfaces says, for every network interface of the machine, whether it is set up and how. The installer writes it, the administrator edits it, and no package owns it.
Each line describes an interface, or is a global line. A # starts a comment that runs to the end of the line; blank lines are ignored. Words are separated by blanks or tabs.
Interface lines
key mode [address[/bits]] [gw router] [name host]
- key
- which interface the line is for: an interface name such as aen0, zen0 or hya0; a station (MAC) address such as 00:80:51:01:02:04, which matches whatever interface has that card, so one disk image can serve several machines; or *, any interface no other line names. For an interface the line with its MAC address counts first, then the line with its name, then *. An interface no line matches is left down.
- mode
- static sets the address given. dhcp asks a DHCP server for the address; an address given on the line is used if no server answers. off leaves the interface down; anything after it is ignored.
- address[/bits]
- the interface's address, with the length of the network prefix in bits (1 to 30). Without bits, the old class of the address decides (8, 16 or 24).
- gw router
- the default router, which must be on the interface's network.
- name host
- the machine's name, written to /etc/nodename and to this host's line in /etc/inet/hosts. Letters, digits and -, at most 63.
Global lines
- dns address ...
- name servers to use. Several dns lines add up. Name servers a DHCP server gives are added to these unless a dns line also says static.
- domain name
- the domain of this host, used only for the full name in /etc/inet/hosts; it is never given to the resolver, which would append it to every lookup.
- hostname dhcp
- take the machine's name from the DHCP server. Without this line a DHCP server never changes the name.
ERRORS
A mistake in an interface line leaves that interface down, rather than letting the * line take it. A mistake in a global line causes the line to be ignored. Every mistake is reported with its line number in the boot log, when the network is set up, and by ifup -n.
EXAMPLE
# /etc/inet/interfaces zen0 dhcp aen0 static 192.0.2.38/24 gw 192.0.2.1 00:80:51:01:02:04 static 192.0.2.39/24 gw 192.0.2.1 name tower * off dns 192.0.2.14 192.0.2.23 domain example.com
FILES
- /etc/inet/interfaces
- this file.
- /etc/inet/link.d/*
- the network drivers present, one file each, shipped by the driver packages.
SEE ALSO
| 30 October 2026 | amix-base |