Subject: bin/20875: Incorrect facts in rtsol(8) man page
To: None <gnats-bugs@gnats.netbsd.org>
From: None <kre@munnari.OZ.AU>
List: netbsd-bugs
Date: 03/24/2003 18:06:21
>Number:         20875
>Category:       bin
>Synopsis:       Incorrect facts in rtsol(8) man page
>Confidential:   no
>Severity:       non-critical
>Priority:       medium
>Responsible:    bin-bug-people
>State:          open
>Class:          doc-bug
>Submitter-Id:   net
>Arrival-Date:   Mon Mar 24 03:07:00 PST 2003
>Closed-Date:
>Last-Modified:
>Originator:     Robert Elz
>Release:        NetBSD 1.6L	(-current sources of 2003-03-23)
>Organization:
	Prince of Songkla University
>Environment:
System: NetBSD delta.cs.mu.OZ.AU 1.6L NetBSD 1.6L (DELTA) #29: Fri Jan 10 11:40:50 ICT 2003 kre@fuchsia.cs.mu.OZ.AU:/usr/obj/sys/DELTA i386
Architecture: i386
Machine: i386
>Description:
	The rtsold(8) man page claims

     The IPv6 autoconfiguration specification assumes a single-interface host.

	which is incorrect.   That spec specifies how to configure a single
	interface, it assumes nothing at all about how many interfaces
	a host might have.   It is true that it doesn't include guidance
	about how to pick a default router, when there are routers on
	more than one interface (but until router priorities appear, it
	also doesn't really specify how to select a good default router when
	there are more than one sending RAs on one interface - so "just
	pick anything sending RA" is for now good enough, for one or more
	interfaces).

>How-To-Repeat:
	RTFM.

>Fix:
	Apply the following patch.  I left in the bit about maybe seeing
	kernel error messages, as while I haven't seen one, I'm not
	sure that this might not happen sometimes (and this is all in
	the BUGS section, and it only says that it may happen).  What's
	deleted is the incorrect rationalisation for the bug.

--- rtsold.8	Tue Feb 25 23:25:17 2003
+++ rtsold.8.FIXED	Mon Mar 24 18:03:14 2003
@@ -222,11 +222,5 @@
 .Nm
 should be killed and restarted.
 .Pp
-The IPv6 autoconfiguration specification assumes a single-interface host.
 You may see kernel error messages if you try to autoconfigure a host with
 multiple interfaces.
-Also, it seems contradictory for
-.Nm
-to accept multiple
-.Ar interface
-arguments.
>Release-Note:
>Audit-Trail:
>Unformatted: