new pages

2 files changed, 182 insertions, 1 deletions

diff --git a/share/man/man5/Makefile b/share/man/man5/Makefile
index c506f59a959..96c68e1c6d6 100644
--- a/share/man/man5/Makefile
+++ b/share/man/man5/Makefile
@@ -4,7 +4,7 @@
 # missing: dump.5 plot.5 
 
 MAN=	a.out.5 acct.5 core.5 dir.5 disktab.5 ethers.5 fbtab.5 fs.5 \
-	fstab.5 group.5 hosts.equiv.5 \
+	fstab.5 group.5 hostname.if.5 hosts.equiv.5 \
 	hosts.5 intro.5 link.5 motd.5 netgroup.5 networks.5 passwd.5 \
 	passwd.conf.5 phones.5 \
 	printcap.5 protocols.5 remote.5 resolv.conf.5 rpc.5 services.5 \
@@ -12,5 +12,6 @@ MAN=	a.out.5 acct.5 core.5 dir.5 disktab.5 ethers.5 fbtab.5 fs.5 \
 MLINKS= dir.5 dirent.5 fs.5 inode.5 utmp.5 wtmp.5 utmp.5 lastlog.5
 MLINKS+= hosts.equiv.5 .rhosts.5 
 MLINKS+= resolv.conf.5 resolver.5
+MLINKS+= hostname.if.5 bridgename.if.5
 
 .include <bsd.prog.mk>
diff --git a/share/man/man5/hostname.if.5 b/share/man/man5/hostname.if.5
new file mode 100644
index 00000000000..179687aa4dc
--- /dev/null
+++ b/share/man/man5/hostname.if.5
@@ -0,0 +1,180 @@
+.\"	$OpenBSD: hostname.if.5,v 1.1 1999/09/01 05:07:54 deraadt Exp $
+.\"	$NetBSD: hosts.5,v 1.4 1994/11/30 19:31:20 jtc Exp $
+.\"
+.\" Copyright (c) 1983, 1991, 1993
+.\"	The Regents of the University of California.  All rights reserved.
+.\"
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\"    notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\"    notice, this list of conditions and the following disclaimer in the
+.\"    documentation and/or other materials provided with the distribution.
+.\" 3. All advertising materials mentioning features or use of this software
+.\"    must display the following acknowledgement:
+.\"	This product includes software developed by the University of
+.\"	California, Berkeley and its contributors.
+.\" 4. Neither the name of the University nor the names of its contributors
+.\"    may be used to endorse or promote products derived from this software
+.\"    without specific prior written permission.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
+.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
+.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
+.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
+.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
+.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
+.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
+.\" SUCH DAMAGE.
+.\"
+.\"     @(#)hosts.5	8.2 (Berkeley) 12/11/93
+.\"
+.Dd December 11, 1993
+.Dt HOSTNAME.IF 5
+.Os
+.Sh NAME
+.Nm hostname.*
+and
+.Nm bridgename.*
+.Nd interface-specific configuration files
+.Sh DESCRIPTION
+The
+.Nm
+and
+.Nm 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
+.Pa hostname.fxp0
+or
+.Pa bridgename.bridge0 .
+However, a configuration file is not needed for
+.Dv lo0 .
+.Pp
+Three data formats are permitted for these files.
+.Pp
+.Nm hostname.*
+files can accept the following two formats:
+.Pp
+Regular network setup:
+.Pp
+.Bd -literal -offset xxxx
+.Va addr_family Va addr Va netmask Va broadcast_addr Va options
+.Li dest Va dest_addr
+.Ed
+.Pp
+For example,
+.Bd -literal -offset xxxx
+inet 10.0.1.12 255.255.255.0 10.0.1.255 media 100baseTX
+.Ed
+.Pp
+The above format has the following field values:
+.Bl -tag -width indent -offset xxxx
+.It Va addr_family
+The address family of the interface, generally
+.Dq inet .
+.It Va 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
+.Pa /etc/hosts .
+It is recommended that an address be used instead of symbolic information
+which might activate
+.Xr resolver 3
+library routines.
+.Pp
+If no address is specified, the
+.Va netmask ,
+.Va broadcast_addr ,
+.Li dest ,
+and
+.Va dest_addr
+options are invalid and will be ignored.
+.It Va netmask
+The optional network mask for the interface, ie.
+255.255.255.0.
+.It Va broadcast_addr
+The optional broadcast address for the interface, ie.
+190.191.192.255
+.It Va options
+Optional miscellaneous options to set on the interface, ie.
+.Dq media 100baseTX mediaopt full-duplex .
+.It Li dest
+If the interface needs a destination address address set, this is
+the literal text
+.Dq dest .
+.It Va 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
+.Pa /etc/hosts .
+It is recommended that an address be used instead of symbolic information
+which might activate
+.Xr resolver 3
+library routines.
+.El
+.Pp
+A DHCP-configured network interface setup consists of
+.Pp
+.Bd -literal -offset xxxx
+.Li dhcp Va options
+.Ed
+.Pp
+For example,
+.Bd -literal -offset xxxx
+dhcp media 100baseTX mediaopt full-duplex
+.Ed
+.Pp
+The options are as follows:
+.Bl -tag -width indent -offset xxxx
+.It Li dhcp
+The string
+.Dq dhcp
+if the interface is to be configured using DHCP.
+See
+.Xr dhclient 8
+and
+.Xr dhclient.conf 5
+for more details.
+.It Va options
+Optional miscellaneous options to set on the interface, ie.
+.Dq media 100baseTX mediaopt full-duplex .
+.El
+.Pp
+.Pp
+The final file format only applies to
+.Nm bridgename.bridge*
+files.
+A bridge interface setup consists of
+.Pp
+.Bd -literal -offset xxxx
+.Va firstline
+.Va brconfig-arguments
+.Va brconfig-arguments
+\&...
+.Ed
+.Pp
+For example,
+.Bd -literal -offset xxxx
+up
+add fxp0
+add ep1
+-learn fxp0
+.Ed
+.Pp
+The options are as follows:
+.Bl -tag -width indent -offset xxxx
+.It Va firstline
+The firstline of the bridge file contains a line like
+.Dq up media auto .
+.It Va brconfig-arguments
+.Xr brconfig 8
+is called for each successive line.
+.El
+.Pp