[BACK]Return to systat.1 CVS log [TXT][DIR] Up to [local] / src / usr.bin / systat

Diff for /src/usr.bin/systat/systat.1 between version 1.15 and 1.16

version 1.15, 2000/03/06 03:17:39 version 1.16, 2000/03/11 21:40:03
Line 56 
Line 56 
 While  While
 .Nm  .Nm
 is running the screen is usually divided into two windows (an exception  is running the screen is usually divided into two windows (an exception
 is the vmstat display which uses the entire screen).  The  is the vmstat display which uses the entire screen).
 upper window depicts the current system load average.  The  The upper window depicts the current system load average.
 information displayed in the lower window may vary, depending on  The information displayed in the lower window may vary, depending on
 user commands.  The last line on the screen is reserved for user  user commands.
   The last line on the screen is reserved for user
 input and error messages.  input and error messages.
 .Pp  .Pp
 By default  By default
 .Nm  .Nm
 displays the processes getting the largest percentage of the processor  displays the processes getting the largest percentage of the processor
 in the lower window.  Other displays show swap space usage, disk  in the lower window.
   Other displays show swap space usage, disk
 .Tn I/O  .Tn I/O
 statistics (a la  statistics (a la
 .Xr iostat 8 ) ,  .Xr iostat 8 ) ,
Line 81 
Line 83 
 .Dq global  .Dq global
 command interpreter processes all keyboard input.  command interpreter processes all keyboard input.
 If this command interpreter fails to recognize a command, the  If this command interpreter fails to recognize a command, the
 input line is passed to a per-display command interpreter.  This  input line is passed to a per-display command interpreter.
 allows each display to have certain display-specific commands.  This allows each display to have certain display-specific commands.
 .Pp  .Pp
 Command line options:  The options are as follows:
 .Bl -tag -width "refresh_interval"  .Bl -tag -width "refresh_interval"
 .It Fl M Ar core  .It Fl M Ar core
 Extract values associated with the name list from  Extract values associated with the name list from
Line 112 
Line 114 
 .It Ar refresh-interval  .It Ar refresh-interval
 The  The
 .Ar refresh-interval  .Ar refresh-interval
 specifies the screen refresh time interval in seconds.  This is provided  specifies the screen refresh time interval in seconds.
 for backwards compatibility, and overrides the  This is provided for backwards compatibility, and overrides the
 .Ar refresh-interval  .Ar refresh-interval
 specified with the  specified with the
 .Fl w  .Fl w
Line 136 
Line 138 
 .Nm systat .  .Nm systat .
 .It Ic \&:  .It Ic \&:
 Move the cursor to the command line and interpret the input  Move the cursor to the command line and interpret the input
 line typed as a command.  While entering a command the  line typed as a command.
   While entering a command the
 current character erase, word erase, and line kill characters  current character erase, word erase, and line kill characters
 may be used.  may be used.
 .El  .El
Line 156 
Line 159 
 .Op Ic start  .Op Ic start
 .Op Ar number  .Op Ar number
 .Xc  .Xc
 Start (continue) refreshing the screen.  If a second, numeric,  Start (continue) refreshing the screen.
   If a second, numeric,
 argument is provided it is interpreted as a refresh interval  argument is provided it is interpreted as a refresh interval
 (in seconds).  (in seconds).
 Supplying only a number will set the refresh interval to this  Supplying only a number will set the refresh interval to this
Line 181 
Line 185 
 process.  process.
 .It Ic iostat  .It Ic iostat
 Display, in the lower window, statistics about processor use  Display, in the lower window, statistics about processor use
 and disk throughput.  Statistics on processor use appear as  and disk throughput.
 bar graphs of the amount of time executing in user mode (``user''),  Statistics on processor use appear as
 in user mode running low priority processes (``nice''), in  bar graphs of the amount of time executing in user mode
 system mode (``system''), and idle (``idle'').  Statistics  .Pq Dq user ,
   in user mode running low priority processes
   .Pq Dq nice ,
   in system mode
   .Pq Dq system ,
   and idle
   .Pq Dq idle .
   Statistics
 on disk throughput show, for each drive, kilobytes of data transferred,  on disk throughput show, for each drive, kilobytes of data transferred,
 number of disk transactions performed, and time spent in disk accesses  number of disk transactions performed, and time spent in disk accesses
 (in milliseconds).  This information may be displayed as  (in milliseconds).
 bar graphs or as rows of numbers which scroll downward.  Bar  This information may be displayed as
 graphs are shown by default.  bar graphs or as rows of numbers which scroll downward.
   Bar graphs are shown by default.
 .Pp  .Pp
 The following commands are specific to the  The following commands are specific to the
 .Ic iostat  .Ic iostat
