bin/153012: iostat(8) requires an argument to -c option

[Bruce Evans]

The following reply was made to PR bin/153012; it has been noted by GNATS.

From: Bruce Evans <brde at optusnet.com.au>
To: Warren Block <wblock at wonkity.com>
Cc: freebsd-gnats-submit at FreeBSD.org, freebsd-bugs at FreeBSD.org
Subject: Re: bin/153012: iostat(8) requires an argument to -c option
Date: Sat, 11 Dec 2010 21:23:19 +1100 (EST)

 On Fri, 10 Dec 2010, Warren Block wrote:
 
 >> Description:
 > iostat(8) says:
 >
 > -c    Repeat the display count times.  If no repeat count is specified,
 >      the default is infinity.
 
 This used to be correct.  It said "if no wait interval is specified, then
 the default [for the wait interval] is 1 second".  This was a bit confusing
 since it didn't say that the default is for the wait interval.  Now it is
 just broken, since it is the -c option and not its repeat count that is
 optional.
 
 > But if you try to run it without a repeat count:
 >
 > % iostat -c
 > iostat: option requires an argument -- c
 > usage: iostat [-CdhIKoTxz?] [-c count] [-M core] [-n devs] [-N system]
 > 	      [-t type,if,pass] [-w wait] [drives]
 
 The synopsis and usage message correctly specify that -c must have an arg.
 
 The -w option has the complement of this breakage.
 
 Either -w wait or the the normal way using the undocumented alias for this
 ("iostat wait", where `wait is a number') must be used to specifiy the wait
 time for -c.  Not documenting this may be intentional, but it became
 especially broken when the `drives' option was added, since according to
 the synopsis and usage message "iostat 1" says to give statistics for the
 drive named "1", but it is actually an alias for "iostat -w 1".
 
 Bruce