BSD 4_4 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 2b95ce6..979f6ad 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    6.11 (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.1 (Berkeley) 7/1/93
+.\"
+.Dd July 1, 1993

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


@@ -157,17 +183,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.


@@ -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
 a separate display rather than create a new program).
 .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.