Line 199 
Line 211 
 .It Cm numbers  .It Cm numbers
 Show the disk  Show the disk
 .Tn I/O  .Tn I/O
 statistics in numeric form.  Values are  statistics in numeric form.
 displayed in numeric columns which scroll downward.  Values are displayed in numeric columns which scroll downward.
 .It Cm bars  .It Cm bars
 Show the disk  Show the disk
 .Tn I/O  .Tn I/O
Line 223 
Line 235 
 Areas known to the kernel but not in use are shown as not available.  Areas known to the kernel but not in use are shown as not available.
 .It Ic mbufs  .It Ic mbufs
 Display, in the lower window, the number of mbufs allocated  Display, in the lower window, the number of mbufs allocated
 for particular uses, i.e. data, socket structures, etc.  for particular uses, i.e., data, socket structures, etc.
 .It Ic vmstat  .It Ic vmstat
 Take over the entire display and show a (rather crowded) compendium  Take over the entire display and show a (rather crowded) compendium
 of statistics related to virtual memory usage, process scheduling,  of statistics related to virtual memory usage, process scheduling,
Line 262 
Line 274 
 .Pq Sq w .  .Pq Sq w .
 Below the queue length listing is a numerical listing and  Below the queue length listing is a numerical listing and
 a bar graph showing the amount of  a bar graph showing the amount of
 system (shown as `='), user (shown as `>'),  system (shown as
 nice (shown as `-'), and idle time (shown as ` ').  .Ql = ) ,
   user (shown as
   .Ql > ) ,
   nice (shown as
   .Ql - ) ,
   and idle time (shown as
   .Ql \  ) .
 .Pp  .Pp
 To the right of the Proc display are statistics about  To the right of the Proc display are statistics about
 Context switches (`Csw'), Traps (`Trp'), Syscalls (`Sys'),  Context switches
 Interrupts (`Int'), Soft interrupts (`Sof'), and Faults (`Flt')  .Pq Dq Csw ,
   Traps
   .Pq Dq Trp ,
   Syscalls
   .Pq Dq Sys ,
   Interrupts
   .Pq Dq Int ,
   Soft interrupts
   .Pq Dq Sof ,
   and Faults
   .Pq Dq Flt
 which have occurred during the last refresh interval.  which have occurred during the last refresh interval.
 .Pp  .Pp
 Below the CPU Usage graph are statistics on name translations.  Below the CPU Usage graph are statistics on name translations.
Line 354 
Line 382 
 .Ic vmstat  .Ic vmstat
 display; the minimum unambiguous prefix may be supplied.  display; the minimum unambiguous prefix may be supplied.
 .Pp  .Pp
 .Bl -tag -width Ar -compact  .Bl -tag -width Ds -compact
 .It Cm boot  .It Cm boot
 Display cumulative statistics since the system was booted.  Display cumulative statistics since the system was booted.
 .It Cm run  .It Cm run
Line 366 
Line 394 
 Reset running statistics to zero.  Reset running statistics to zero.
 .El  .El
 .It Ic netstat  .It Ic netstat
 Display, in the lower window, network connections.  By default,  Display, in the lower window, network connections.
 network servers awaiting requests are not displayed.  Each address  By default, network servers awaiting requests are not displayed.
 is displayed in the format ``host.port'', with each shown symbolically,  Each address
 when possible.  It is possible to have addresses displayed numerically,  is displayed in the format
   .Dq host.port ,
   with each shown symbolically, when possible.
   It is possible to have addresses displayed numerically,
 limit the display to a set of ports, hosts, and/or protocols  limit the display to a set of ports, hosts, and/or protocols
 (the minimum unambiguous prefix may be supplied):  (the minimum unambiguous prefix may be supplied):
 .Pp  .Bl -tag -width Ar
 .Bl -tag -width Ar -compact  
 .It Cm all  .It Cm all
 Toggle the displaying of server processes awaiting requests (this  Toggle the displaying of server processes awaiting requests (this
 is the equivalent of the  is the equivalent of the
Line 384 
Line 414 
 Display network addresses numerically.  Display network addresses numerically.
 .It Cm names  .It Cm names
 Display network addresses symbolically.  Display network addresses symbolically.
 .It Ar protocol  .It Cm protocol
 Display only network connections using the indicated protocol  Display only network connections using the indicated protocol
 (currently either  (currently either
 .Dq tcp  .Dq tcp
Line 392 
Line 422 
 .Dq udp ) .  .Dq udp ) .
 .It Cm ignore Op Ar items  .It Cm ignore Op Ar items
 Do not display information about connections associated with  Do not display information about connections associated with
 the specified hosts or ports.  Hosts and ports may be specified  the specified hosts or ports.
 by name (``vangogh'', ``ftp''), or numerically.  Host addresses  Hosts and ports may be specified
 use the Internet dot notation (``128.32.0.9'').  Multiple items  by name
   .Pf ( Dq vangogh ,
   .Dq ftp ) ,
   or numerically.
   Host addresses
   use the Internet dot notation
   .Pq Dq 128.32.0.9 .
   Multiple items
 may be specified with a single command by separating them with  may be specified with a single command by separating them with
 spaces.  spaces.
 .It Cm display Op Ar items  .It Cm display Op Ar items
 Display information about the connections associated with the  Display information about the connections associated with the
 specified hosts or ports.  As for  specified hosts or ports.
   As for
 .Ar ignore ,  .Ar ignore ,
 .Ar items  .Ar items
 may be names or numbers.  may be names or numbers.
 .It Cm show Op Ar ports\&|hosts  .It Cm show Op Ar ports\&|hosts
 Show, on the command line, the currently selected protocols,  Show, on the command line, the currently selected protocols,
 hosts, and ports.  Hosts and ports which are being ignored  hosts, and ports.
 are prefixed with a `!'.  If  Hosts and ports which are being ignored are prefixed with a
   .Ql ! .
   If
 .Ar ports  .Ar ports
 or  or
 .Ar hosts  .Ar hosts
Line 420 
Line 460 
 .El  .El
 .Pp  .Pp
 Commands to switch between displays may be abbreviated to the  Commands to switch between displays may be abbreviated to the
 minimum unambiguous prefix; for example, ``io'' for ``iostat''.  minimum unambiguous prefix; for example,
   .Dq io
   for
   .Dq iostat .
 Certain information may be discarded when the screen size is  Certain information may be discarded when the screen size is
 insufficient for display.  For example, on a machine with 10  insufficient for display.
 drives the  For example, on a machine with 10 drives the
 .Ic iostat  .Ic iostat
 bar graph displays only 3 drives on a 24 line terminal.  When  bar graph displays only 3 drives on a 24 line terminal.
 a bar graph would overflow the allotted screen space it is  When a bar graph would overflow the allotted screen space it is
 truncated and the actual value is printed ``over top'' of the bar.  truncated and the actual value is printed
   .Dq over top
   of the bar.
 .Pp  .Pp
 The following commands are common to each display which shows  The following commands are common to each display which shows
 information about disk drives.  These commands are used to  information about disk drives.
   These commands are used to
 select a set of drives to report on, should your system have  select a set of drives to report on, should your system have
 more drives configured than can normally be displayed on the  more drives configured than can normally be displayed on the
 screen.  screen.
 .Pp  .Pp
 .Bl -tag -width Tx -compact  .Bl -tag -width Tx -compact
 .It Cm ignore Op Ar drives  .It Cm ignore Op Ar drives
 Do not display information about the drives indicated.  Multiple  Do not display information about the drives indicated.
 drives may be specified, separated by spaces.  Multiple drives may be specified, separated by spaces.
 .It Cm display Op Ar drives  .It Cm display Op Ar drives
 Display information about the drives indicated.  Multiple drives  Display information about the drives indicated.
 may be specified, separated by spaces.  Multiple drives may be specified, separated by spaces.
 .El  .El
 .Sh FILES  .Sh FILES
 .Bl -tag -width /etc/networks -compact  .Bl -tag -width /etc/networks -compact
Legend:
Removed from v.1.15  
changed lines
  Added in v.1.16