[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.72 and 1.73

version 1.72, 2008/11/08 15:46:49 version 1.73, 2008/11/17 08:10:51
Line 46 
Line 46 
 .Op Ar delay  .Op Ar delay
 .Sh DESCRIPTION  .Sh DESCRIPTION
 .Nm  .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
 .Xr curses 3 .  .Xr curses 3
   screen display library.
 .Pp  .Pp
 While  While
 .Nm  .Nm
 is running the screen is usually divided into two windows (an exception  is running, the screen is divided into differing areas.
 is the vmstat display which uses the entire screen).  The top line depicts the current system load average.
 The upper window depicts the current system load average.  The bottom line of the screen is reserved for
 The information displayed in the lower window may vary, depending on  user input and error messages.
 user commands.  The information displayed in the rest of the screen
 The last line on the screen is reserved for user  comprises a
 input and error messages.  .Em view ,
   and is the main interface for
   displaying differing types of system statistics.
   The
   .Ic vmstat
   view is the default.
 .Pp  .Pp
 By default  
 .Nm  
 displays the processes getting the largest percentage of the processor  
 in the lower window.  
 Other displays include swap space usage, disk I/O  
 statistics (a la  
 .Xr iostat 8 ) ,  
 virtual memory statistics (a la  
 .Xr vmstat 8 ) ,  
 network  
 .Dq mbuf  
 utilization, and network connections (a la  
 .Xr netstat 1 ) .  
 .Pp  
 Input is interpreted at two different levels.  Input is interpreted at two different levels.
 A  A
 .Dq global  .Dq global
Line 95 
Line 87 
 .It Fl i  .It Fl i
 Interactive mode.  Interactive mode.
 .It Fl n  .It Fl n
 Do not try to reverse-map IP address.  Do not try to reverse map IP addresses.
 .It Fl s Ar delay  .It Fl s Ar delay
 Specifies the screen refresh time interval in seconds.  Specifies the screen refresh time interval in seconds.
 This option is overridden by the final  This option is overridden by the final
 .Ar delay  .Ar delay
 argument if given.  argument, if given.
 The default interval is 5 seconds.  The default interval is 5 seconds.
 .It Fl w Ar width  .It Fl w Ar width
 Specifies the maximum width of the display.  Specifies the maximum width of the display.
Line 136 
Line 128 
 .It Ar delay  .It Ar delay
 The  The
 .Ar delay  .Ar delay
 specifies the screen refresh time interval in seconds.  argument specifies the screen refresh time interval in seconds.
 This is provided for backwards compatibility, and overrides the  This is provided for backwards compatibility, and overrides any
 .Ar wait  
 interval specified with the  interval specified with the
 .Fl w  .Fl s
 flag.  flag.
 The default interval is 5 seconds.  The default interval is 5 seconds.
 .El  .El
Line 164 
Line 155 
 Pause  Pause
 .Nm .  .Nm .
 .It Ic q  .It Ic q
 Exit  Quit
 .Nm .  .Nm .
 .It Ic r  .It Ic r
 Reverse the selected ordering if supported by the view.  Reverse the selected ordering if supported by the view.
Line 178 
Line 169 
 Select the next view.  Select the next view.
 .It Ic ^G  .It Ic ^G
 Print the name of the current  Print the name of the current
 .Dq display  view being shown and the refresh interval.
 being shown in  
 the lower window and the refresh interval.  
 .It Ic ^L  .It Ic ^L
 Refresh the screen.  Refresh the screen.
 .It Ic ^N \*(Ba Aq Ic down arrow  .It Ic ^N \*(Ba Aq Ic down arrow
Line 201 
Line 190 
 command interpreter.  command interpreter.
 .Bl -tag -width Fl  .Bl -tag -width Fl
 .It Ic help  .It Ic help
 Print the names of the available displays on the command line.  Print the names of the available views on the command line.
 .It Ic load  .It Ic load
 Print the load average over the past 1, 5, and 15 minutes  Print the load average over the past 1, 5, and 15 minutes
 on the command line.  on the command line.
 .It Ic quit  .It Ic quit
 Exit  Quit
 .Nm .  .Nm .
 (This may be abbreviated to  (This may be abbreviated to
 .Ic q . )  .Ic q . )
Line 224 
Line 213 
 value.  value.
 .El  .El
 .Pp  .Pp
 Again,  .Ar view
 .Ar display  
 may be abbreviated to the minimum unambiguous prefix.  may be abbreviated to the minimum unambiguous prefix.
 The available displays are:  The available views are:
 .Bl -tag -width "netstatXXX"  .Bl -tag -width "netstatXXX"
 .It Ic buckets  .It Ic buckets
 Display kernel  Display kernel
Line 235 
Line 223 
 bucket statistics similar to the output of  bucket statistics similar to the output of
 .Cm vmstat Fl m .  .Cm vmstat Fl m .
 .It Ic ifstat  .It Ic ifstat
 Display, in the lower window, interface statistics.  Display interface statistics.
 The  The
 .Dq State  .Dq State
 column has the format  column has the format
Line 258 
Line 246 
 interfaces, whether the interface is in master or backup state, respectively.  interfaces, whether the interface is in master or backup state, respectively.
 See below for more options.  See below for more options.
 .It Ic iostat  .It Ic iostat
 Display, in the lower window, statistics about disk throughput.  Display statistics about disk throughput.
 Statistics  Statistics
 on disk throughput show, for each drive, data transferred in kilobytes,  on disk throughput show, for each drive, data transferred in kilobytes,
 number of disk transactions performed, and time spent in disk accesses  number of disk transactions performed, and time spent in disk accesses
Line 275 
Line 263 
 and  and
 .Ic requests .  .Ic requests .
 .It Ic mbufs  .It Ic mbufs
 Display, in the lower window, the number of mbufs allocated  Display the number of mbufs allocated
 for particular uses, i.e., data, socket structures, etc.  for particular uses,
   such as data and socket structures.
 .It Ic netstat  .It Ic netstat
 Display, in the lower window, network connections.  Display network connections.
 By default, network servers awaiting requests are not displayed.  By default, network servers awaiting requests are not displayed.
 Each address  Each address
 is displayed in the format  is displayed in the format
Line 342 
Line 331 
 .Cm pfctl Fl s Cm info  .Cm pfctl Fl s Cm info
 option.  option.
 .It Ic pigs  .It Ic pigs
 Display, in the lower window, those processes resident in main  Display those processes resident in main
 memory and getting the  memory and getting the
 largest portion of the processor (the default display).  largest portion of the processor.
 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  is accounted to the
Line 368 
Line 357 
 Display pf rules statistics, similar to the output of  Display pf rules statistics, similar to the output of
 .Cm pfctl Fl s Cm rules .  .Cm pfctl Fl s Cm rules .
 .It Ic sensors  .It Ic sensors
 Display, in the lower window,  Display the current values of available hardware sensors,
 the current values of available hardware sensors,  
 in a format similar to that of  in a format similar to that of
 .Xr sysctl 8 .  .Xr sysctl 8 .
 .It Ic states  .It Ic states
Line 405 
Line 393 
 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,
 device interrupts, system name translation caching, disk I/O etc.  device interrupts, system name translation caching, disk I/O etc.
   This view is the default.
 .Pp  .Pp
 The upper left quadrant of the screen shows the number  The upper left quadrant of the screen shows the number
 of users logged in and the load average over the last 1, 5,  of users logged in and the load average over the last 1, 5,
Line 550 
Line 539 
 .Ic vmstat  .Ic vmstat
 and  and
 .Ic ifstat  .Ic ifstat
 displays; the minimum unambiguous prefix may be supplied.  views; the minimum unambiguous prefix may be supplied.
 .Pp  .Pp
 .Bl -tag -width Ds -compact  .Bl -tag -width Ds -compact
 .It Cm boot  .It Cm boot
Line 574 
Line 563 
 .Dq over top  .Dq over top
 of the bar.  of the bar.
 .Pp  .Pp
 The following commands are common to each display which shows  The following commands are common to each view which shows
 information about disk drives.  information about disk drives.
 These commands are used to  These commands are used to select a set of drives to report on,
 select a set of drives to report on, should your system have  should a system have more drives configured
 more drives configured than can normally be displayed on the  than can normally be displayed on the screen.
 screen.  
 .Pp  .Pp
 .Bl -tag -width Tx -compact  .Bl -tag -width Tx -compact
 .It Cm display Op Ar drives  .It Cm display Op Ar drives
Line 590 
Line 578 
 Multiple drives 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/networksXXX" -compact
 .It Pa /etc/hosts  .It Pa /etc/hosts
 host names  Host names.
 .It Pa /etc/networks  .It Pa /etc/networks
 network names  Network names.
 .It Pa /etc/pf.conf  .It Pa /etc/pf.conf
 pf and altq configuration  .Xr pf 4
   configuration.
 .It Pa /etc/services  .It Pa /etc/services
 port names  Port names.
 .El  .El
 .Sh SEE ALSO  .Sh SEE ALSO
 .Xt fstat 1 ,  .Xt fstat 1 ,
Line 615 
Line 604 
 .Sh HISTORY  .Sh HISTORY
 The  The
 .Nm  .Nm
 program appeared in  program first appeared in
 .Bx 4.3 .  .Bx 4.3 .
 .Sh BUGS  .Sh BUGS
 Certain displays presume a minimum of 80 characters per line.  Certain displays presume a minimum of 80 characters per line.
Legend:
Removed from v.1.72  
changed lines
  Added in v.1.73