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

Diff for /src/usr.bin/top/top.1 between version 1.22 and 1.23

version 1.22, 2003/09/02 18:50:07 version 1.23, 2003/09/19 10:32:24
Line 31 
Line 31 
 .Nd display and update information about the top CPU processes  .Nd display and update information about the top CPU processes
 .Sh SYNOPSIS  .Sh SYNOPSIS
 .Nm top  .Nm top
 .Op Fl SbiInqu  .Op Fl biInqSu
 .Op Fl d Ar count  .Op Fl d Ar count
 .Op Fl s Ar time  
 .Op Fl o Ar field  .Op Fl o Ar field
   .Op Fl s Ar time
 .Op Fl U Ar username  .Op Fl U Ar username
 .Op Ar number  .Op Ar number
 .Sh DESCRIPTION  .Sh DESCRIPTION
Line 70 
Line 70 
 .Pp  .Pp
 The options are as follows:  The options are as follows:
 .Bl -tag -width Ds  .Bl -tag -width Ds
 .It Fl S  
 Show system processes in the display.  
 Normally, system processes such as the pager and the swapper are not shown.  
 This option makes them visible.  
 .It Fl b  .It Fl b
 Use  Use
 .Em batch  .Em batch
Line 85 
Line 81 
 .Ql ^\e )  .Ql ^\e )
 still have an effect.  still have an effect.
 This is the default on a dumb terminal, or when the output is not a terminal.  This is the default on a dumb terminal, or when the output is not a terminal.
   .It Fl d Ar count
   Show only
   .Ar count
   displays, then exit.
   A display is considered to be one update of the screen.
   This option allows the user to select the number of displays
   to be shown before
   .Nm
   automatically exits.
   For intelligent terminals, no upper limit is set.
   The default is 1 for dumb terminals.
 .It Fl i  .It Fl i
 Use  Use
 .Em interactive  .Em interactive
Line 107 
Line 114 
 This is identical to  This is identical to
 .Em batch  .Em batch
 mode.  mode.
   .It Fl o Ar field
   Sort the process display area using the specified field as the primary key.
   The field name is the name of the column as seen in the output,
   but in lower case.
   The
   .Ox
   version of top supports
   .Ar cpu ,
   .Ar size ,
   .Ar res ,
   .Ar time ,
   and
   .Ar pri .
 .It Fl q  .It Fl q
 Renice  Renice
 .Nm  .Nm
Line 114 
Line 134 
 This can be used when the system is  This can be used when the system is
 being very sluggish to improve the possibility of discovering the problem.  being very sluggish to improve the possibility of discovering the problem.
 This option can only be used by root.  This option can only be used by root.
   .It Fl s Ar time
   Set the delay between screen updates to
   .Ar time
   seconds.
   The value may be fractional, to permit delays of less than 1 second.
   The default delay between updates is 5 seconds.
   .It Fl S
   Show system processes in the display.
   Normally, system processes such as the pager and the swapper are not shown.
   This option makes them visible.
 .It Fl u  .It Fl u
 Do not take the time to map UID numbers to usernames.  Do not take the time to map UID numbers to usernames.
 Normally,  Normally,
Line 123 
Line 153 
 This option  This option
 disables all that, while possibly decreasing execution time.  disables all that, while possibly decreasing execution time.
 The UID numbers are displayed instead of the names.  The UID numbers are displayed instead of the names.
 .It Fl d Ar count  
 Show only  
 .Ar count  
 displays, then exit.  
 A display is considered to be one update of the screen.  
 This option allows the user to select the number of displays  
 to be shown before  
 .Nm  
 automatically exits.  
 For intelligent terminals, no upper limit is set.  
 The default is 1 for dumb terminals.  
 .It Fl s Ar time  
 Set the delay between screen updates to  
 .Ar time  
 seconds.  
 The value may be fractional, to permit delays of less than 1 second.  
 The default delay between updates is 5 seconds.  
 .It Fl o Ar field  
 Sort the process display area using the specified field as the primary key.  
 The field name is the name of the column as seen in the output,  
 but in lower case.  
 The  
 .Ox  
 version of top supports  
 .Ar cpu ,  
 .Ar size ,  
 .Ar res ,  
 .Ar time ,  
 and  
 .Ar pri .  
 .It Fl U Ar username  .It Fl U Ar username
 Show only those processes owned by  Show only those processes owned by
 .Ar username .  .Ar username .
Line 238 
Line 238 
 .It q  .It q
 Quit  Quit
 .Nm top .  .Nm top .
   .El
   .Pp
   The following commands may not be available with overstrike terminals:
   .Bl -tag -width XxXXXX
 .It d  .It d
 Change the number of displays to show (prompt for new number).  Change the number of displays to show (prompt for new number).
 Remember that the next display counts as one, so typing  Remember that the next display counts as one, so typing
Line 245 
Line 249 
 will make  will make
 .Nm  .Nm
 show one final display and then immediately exit.  show one final display and then immediately exit.
 .It n or #  .It e
 Change the number of processes to display (prompt for new number).  Display a list of system errors (if any) generated by the last
 .It s  .Li kill
 Change the number of seconds to delay between displays  or
 (prompt for new number).  .Li renice
   command.
   .It i or I
   Toggle the display of idle processes.
 .It k  .It k
 Send a signal  Send a signal
 .Pf ( Dv TERM  .Pf ( Dv TERM
 by default) to a list of processes.  by default) to a list of processes.
 This acts similarly to the command  This acts similarly to the command
 .Xr kill 1 .  .Xr kill 1 .
   .It n or #
   Change the number of processes to display (prompt for new number).
   .It o
   Change the sorting order of the processes
   .Pq prompt for order .
   Values are the same as for the
   .Fl o
   flag, as detailed above.
 .It r  .It r
 Change the priority (the  Change the priority (the
 .Em nice )  .Em nice )
 of a list of processes.  of a list of processes.
 This acts similarly to the command  This acts similarly to the command
 .Xr renice 8 .  .Xr renice 8 .
   .It s
   Change the number of seconds to delay between displays
   (prompt for new number).
   .It S
   Toggle the display of system processes.
 .It u  .It u
 Display only processes owned by a specific username (prompt for username).  Display only processes owned by a specific username (prompt for username).
 If the username specified is simply  If the username specified is simply
 .Dq + ,  .Dq + ,
 then processes belonging to all users will be displayed.  then processes belonging to all users will be displayed.
 .It e  
 Display a list of system errors (if any) generated by the last  
 .Li kill  
 or  
 .Li renice  
 command.  
 .It i or I  
 Toggle the display of idle processes.  
 .It S  
 Toggle the display of system processes.  
 .El  .El
 .Sh THE DISPLAY  .Sh THE DISPLAY
 .\" The actual display varies depending on the specific variant of Unix  .\" The actual display varies depending on the specific variant of Unix
Legend:
Removed from v.1.22  
changed lines
  Added in v.1.23