HOSTNAME.IF(5)            OpenBSD Programmer's Manual           HOSTNAME.IF(5)

NAME
     hostname.* and bridgename.* - interface-specific configuration files

DESCRIPTION
     The hostname.* and bridgename.* 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
     bridgename.bridge0. However, a configuration file is not needed for lo0.

     The following three formats are valid for hostname.* files.

     Regular network setup:

         addr_family addr netmask broadcast_addr options
         dest dest_addr

     For example,

         inet 10.0.1.12 255.255.255.0 10.0.1.255 media 100baseTX

     The above format has the following field values:

         addr_family
                 The address family of the interface, generally ``inet''.

         addr    The optional address that belongs to the interface, such as
                 190.191.192.1.  It is also feasable to use a hostname as
                 specified in /etc/hosts. It is recommended that an address be
                 used instead of symbolic information which might activate re-
                 solver(3) library routines.

                 If no address is specified, the netmask, broadcast_addr,
                 dest, and dest_addr options are invalid and will be ignored.

         netmask
                 The optional network mask for the interface, i.e.,
                 255.255.255.0.

         broadcast_addr
                 The optional broadcast address for the interface, i.e.,
                 190.191.192.255

         options
                 Optional miscellaneous options to set on the interface, i.e.,
                 ``media 100baseTX mediaopt full-duplex''.

         dest    If the interface needs a destination address address set,
                 this is the literal text ``dest''.

         dest_addr
                 The destination address to be set on the interface, such as
                 190.191.192.2.  It is also feasable to use a hostname as
                 specified in /etc/hosts. It is recommended that an address be
                 used instead of symbolic information which might activate re-
                 solver(3) library routines.

     A DHCP-configured network interface setup consists of

         dhcp options

     For example,

         dhcp media 100baseTX mediaopt full-duplex

     The above format has the following field values:

         dhcp    The literal string ``dhcp'' if the interface is to be config-
                 ured using DHCP.  See dhclient(8) and dhclient.conf(5) for
                 more details.

         options
                 Optional miscellaneous options to set on the interface, i.e.,
                 ``media 100baseTX mediaopt full-duplex''.

     An addressless network interface setup (useful for bridge(4) member in-
     terfaces) consists of

         up options

     The above format has the following field values:

         up      The literal string ``up'' if the interface is to be simply
                 brought up.

         options
                 Optional miscellaneous options to set on the interface, i.e.,
                 ``media 100baseTX mediaopt full-duplex''.

     The final file format only applies to bridgename.bridge* files.  A bridge
     interface setup consists of

         brconfig-arguments
         brconfig-arguments
         ...

     For example,

         add fxp0
         add ep1
         -learn fxp0
         #
         static fxp0 8:0:20:1e:2f:2b
         up    # and finally enable it

     The options are as follows:

         brconfig-arguments
                 brconfig(8) is called for each successive line.  Comments
                 starting with # are permitted.

SEE ALSO
     hosts(5),  dhcp(8),  ifconfig(8),  rc(8)

OpenBSD 2.6                    September 2, 1999                             2
