HOSTNAME.IF(5) | File Formats Manual | HOSTNAME.IF(5) |
hostname.if
—
interface-specific configuration files
The hostname.*
files contain information
regarding the configuration of each network interface. One file should exist
for each interface that is to be configured, such as
hostname.fxp0 or
hostname.bridge0. A configuration file is not needed
for lo0.
The configuration information is expressed in a line-by-line packed format which makes the most common cases simpler; those dense formats are described below. Any lines not matching these packed formats are passed directly to ifconfig(8). The packed formats are converted using a somewhat inflexible parser and the administrator should not expect magic — if in doubt study ifconfig(8) and the per-driver manual pages to see what arguments are permitted.
Arguments containing either whitespace or single quote characters must be double quoted. For example:
inet 10.0.0.1 255.255.255.0 10.0.0.255 description "Bob's uplink"
Each line is processed separately and in order. For example:
nwid mynwid wpakey mywpakey dhcp
would run ifconfig to set the nwid of the interface, run it again to set the wpakey of the interface, and then start dhclient(8).
The following packed formats are valid for configuring network interfaces with static addresses:
Regular IPv4 network setup:
inet
[alias
] addr
netmask broadcast_addr
options
dest
dest_addrRegular IPv6 network setup:
inet6
[alias
] addr
prefixlen options
dest
dest_addrOther network setup:
A typical file contains only one line, but more extensive files are possible, for example:
inet 10.0.1.12 255.255.255.0 10.0.1.255 media 100baseTX description Uplink inet alias 10.0.1.13 255.255.255.255 10.0.1.13 inet alias 10.0.1.14 255.255.255.255 NONE inet alias 10.0.1.15 255.255.255.255 inet alias 10.0.1.16 0xffffffff # This is an example comment line. inet6 alias fec0::1 64 inet6 alias fec0::2 64 anycast !route add 65.65.65.65 10.0.1.13 up
The above formats have the following field values:
alias
If no address is specified, the netmask,
broadcast_addr, dest
, and
dest_addr options are invalid and will be
ignored.
dest
#
!
commandThe following packed formats are valid for configuring network interfaces with dynamic addresses:
A DHCP-configured network interface setup consists of
dhcp
optionsThe above format has the following field values:
dhcp
IPv6 stateless address autoconfiguration:
inet6 autoconf
optionsThe above format has the following field values:
inet6
autoconf
If the network interface is a bridge, the options described in the bridge section of the ifconfig(8) manual page apply.
For example:
add fxp0 add ep1 -learn fxp0 # !ipsecctl -F # static fxp0 8:0:20:1e:2f:2b up # and finally enable it
March 10, 2017 | OpenBSD-6.2 |