[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.12 and 1.13

version 1.12, 1999/06/05 01:21:42 version 1.13, 1999/06/26 13:19:17
Line 48 
Line 48 
 .Op Ar display  .Op Ar display
 .Op Ar refresh-interval  .Op Ar refresh-interval
 .Sh DESCRIPTION  .Sh DESCRIPTION
 .Nm systat  .Nm
 displays various system statistics in a screen oriented fashion  displays various system statistics in a screen oriented fashion
 using the curses screen display library,  using the curses screen display library,
 .Xr curses 3 .  .Xr curses 3 .
 .Pp  .Pp
 While  While
 .Nm systat  .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).  The
 upper window depicts the current system load average.  The  upper window depicts the current system load average.  The
Line 63 
Line 63 
 input and error messages.  input and error messages.
 .Pp  .Pp
 By default  By default
 .Nm systat  .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 ) ,
 virtual memory statistics (a la  virtual memory statistics (a la
 .Xr vmstat  8  ) ,  .Xr vmstat 8 ) ,
 network ``mbuf'' utilization, and network connections (a la  network
 .Xr netstat  1  ) .  .Dq mbuf
   utilization, and network connections (a la
   .Xr netstat 1 ) .
 .Pp  .Pp
 Input is interpreted at two different levels.  Input is interpreted at two different levels.
 A ``global'' command interpreter processes all keyboard input.  A
   .Dq global
   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.  This
 allows each display to have certain display-specific commands.  allows each display to have certain display-specific commands.
Line 117 
Line 121 
 .El  .El
 .Pp  .Pp
 Certain characters cause immediate action by  Certain characters cause immediate action by
 .Nm systat  .  .Nm systat .
 These are  These are
 .Bl -tag -width Fl  .Bl -tag -width Fl
 .It Ic \&^L  .It Ic \&^L
 Refresh the screen.  Refresh the screen.
 .It Ic \&^G  .It Ic \&^G
 Print the name of the current ``display'' being shown in  Print the name of the current
   .Dq display
   being shown in
 the lower window and the refresh interval.  the lower window and the refresh interval.
 .It Ic \&^Z  .It Ic \&^Z
 Stop  Stop
 .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
Line 135 
Line 141 
 may be used.  may be used.
 .El  .El
 .Pp  .Pp
 The following commands are interpreted by the ``global''  The following commands are interpreted by the
   .Dq global
 command interpreter.  command interpreter.
 .Bl -tag -width Fl  .Bl -tag -width Fl
 .It Ic help  .It Ic help
Line 156 
Line 163 
 value.  value.
 .It Ic quit  .It Ic quit
 Exit  Exit
 .Nm systat  .  .Nm systat .
 (This may be abbreviated to  (This may be abbreviated to
 .Ic q  . )  .Ic q . )
 .El  .El
 .Pp  .Pp
 The available displays are:  The available displays are:
Line 169 
Line 176 
 largest portion of the processor (the default display).  largest portion of the processor (the default display).
 When less than 100% of the  When less than 100% of the
 processor is scheduled to user processes, the remaining time  processor is scheduled to user processes, the remaining time
 is accounted to the ``idle'' process.  is accounted to the
   .Dq idle
   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.  Statistics on processor use appear as
Line 241 
Line 250 
 on the free list.  on the free list.
 .Pp  .Pp
 Below the memory display is a list of the average number of processes  Below the memory display is a list of the average number of processes
 (over the last refresh interval) that are runnable (`r'), in page wait (`p'),  (over the last refresh interval) that are runnable
 in disk wait other than paging (`d'),  .Pq Sq r ,
 sleeping (`s'), and swapped out but desiring to run (`w').  in page wait
   .Pq Sq p ,
   in disk wait other than paging
   .Pq Sq d ,
   sleeping
   .Pq Sq s ,
   and swapped out but desiring to run
   .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 `='), user (shown as `>'),
Line 327 
Line 343 
 intransit blocking page faults  intransit blocking page faults
 .El  .El
 .Pp  .Pp
 The `%zfod' value is more interesting when observed over a long  The
   .Ql %zfod
   value is more interesting when observed over a long
 period, such as from boot time (see the  period, such as from boot time (see the
 .Cm boot  .Cm boot
 option below).  option below).
Line 361 
Line 379 
 is the equivalent of the  is the equivalent of the
 .Fl a  .Fl a
 flag to  flag to
 .Ar netstat  1  ) .  .Xr netstat 1 ) .
 .It Cm numbers  .It Cm numbers
 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 Ar protocol
 Display only network connections using the indicated protocol  Display only network connections using the indicated protocol
 (currently either ``tcp'' or ``udp'').  (currently either
   .Dq tcp
   or
   .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.  Hosts and ports may be specified
Line 379 
Line 400 
 .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
Line 390 
Line 411 
 or  or
 .Ar hosts  .Ar hosts
 is supplied as an argument to  is supplied as an argument to
 .Cm show  ,  .Cm show ,
 then only the requested information will be displayed.  then only the requested information will be displayed.
 .It Cm reset  .It Cm reset
 Reset the port, host, and protocol matching mechanisms to the default  Reset the port, host, and protocol matching mechanisms to the default
Line 431 
Line 452 
 .It Pa /dev/drum  .It Pa /dev/drum
 for information about swapped out processes  for information about swapped out processes
 .It Pa /etc/hosts  .It Pa /etc/hosts
 or host names  for host names
 .It Pa /etc/networks  .It Pa /etc/networks
 for network names  for network names
 .It Pa /etc/services  .It Pa /etc/services
 or port names  for port names
 .El  .El
 .Sh HISTORY  .Sh HISTORY
 The  The
 .Nm systat  .Nm
 program appeared in  program appeared in
 .Bx 4.3 .  .Bx 4.3 .
 .Sh BUGS  .Sh BUGS
Legend:
Removed from v.1.12  
changed lines
  Added in v.1.13