Subject: misc/11086: vmstat man page describes non-existent features.
To: None <gnats-bugs@gnats.netbsd.org>
From: None <bstark@siemens-psc.com>
List: netbsd-bugs
Date: 09/26/2000 13:33:22
>Number:         11086
>Category:       misc
>Synopsis:       vmstat man page describes non-existent features.
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    misc-bug-people
>State:          open
>Class:          doc-bug
>Submitter-Id:   net
>Arrival-Date:   Tue Sep 26 13:39:01 PDT 2000
>Closed-Date:
>Last-Modified:
>Originator:     Brian Stark
>Release:        NetBSD 1.5_ALPHA2
>Organization:
	Siemens Power Systems Control
>Environment:
	
System: NetBSD palomino.siemens-psc.com 1.5_ALPHA2 NetBSD 1.5_ALPHA2 (PALOMINO) #6: Thu Aug 31 15:55:12 CDT 2000 bstark@palomino.siemens-psc.com:/usr/src/sys/arch/i386/compile/PALOMINO i386


>Description:
	vmstat man page describes non-existent features.

>How-To-Repeat:
	man vmstat

	look for section about "page". This section describes several
	columns of data:

              re   page reclaims (simulating reference bits)
              at   pages attached (found in free list)
              pi   pages paged in
              po   pages paged out
              fr   pages freed per second
              de   anticipated short term memory shortfall
              sr   pages scanned by clock algorithm, per-second

	However, vmstat does not show the information for "at" and "de":

palomino:{root}# vmstat 
 procs   memory     page                       disks   faults   cpu
 r b w   avm   fre  flt  re  pi   po   fr   sr w0 m0   in   sy  cs us sy id
 1 0 0 32468 58956  207   0   0    0    0    0  4  0  111  726 283  8  2 90
palomino:{root}# 
palomino:{root}# vmstat -v
 procs   memory     page                       disks   faults   cpu
 r b w   avm   fre  flt  re  pi   po   fr   sr w0 m0   in   sy  cs us sy id
 1 0 0 32504 58920  207   0   0    0    0    0  4  0  111  725 283  8  2 90
palomino:{root}# 


>Fix:
	It appears that these features have been removed. Perhaps the 
	man page should be updated so that the description of these 
	columns is removed. Or, perhaps this is a feature that was meant
	to be in vmstat but for one reason or another, was never 
	implemented. (In other words, someone more knowledgeable about 
	this than I should look into this...). 
>Release-Note:
>Audit-Trail:
>Unformatted: