From owner-freebsd-doc@FreeBSD.ORG Sat Feb 11 21:40:04 2006 Return-Path: X-Original-To: freebsd-doc@hub.freebsd.org Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id D151916A422 for ; Sat, 11 Feb 2006 21:40:04 +0000 (GMT) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id 43BD143D48 for ; Sat, 11 Feb 2006 21:40:04 +0000 (GMT) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1]) by freefall.freebsd.org (8.13.4/8.13.4) with ESMTP id k1BLe49b013414 for ; Sat, 11 Feb 2006 21:40:04 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.13.4/8.13.4/Submit) id k1BLe4kx013411; Sat, 11 Feb 2006 21:40:04 GMT (envelope-from gnats) Resent-Date: Sat, 11 Feb 2006 21:40:04 GMT Resent-Message-Id: <200602112140.k1BLe4kx013411@freefall.freebsd.org> Resent-From: FreeBSD-gnats-submit@FreeBSD.org (GNATS Filer) Resent-To: freebsd-doc@FreeBSD.org Resent-Reply-To: FreeBSD-gnats-submit@FreeBSD.org, Marian Cerny Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 4F12A16A422 for ; Sat, 11 Feb 2006 21:33:14 +0000 (GMT) (envelope-from nobody@FreeBSD.org) Received: from www.freebsd.org (www.freebsd.org [216.136.204.117]) by mx1.FreeBSD.org (Postfix) with ESMTP id 064F043D53 for ; Sat, 11 Feb 2006 21:33:13 +0000 (GMT) (envelope-from nobody@FreeBSD.org) Received: from www.freebsd.org (localhost [127.0.0.1]) by www.freebsd.org (8.13.1/8.13.1) with ESMTP id k1BLXCTa019548 for ; Sat, 11 Feb 2006 21:33:12 GMT (envelope-from nobody@www.freebsd.org) Received: (from nobody@localhost) by www.freebsd.org (8.13.1/8.13.1/Submit) id k1BLXC1F019547; Sat, 11 Feb 2006 21:33:12 GMT (envelope-from nobody) Message-Id: <200602112133.k1BLXC1F019547@www.freebsd.org> Date: Sat, 11 Feb 2006 21:33:12 GMT From: Marian Cerny To: freebsd-gnats-submit@FreeBSD.org X-Send-Pr-Version: www-2.3 Cc: Subject: docs/93201: inconsitency in vmstat(8) manual page with default disks shown X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sat, 11 Feb 2006 21:40:05 -0000 >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: