version 1.26, 2005/05/13 20:43:30 |
version 1.27, 2005/05/14 09:03: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 biInqSu |
.Op Fl bIinqSu |
.Op Fl d Ar count |
.Op Fl d Ar count |
.Op Fl o Ar field |
.Op Fl o Ar field |
.Op Fl p Ar pid |
.Op Fl p Ar pid |
|
|
automatically exits. |
automatically exits. |
For intelligent terminals, no upper limit is set. |
For intelligent terminals, no upper limit is set. |
The default is 1 for dumb terminals. |
The default is 1 for dumb terminals. |
|
.It Fl I |
|
Do not display idle processes. |
|
By default, |
|
.Nm |
|
displays both active and idle processes. |
.It Fl i |
.It Fl i |
Use |
Use |
.Em interactive |
.Em interactive |
|
|
is processed, the screen will immediately be updated, even if the command was |
is processed, the screen will immediately be updated, even if the command was |
not understood. |
not understood. |
This mode is the default when standard output is an intelligent terminal. |
This mode is the default when standard output is an intelligent terminal. |
.It Fl I |
|
Do not display idle processes. |
|
By default, |
|
.Nm |
|
displays both active and idle processes. |
|
.It Fl n |
.It Fl n |
Use |
Use |
.Em non-interactive |
.Em non-interactive |
|
|
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 |
|
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 s Ar time |
.It Fl s Ar time |
Set the delay between screen updates to |
Set the delay between screen updates to |
.Ar time |
.Ar time |
seconds. |
seconds. |
The value may be fractional, to permit delays of less than 1 second. |
The value may be fractional, to permit delays of less than 1 second. |
The default delay between updates is 5 seconds. |
The default delay between updates is 5 seconds. |
.It Fl S |
.It Fl U Ar username |
Show system processes in the display. |
Show only those processes owned by |
Normally, system processes such as the pager and the swapper are not shown. |
.Ar username . |
This option makes them visible. |
This option currently only accepts usernames and will not understand |
|
UID numbers. |
.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, |
|
|
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 U Ar username |
|
Show only those processes owned by |
|
.Ar username . |
|
This option currently only accepts usernames and will not understand |
|
UID numbers. |
|
.El |
.El |
.Pp |
.Pp |
Both |
Both |
|
|
.Pp |
.Pp |
These commands are currently recognized (^L refers to control-L): |
These commands are currently recognized (^L refers to control-L): |
.Bl -tag -width XxXXXX |
.Bl -tag -width XxXXXX |
.It ^L |
|
Redraw the screen. |
|
.It h or \&? |
.It h or \&? |
Display a summary of the commands (help screen). |
Display a summary of the commands (help screen). |
|
.It ^L |
|
Redraw the screen. |
.It q |
.It q |
Quit |
Quit |
.Nm top . |
.Nm top . |
|
|
or |
or |
.Li renice |
.Li renice |
command. |
command. |
.It i or I |
.It I or i |
Toggle the display of idle processes. |
Toggle the display of idle processes. |
.It k |
.It k |
Send a signal |
Send a signal |
|
|
PIDs, all separated by space). |
PIDs, all separated by space). |
This acts similarly to the command |
This acts similarly to the command |
.Xr renice 8 . |
.Xr renice 8 . |
|
.It S |
|
Toggle the display of system processes. |
.It s |
.It s |
Change the number of seconds to delay between displays |
Change the number of seconds to delay between displays |
(prompt for new number). |
(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 |