From 43b98c2b5281d5ee433251e278a1e7e938fe8527 Mon Sep 17 00:00:00 2001 From: Yaroslav Tykhiy Date: Wed, 24 Nov 2010 00:05:19 +0000 Subject: [PATCH] Clarify a few details about iostat(8) behavior: - The default repeat count for iostat(8) is 1 unless there was a -w on the command line. - A -x display doesn't include TTY or CPU stats by default but they can be turned on with a -T or -C, respectively. Submitted by: arundel (initial version) Reviewed by: arundel MFC after: 1 week --- usr.sbin/iostat/iostat.8 | 18 ++++++++++++++++-- 1 file changed, 16 insertions(+), 2 deletions(-) diff --git a/usr.sbin/iostat/iostat.8 b/usr.sbin/iostat/iostat.8 index 69fadcff8ed7..aab668aa2661 100644 --- a/usr.sbin/iostat/iostat.8 +++ b/usr.sbin/iostat/iostat.8 @@ -60,7 +60,7 @@ .\" .\" @(#)iostat.8 8.1 (Berkeley) 6/6/93 .\" -.Dd April 17, 2006 +.Dd November 24, 2010 .Dt IOSTAT 8 .Os .Sh NAME @@ -102,11 +102,18 @@ Repeat the display times. If no repeat .Ar count -is specified, the default is infinity. +is specified, the default depends on whether +.Fl w +is specified. +With +.Fl w +the default repeat count is infinity, otherwise it is 1. .It Fl C Display CPU statistics. This is on by default, unless .Fl d +or +.Fl x is specified. .It Fl d Display only device statistics. @@ -231,6 +238,8 @@ output, up to the number of devices that can be displayed in Display TTY statistics. This is on by default, unless .Fl d +or +.Fl x is specified. .It Fl w Pause @@ -255,6 +264,11 @@ so your mileage may vary. .It Fl x Show extended disk statistics. Each disk is displayed on a line of its own with all available statistics. +If this flag is turned on, only disk statistics will be displayed, unless +.Fl C +or +.Fl T +is also specified to enable the display of CPU or TTY statistics. .It Fl z If .Fl x