summaryrefslogtreecommitdiffstats
path: root/usr.sbin/iostat/iostat.8
diff options
context:
space:
mode:
authorcharnier <charnier@FreeBSD.org>2000-01-23 20:19:34 +0000
committercharnier <charnier@FreeBSD.org>2000-01-23 20:19:34 +0000
commit33144f5460c8233af1d5ef27106fa85766feded2 (patch)
treeb71330e9957edde6053be200d1193831dff2081c /usr.sbin/iostat/iostat.8
parent840a73c91f61d3436b296461c5f90a15e68d069e (diff)
downloadFreeBSD-src-33144f5460c8233af1d5ef27106fa85766feded2.zip
FreeBSD-src-33144f5460c8233af1d5ef27106fa85766feded2.tar.gz
Rework use of Nm.
Remove -? flag that was not working but documented. Make it work instead but hide it in man page and usage string as others tools do. Spelling. Abort on allocation failure (with errx()).
Diffstat (limited to 'usr.sbin/iostat/iostat.8')
-rw-r--r--usr.sbin/iostat/iostat.842
1 files changed, 20 insertions, 22 deletions
diff --git a/usr.sbin/iostat/iostat.8 b/usr.sbin/iostat/iostat.8
index e623de4..035acb8 100644
--- a/usr.sbin/iostat/iostat.8
+++ b/usr.sbin/iostat/iostat.8
@@ -25,8 +25,6 @@
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
-.\" $FreeBSD$
-.\"
.\" Copyright (c) 1985, 1991, 1993
.\" The Regents of the University of California. All rights reserved.
.\"
@@ -59,6 +57,7 @@
.\" SUCH DAMAGE.
.\"
.\" @(#)iostat.8 8.1 (Berkeley) 6/6/93
+.\" $FreeBSD$
.\"
.Dd December 22, 1997
.Dt IOSTAT 8
@@ -70,7 +69,7 @@
statistics
.Sh SYNOPSIS
.Nm iostat
-.Op Fl CdhKIoT?
+.Op Fl CdhKIoT
.Op Fl c Ar count
.Op Fl M Ar core
.Op Fl n Ar devs
@@ -123,16 +122,16 @@ instead of the default
Display up to
.Ar devs
number of devices.
-.Nm iostat
+.Nm Iostat
will display fewer devices if there aren't
.Ar devs
devices present.
.It Fl N
Extract the name list from the specified system instead of the default
-.Dq Pa /kernel .
+.Pa /kernel .
.It Fl o
Display old-style
-.Nm iostat
+.Nm
device statistics. Sectors per second, transfers per second, and miliseconds
per seek are displayed. If
.Fl I
@@ -203,7 +202,7 @@ all devices in the system are compared. Any device that fully matches
any
.Fl t
argument will be included in the
-.Nm iostat
+.Nm
output, up to the number of devices that can be displayed in
80 columns, or the maximum number of devices specified by the user.
.It Fl T
@@ -217,8 +216,6 @@ seconds between each display.
If no repeat
.Ar count
is specified, the default is infinity.
-.It Fl ?
-Display a usage statement and exit.
.El
.Pp
.Nm Iostat
@@ -233,27 +230,28 @@ characters written to terminals
.El
.It devices
Device operations. The header of the field is the device name and unit number.
-.Nm iostat
+.Nm Iostat
will display as many devices as will fit in a standard 80 column screen, or
the maximum number of devices in the system, whichever is smaller. If
.Fl n
is specified on the command line, iostat will display the smaller of the
requested number of devices, and the maximum number of devices in the system.
To force
-.Nm iostat
+.Nm
to display specific drives, their names may be supplied on the command
line.
-.Nm iostat
+.Nm Iostat
will not display more devices than will fit in an 80 column screen, unless
the
.Fl n
argument is given on the command line to specify a maximum number of
devices to display. If fewer devices are specified on the command line
-than will fit in an 80 column screen, iostat will show only the specified
-devices.
+than will fit in an 80 column screen,
+.Nm
+will show only the specified devices.
.Pp
The standard
-.Nm iostat
+.Nm
device display shows the following statistics:
.Pp
.Bl -tag -width indent -compact
@@ -266,7 +264,7 @@ megabytes per second
.El
.Pp
The standard
-.Nm iostat
+.Nm
device display, with the
.Fl I
flag specified, shows the following statistics:
@@ -281,7 +279,7 @@ total number of megabytes transferred
.El
.Pp
The old-style
-.Nm iostat
+.Nm
display (using
.Fl o )
shows the following statistics:
@@ -296,7 +294,7 @@ average milliseconds per transaction
.El
.Pp
The old-style
-.Nm iostat
+.Nm
display, with the
.Fl I
flag specified, shows the following statistics:
@@ -326,9 +324,9 @@ average milliseconds per transaction
.Sh FILES
.Bl -tag -width /dev/kmem -compact
.It Pa /kernel
-Default kernel namelist.
+default kernel namelist
.It Pa /dev/kmem
-Default memory file.
+default memory file
.El
.Sh EXAMPLES
.Dl iostat -w 1 da0 da1 cd0
@@ -353,7 +351,7 @@ to either Direct Access or CDROM devices.
.Pp
.Dl iostat -h -n 8 -w 1
.Pp
-Display up to 8 devices with the most I/O every second ad inifitum.
+Display up to 8 devices with the most I/O every second ad infinitum.
.Pp
.Dl iostat -dh -t da -w 1
.Pp
@@ -387,7 +385,7 @@ The sections starting with ``Interpreting system activity'' in
.%T "Installing and Operating 4.3BSD" .
.Sh HISTORY
This version of
-.Nm iostat
+.Nm
first appeared in
.Fx 3.0 .
.Sh BUGS
OpenPOWER on IntegriCloud