reflect multi-line and inet6 change from todd.

add description on "rtsol" (maybe too lengthy?)

1 files changed, 51 insertions, 6 deletions

diff --git a/share/man/man5/hostname.if.5 b/share/man/man5/hostname.if.5
index 613f6c8acf7..83ecfaf4dd9 100644
--- a/share/man/man5/hostname.if.5
+++ b/share/man/man5/hostname.if.5
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: hostname.if.5,v 1.6 1999/10/04 18:30:25 jason Exp $
+.\"	$OpenBSD: hostname.if.5,v 1.7 2000/01/02 05:35:30 itojun Exp $
 .\"	$NetBSD: hosts.5,v 1.4 1994/11/30 19:31:20 jtc Exp $
 .\"
 .\" Copyright (c) 1983, 1991, 1993
@@ -55,30 +55,47 @@ such as
 or
 .Pa bridgename.bridge0 .
 However, a configuration file is not needed for lo0.
+Note that multiple entries can be used per configuration file.
 .Pp
 The following three formats are valid for
 .Nm hostname.*
 files.
 .Pp
-Regular network setup:
+Regular ipv4 network setup:
 .Bd -literal -offset xxxx
-.Va addr_family Va addr Va netmask Va broadcast_addr Va options
+.Va addr_family Va [ alias ] Va addr Va netmask Va broadcast_addr Va options
 .Li dest Va dest_addr
 .Ed
 .Pp
+Regular ipv6 network setup:
+.Bd -literal -offset xxxx
+.Va addr_family Va [ alias ] Va addr Va prefixlen Va options
+.Ed
+.Pp
+Other network setup:
+.Bd -literal -offset xxxx
+.Va addr_family Va options
+.Ed
+.Pp
 For example,
 .Bd -literal -offset xxxx
 inet 10.0.1.12 255.255.255.0 10.0.1.255 media 100baseTX
+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
+inet6 alias fec0::1 64
+inet6 alias fec0::2 64 anycast
 .Ed
 .Pp
-The above format has the following field values:
+The above formats have the following field values:
 .Bl -tag -width indent -offset xxxx
 .It Va addr_family
 The address family of the interface, generally
-.Dq inet .
+.Dq inet or inet6.
 .It Va addr
 The optional address that belongs to the interface, such as
-190.191.192.1.
+190.191.192.1 or fe80:2::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
@@ -115,6 +132,9 @@ It is recommended that an address be used instead of symbolic information
 which might activate
 .Xr resolver 3
 library routines.
+.It Va prefixlen
+The prefixlen number, or number of bits in the netmask, to be set on
+the interface, such as 64.
 .El
 .Pp
 A DHCP-configured network interface setup consists of
@@ -144,6 +164,31 @@ Optional miscellaneous options to set on the interface, i.e.,
 .Dq media 100baseTX mediaopt full-duplex .
 .El
 .Pp
+IPv6 stateless address autoconfiguration:
+.Pp
+.Bd -literal -offset xxxx
+.Li rtsol
+.Ed
+.Pp
+The above format has the following field values:
+.Bl -tag -width indent -offset xxxx
+.It Li rtsol
+The literal string
+.Dq rtsol
+if the interface is to be configured using
+IPv6 stateless address autoconfiguration.
+This should be used on single interface host only,
+as IPv6 specifications are silent about the behavior on multi-interface case.
+Also note that the kernel must be configured to accept
+IPv6 router advertisement, and configured as host (non-router).
+Add the following lines into
+.Xr sysctl.conf 5 :
+.Bd -literal -offset xxxx
+.Li net.inet6.ip6.forwarding=0
+.Li net.inet6.ip6.accept_rtadv=1
+.Ed
+.El
+.Pp
 An addressless network interface setup (useful for
 .Xr bridge 4
 member interfaces) consists of