Date: Sat, 11 Feb 2006 21:33:12 GMT From: Marian Cerny <jojo@matfyz.cz> To: freebsd-gnats-submit@FreeBSD.org Subject: docs/93201: inconsitency in vmstat(8) manual page with default disks shown Message-ID: <200602112133.k1BLXC1F019547@www.freebsd.org> Resent-Message-ID: <200602112140.k1BLe4kx013411@freefall.freebsd.org>
next in thread | raw e-mail | index | archive | help
>Number: 93201 >Category: docs >Synopsis: inconsitency in vmstat(8) manual page with default disks shown >Confidential: no >Severity: non-critical >Priority: low >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: doc-bug >Submitter-Id: current-users >Arrival-Date: Sat Feb 11 21:40:03 GMT 2006 >Closed-Date: >Last-Modified: >Originator: Marian Cerny >Release: FreeBSD 6.0R-p4 >Organization: >Environment: FreeBSD callman.icomvision.com 6.0-RELEASE-p4 FreeBSD 6.0-RELEASE-p4 #0: Sat Jan 28 16:13:40 CET 2006 majo@callman:/usr/obj/usr/src/sys/CALLMAN i386 >Description: The manual page vmstat(8) correctly describes the -n option, that it shows 2 disks by default: -n Change the maximum number of disks to display from the default of 2. but other paragraphs states it shows 3 disks by default (emphasized by ***): Any number of -p arguments may be specified on the command line. All -p arguments are ORed together to form a matching expression against which all devices in the system are compared. Any device that fully matches any -p argument will be included in the vmstat output, up to ***three*** devices, or the maximum number of devices specified by the user. [...] disks Disk operations per second (this field is system dependent). Typically paging will be split across the available drives. The header of the field is the first two characters of the disk name and the unit number. If more than ***three*** disk drives are config- ured in the system, vmstat displays only the first ***three*** drives, unless the user specifies the -n argument to increase the number of drives displayed. This will probably cause the display to exceed 80 columns, however. To force vmstat to display specific drives, their names may be supplied on the command line. The vmstat utility defaults to show disks first, and then various other random devices in the system to add up to ***three*** devices, if there are that many devices in the system. If devices are speci- fied on the command line, or if a device type matching pattern is specified (see above), vmstat will only display the given devices or the devices matching the pattern, and will not randomly select other devices in the system. Looks like one day the the default disks shown changed from 3 to 2, but only the -n option has been corrected, as this diff shows: http://www.freebsd.org/cgi/cvsweb.cgi/src/usr.bin/vmstat/vmstat.8.diff?r1=1.10&r2=1.11 >How-To-Repeat: See vmstat(8) man page. >Fix: Change the four emphasized words "three" in the full desription to "two". >Release-Note: >Audit-Trail: >Unformatted:
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?200602112133.k1BLXC1F019547>