Subject: lib/2007: errors in man pages for route(4) and sysctl(3)
To: None <gnats-bugs@NetBSD.ORG>
From: David Waitzman <djw@gigabit2.bbn.com>
List: netbsd-bugs
Date: 01/31/1996 19:10:50
>Number:         2007
>Category:       lib
>Synopsis:       errors in man pages for route(4) and sysctl(3)
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    lib-bug-people (Library Bug People)
>State:          open
>Class:          doc-bug
>Submitter-Id:   net
>Arrival-Date:   Wed Jan 31 19:20:07 1996
>Last-Modified:
>Originator:     David Waitzman
>Organization:
BBN Corp
	
>Release:        NetBSD_Alpha-951127
>Environment:
irrelevant 
	
System: NetBSD gigabit2.bbn.com 1.1A-NetBSD_Alpha-951127+ NetBSD 1.1A-NetBSD_Alpha-951127+ (TMENDEZ) #89: Wed Jan 31 18:09:50 EST 1996 tmendez@gigabit2.bbn.com:/home/users/tmendez/kernels/_sys.951220/arch/alpha/compile/TMENDEZ alpha


>Description:
	 sysctl(3) says to look at route(4) for information on the 
	 variable [CTL_NET, PF_ROUTE, 0, 0, NET_RT_IFLIST].
	 route(4) doesn't mention the variable.  It does mention 
	 the getkerninfo(2) system call which doesn't exist anymore.
	 sysctl(3) should also mention the undocumented 
	 system call __sysctl(2).

	 The fact that route(4) doesn't provide the needed information
	 and that sysctl(3) refers you to it to find that information,
	 is a bug.
>How-To-Repeat:
	man 4 route
	man getkerninfo
	man 3 sysctl
>Fix:
	Fix man pages.
>Audit-Trail:
>Unformatted: