BSD 4_4_Lite1 release

[unix-history] / usr / src / usr.bin / systat / systat.1

diff --git a/usr/src/usr.bin/systat/systat.1 b/usr/src/usr.bin/systat/systat.1
index e135244..3b9a5d9 100644 (file)
--- a/usr/src/usr.bin/systat/systat.1
+++ b/usr/src/usr.bin/systat/systat.1
@@ -1,11 +1,37 @@
-.\" Copyright (c) 1985, 1990 The Regents of the University of California.
-.\" All rights reserved.
+.\" Copyright (c) 1985, 1990, 1993
+.\"    The Regents of the University of California.  All rights reserved.

 .\"
 .\"

-.\" %sccs.include.redist.roff%
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\"    notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\"    notice, this list of conditions and the following disclaimer in the
+.\"    documentation and/or other materials provided with the distribution.
+.\" 3. All advertising materials mentioning features or use of this software
+.\"    must display the following acknowledgement:
+.\"    This product includes software developed by the University of
+.\"    California, Berkeley and its contributors.
+.\" 4. Neither the name of the University nor the names of its contributors
+.\"    may be used to endorse or promote products derived from this software
+.\"    without specific prior written permission.

 .\"
 .\"

-.\"    @(#)systat.1    8.1 (Berkeley) %G%
+.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
+.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
+.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
+.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
+.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
+.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
+.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
+.\" SUCH DAMAGE.

 .\"
 .\"

-.Dd 
+.\"    @(#)systat.1    8.2 (Berkeley) 12/30/93
+.\"
+.Dd December 30, 1993

 .Dt SYSTAT 1
 .Os BSD 4.3
 .Sh NAME
 .Dt SYSTAT 1
 .Os BSD 4.3
 .Sh NAME


@@ -146,7 +172,8 @@ display; the minimum unambiguous prefix may be supplied.
 .Bl -tag -width Fl -compact
 .It Cm numbers
 Show the disk
 .Bl -tag -width Fl -compact
 .It Cm numbers
 Show the disk

-.Tn I/O statistics in numeric form.  Values are
+.Tn I/O 
+statistics in numeric form.  Values are

 displayed in numeric columns which scroll downward.
 .It Cm bars
 Show the disk
 displayed in numeric columns which scroll downward.
 .It Cm bars
 Show the disk


@@ -157,17 +184,17 @@ Toggle the display of average seek time (the default is to
 not display seek times).
 .El
 .It Ic swap
 not display seek times).
 .El
 .It Ic swap

-Display, in the lower window, swap space in use on each swap
-device configured.  Two sets of bar graphs are shown.  The
-upper graph displays swap space allocated to pure text segments
-(code), the lower graph displays space allocated to stack and
-data segments.  Allocated space is sorted by its size into buckets
-of size dmmin, dmmin*2, dmmin*4, up to dmmax (to reflect allocation
-policies imposed by the system).  The disk segment size, in sectors,
-is displayed along the left hand side of the text,
-and data and stack graphs.
-Space allocated to the user structure and page
-tables is not currently accounted for.
+Show information about swap space usage on all the 
+swap areas compiled into the kernel.
+The first column is the device name of the partition.
+The next column is the total space available in the partition.
+The 
+.Ar Used
+column indicates the total blocks used so far;
+the graph shows the percentage of space in use on each partition.
+If there are more than one swap partition in use,
+a total line is also shown.
+Areas known to the kernel, but not in use are shown as not available.

 .It Ic mbufs
 Display, in the lower window, the number of mbufs allocated
 for particular uses, i.e. data, socket structures, etc.
 .It Ic mbufs
 Display, in the lower window, the number of mbufs allocated
 for particular uses, i.e. data, socket structures, etc.


@@ -239,7 +266,6 @@ intransit blocking page faults (`It'),
 swap text pages found in free list (`F/S'),
 file system text pages found in free list (`F/F'),
 reclaims from free list
 swap text pages found in free list (`F/S'),
 file system text pages found in free list (`F/F'),
 reclaims from free list

-.Pp Sq RFL ,

 pages freed by the clock daemon (`Fre'),
 and sequential process pages freed (`SFr')
 per second over the refresh interval.
 pages freed by the clock daemon (`Fre'),
 and sequential process pages freed (`SFr')
 per second over the refresh interval.


@@ -249,7 +275,7 @@ zero filled pages (`zf') and demand filled text pages (`xf')
 per second over the refresh period.
 The first row indicates the number of requests that were
 resolved, the second row shows the number that were set up,
 per second over the refresh period.
 The first row indicates the number of requests that were
 resolved, the second row shows the number that were set up,

-and the last row shows the percentage of setup requests were
+and the last row shows the percentage of setup requests that were

 actually used.
 Note that this percentage is usually less than 100%,
 however it may exceed 100% if a large number of requests
 actually used.
 Note that this percentage is usually less than 100%,
 however it may exceed 100% if a large number of requests


@@ -318,7 +344,7 @@ Display only network connections using the indicated protocol
 .It Cm ignore Op Ar items
 Do not display information about connections associated with
 the specified hosts or ports.  Hosts and ports may be specified
 .It Cm ignore Op Ar items
 Do not display information about connections associated with
 the specified hosts or ports.  Hosts and ports may be specified

-by name (``ucbmonet'', ``ftp''), or numerically.  Host addresses
+by name (``vangogh'', ``ftp''), or numerically.  Host addresses

 use the Internet dot notation (``128.32.0.9'').  Multiple items
 may be specified with a single command by separating them with
 spaces.
 use the Internet dot notation (``128.32.0.9'').  Multiple items
 may be specified with a single command by separating them with
 spaces.


@@ -389,14 +415,9 @@ The
 program appeared in
 .Bx 4.3 .
 .Sh BUGS
 program appeared in
 .Bx 4.3 .
 .Sh BUGS

-Takes 2-10 percent of the cpu.  Certain displays presume
-a 24 line by 80 character terminal.  The swap space display
-should account for space allocated to the user structure and
-page tables.  The
+Takes 2-10 percent of the cpu.
+Certain displays presume a minimum of 80 characters per line.
+The

 .Ic vmstat
 display looks out of place because it is (it was added in as
 .Ic vmstat
 display looks out of place because it is (it was added in as

-a separate display rather than create a new program).
-.Pp
-The whole
-thing is pretty hokey and was included in the distribution under
-serious duress.
+a separate display rather than created as a new program).