[src/trunk]: src/share/man/man4 wording fixes. sync with reality.

[itojun <itojun%NetBSD.org@localhost>]

details:   https://anonhg.NetBSD.org/src/rev/6a780e88a1ea
branches:  trunk
changeset: 479817:6a780e88a1ea
user:      itojun <itojun%NetBSD.org@localhost>
date:      Wed Dec 22 06:51:15 1999 +0000

description:
wording fixes.  sync with reality.
(sync with kame tree)

diffstat:

 share/man/man4/ip6.4 |  43 +++++++++++++++++++++++++++++++------------
 1 files changed, 31 insertions(+), 12 deletions(-)

diffs (112 lines):

diff -r c7766628dd14 -r 6a780e88a1ea share/man/man4/ip6.4
--- a/share/man/man4/ip6.4      Wed Dec 22 05:55:24 1999 +0000
+++ b/share/man/man4/ip6.4      Wed Dec 22 06:51:15 1999 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: ip6.4,v 1.1 1999/12/20 05:50:49 itojun Exp $
+.\"    $NetBSD: ip6.4,v 1.2 1999/12/22 06:51:15 itojun Exp $
 .\"
 .\" Copyright (C) 1999 WIDE Project.
 .\" All rights reserved.
@@ -58,7 +58,7 @@
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
-.\"    KAME Id: ip6.4,v 1.3 1999/12/20 01:53:35 jinmei Exp
+.\"    KAME Id: ip6.4,v 1.6 1999/12/22 06:49:12 itojun Exp
 .\"
 .Dd December 17, 1999
 .Dt IP6 4
@@ -242,13 +242,13 @@
 .Ed
 .\"
 .Ss Advanced IPv6 sockets API
-The advanced IPv6 sockets API lets userland programs to specify, or obtain,
+The advanced IPv6 sockets API lets userland programs specify or obtain
 details about the IPv6 header and the IPv6 extension headers on packets.
 The advanced API uses ancillary data for passing data from/to the kernel.
 .Pp
 There are
 .Xr setsockopt 2 / Ns Xr getsockopt 2
-flags to get optional information on packets for incoming packets.
+options to get optional information on incoming packets.
 They are
 .Dv IPV6_PKTINFO ,
 .Dv IPV6_HOPLIMIT ,
@@ -268,13 +268,13 @@
 .Pp
 When any of these options are enabled, the corresponding data is
 returned as control information by
-.Xr recvmsg2 ,
+.Xr recvmsg 2 ,
 as one or more ancillary data objects.
 .Pp
 If
 .Dv IPV6_PKTINFO
-is enabled, destination IPv6 address and arriving interface index
-will be made available via
+is enabled, the destination IPv6 address and the arriving interface index
+will be available via
 .Li struct in6_pktinfo
 on ancillary data stream.
 You can pick the structure by checking for an ancillary data item with
@@ -290,7 +290,7 @@
 .Dv IPV6_HOPLIMIT
 is enabled, hoplimit value on the packet will be made available to the
 userland program.
-ancillary data stream will contain an integer data item with
+Ancillary data stream will contain an integer data item with
 .Li cmsg_level
 equals to
 .Dv IPPROTO_IPV6 ,
@@ -312,7 +312,8 @@
 .Dv IPV6_HOPOPTS
 and
 .Dv IPV6_DSTOPTS
-may appear multiple times on an ancillary data stream.
+may appear multiple times on an ancillary data stream
+(note that the behavior is slightly different than the specification).
 Other ancillary data item will appear no more than once.
 .Pp
 For outgoing direction,
@@ -450,9 +451,12 @@
 .Pp
 When conflicting options are given to the kernel,
 the kernel will get the value in the following preference:
-(1) options specified by using advanced API,
-(2) options specified by socket address, and lastly
-(3) options specified by using basic API.
+(1) options specified by using ancillary data,
+(2) options specified by a sticky option of the advanced API,
+(3) options specified by using the basic API, and lastly
+(4) options specified by a socket address.
+Note that the conflict resolution is undefined in the API specifcation
+and implementation dependent.
 .\"
 .Ss "Raw IPv6 Sockets"
 Raw
@@ -630,6 +634,16 @@
 .%D December 1998
 .%T "Internet Protocol, Version 6 (IPv6) Specification"
 .Re
+.Rs
+.%A R. Gilligan
+.%A S. Thomson
+.%A J. Bound
+.%A W. Stevens
+.%R RFC
+.%N 2553
+.%D March 1999
+.%T "Basic Socket Interface Extensions for IPv6"
+.Re
 .\"
 .Sh STANDARDS
 Most of the socket options are defined in
@@ -645,3 +659,8 @@
 .Pc .
 .Pp
 Part of the document was shamelessly copied from RFC2553 and RFC2292.
+.\"
+.Sh BUGS
+The
+.Dv IPV6_NEXTHOP
+object/option is not fully implemented as of writing this.