pool/procps
SHA256
4
0
Fork 1
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
procps/procps-v3.3.4-top.1.diff
Dr. Werner Fink 8d27d8be6b . 
OBS-URL: https://build.opensuse.org/package/show/Base:System/procps?expand=0&rev=81
2012-10-30 13:13:12 +00:00

404 lines
16 KiB
Diff
Raw Blame History

--- top/top.1
+++ top/top.1 2012-10-30 11:10:06.558844692 +0000
@@ -23,7 +23,7 @@
..
\# Setup ////////////////////////////////////////////////////////////////
\# ** Comment out '.nr' or set to 0 to eliminate WIDTH fiddlin' !
-.nr half_xtra 4
+.nr half_xtra 0
.
.ll +(\n[half_xtra] + \n[half_xtra])
.
@@ -46,18 +46,18 @@
.ds F \fIOff\fR
.ds O \fIOn\fR
.
-.ds AK asterisk (\'*\')
+.ds AK asterisk ('*')
.ds AM alternate\-display mode
.ds AS auxiliary storage
.ds CF configuration file
-.ds CG \'current\' window/field group
+.ds CG 'current' window/field group
.ds CI interactive command
\# - Note: our 'Command Line' used in 2 places
.ds CL \-\fBhv\fR|\-\fBbcHiSs\fR \-\fBd\fR delay \-\fBn\fR limit \
\-\fBu\fR|\fBU\fR user \-\fBp\fR pid[,pid] \-\fBw\fR [cols] \fR
.ds CO command\-line option
.ds CT command toggle
-.ds CW \'current\' window
+.ds CW 'current' window
.ds FG field group
.ds FM full\-screen mode
.ds KA arrow key
@@ -854,7 +854,7 @@ Use either of these keys if you have a l
to see current status,
.TP 7
-\ \ \'\fB?\fR\' | \'\fBh\fR\' :\fIHelp \fR
+\ \ '\fB?\fR' | '\fBh\fR' :\fIHelp \fR
There are two help levels available.
The first will provide a reminder of all the basic \*(CIs.
If \*(We is\fI secured\fR, that screen will be abbreviated.
@@ -863,7 +863,7 @@ Typing 'h' or '?' on that help screen wi
those \*(CIs applicable to \*(AM.
.TP 7
-\ \ \'\fB=\fR\' :\fIExit-Task-Limits \fR
+\ \ '\fB=\fR' :\fIExit-Task-Limits \fR
Removes restrictions on which tasks are shown.
This command will reverse any 'i' (idle tasks) and 'n' (max tasks)
commands that might be active.
@@ -879,13 +879,13 @@ vertical and horizontal scrolling.
When operating in \*(AM this command has a broader meaning.
.TP 7
-\ \ \'\fBA\fR\' :\fIAlternate-Display-Mode\fR toggle \fR
+\ \ '\fBA\fR' :\fIAlternate-Display-Mode\fR toggle \fR
This command will switch between \*(FM and \*(AM.
\*(XT 5. ALTERNATE\-DISPLAY Provisions and the 'g' \*(CI for insight
into \*(CWs and \*(FGs.
.TP 7
-\ \ \'\fBB\fR\' :\fIBold-Disable/Enable\fR toggle \fR
+\ \ '\fBB\fR' :\fIBold-Disable/Enable\fR toggle \fR
This command will influence use of the 'bold' terminfo capability and
alters\fB both\fR the \*(SA and \*(TA for the \*(CW.
While it is intended primarily for use with dumb terminals, it can be
@@ -897,7 +897,7 @@ Thus, unless the 'x' and/or 'y' toggles
there will be no visual confirmation that they are even on.
.TP 7
-*\ \'\fBd\fR\' | \'\fBs\fR\' :\fIChange-Delay-Time-interval \fR
+*\ '\fBd\fR' | '\fBs\fR' :\fIChange-Delay-Time-interval \fR
You will be prompted to enter the delay time, in seconds, between
display updates.
@@ -911,26 +911,26 @@ If at any time you wish to know the curr
help and view the system summary on the second line.
.TP 7
-\ \ \'\fBg\fR\' :\fIChoose-Another-Window/Field-Group \fR
+\ \ '\fBg\fR' :\fIChoose-Another-Window/Field-Group \fR
You will be prompted to enter a number between 1 and 4 designating the
\*(FG which should be made the \*(CW.
You will soon grow comfortable with these 4 windows, especially after
experimenting with \*(AM.
.TP 7
-\ \ \'\fBH\fR\' :\fIThreads-mode\fR toggle \fR
+\ \ '\fBH\fR' :\fIThreads-mode\fR toggle \fR
When this toggle is \*O, individual threads will be displayed for all
processes in all visible \*(TWs.
Otherwise, \*(We displays a summation of all threads in each process.
.TP 7
-\ \ \'\fBI\fR\' :\fIIrix/Solaris-Mode\fR toggle \fR
+\ \ '\fBI\fR' :\fIIrix/Solaris-Mode\fR toggle \fR
When operating in 'Solaris mode' ('I' toggled \*F), a task's \*(Pu usage
will be divided by the total number of \*(PUs.
After issuing this command, you'll be told the new state of this toggle.
.TP 7
-*\ \'\fBk\fR\' :\fIKill-a-task \fR
+*\ '\fBk\fR' :\fIKill-a-task \fR
You will be prompted for a PID and then the signal to send.
The default signal, as reflected in the prompt, is SIGTERM.
However, you can send any signal, via number or name.
@@ -941,24 +941,24 @@ depending on your progress:
2) at the signal prompt, type 0
.TP 7
-\ \ \'\fBq\fR\' :\fIQuit \fR
+\ \ '\fBq\fR' :\fIQuit \fR
.TP 7
-*\ \'\fBr\fR\' :\fIRenice-a-Task \fR
+*\ '\fBr\fR' :\fIRenice-a-Task \fR
You will be prompted for a PID and then the value to nice it to.
Entering a positive value will cause a process to lose priority.
Conversely, a negative value will cause a process to be viewed more
favorably by the kernel.
.TP 7
-\ \ \'\fBW\fR\' :\fIWrite-the-Configuration-File \fR
+\ \ '\fBW\fR' :\fIWrite-the-Configuration-File \fR
This will save all of your options and toggles plus the current
display mode and delay time.
By issuing this command just before quitting \*(We, you will be able
restart later in exactly that same state.
.TP 7
-\ \ \'\fBX\fR\' :\fIExtra-Fixed-Width \fR
+\ \ '\fBX\fR' :\fIExtra-Fixed-Width \fR
Some fields are fixed width and not scalable.
As such, they are subject to truncation which would be indicated
by a '+' in the last position.
@@ -988,7 +988,7 @@ these fields are never decreased by \*(W
To narrow them you must specify a smaller number or restore the defaults.
.TP 7
-\ \ \'\fBZ\fR\' :\fIChange-Color-Mapping \fR
+\ \ '\fBZ\fR' :\fIChange-Color-Mapping \fR
This key will take you to a separate screen where you can change the
colors for the \*(CW, or for all windows.
For details regarding this \*(CI \*(Xt 4d. COLOR Mapping.
@@ -1009,12 +1009,12 @@ These commands always impact just the \*
\*(CWs and \*(FGs.
.TP 7
-\ \ \'\fBl\fR\' :\fILoad-Average/Uptime\fR toggle \fR
+\ \ '\fBl\fR' :\fILoad-Average/Uptime\fR toggle \fR
This is also the line containing the program name (possibly an alias)
when operating in \*(FM or the \*(CW name when operating in \*(AM.
.TP 7
-\ \ \'\fBt\fR\' :\fITask/Cpu-States\fR toggle \fR
+\ \ '\fBt\fR' :\fITask/Cpu-States\fR toggle \fR
This command affects from 2 to many \*(SA lines, depending on the state
of the '1' toggle and whether or not \*(We is running under true SMP.
@@ -1022,7 +1022,7 @@ This portion of the \*(SA is also influe
as reflected in the total label which shows either 'Tasks' or 'Threads'.
.TP 7
-\ \ \'\fB1\fR\' :\fISingle/Separate-Cpu-States\fR toggle \fR
+\ \ '\fB1\fR' :\fISingle/Separate-Cpu-States\fR toggle \fR
This command affects how the 't' command's Cpu States portion is shown.
Although this toggle exists primarily to serve massively-parallel SMP
machines, it is not restricted to solely SMP environments.
@@ -1033,7 +1033,7 @@ Otherwise, each \*(Pu is displayed separ
up to available screen height.
.TP 7
-\ \ \'\fBm\fR\' :\fIMemory/Swap-Usage\fR toggle \fR
+\ \ '\fBm\fR' :\fIMemory/Swap-Usage\fR toggle \fR
This command affects the two \*(SA lines dealing with physical
and virtual memory.
@@ -1056,14 +1056,14 @@ The \*(TA \*(CIs are\fB never available\
.B APPEARANCE\fR of \*(TW
.PD 0
.TP 7
-\ \ \'\fBJ\fR\' :\fIJustify-Numeric-Columns\fR toggle \fR
+\ \ '\fBJ\fR' :\fIJustify-Numeric-Columns\fR toggle \fR
Alternates between right-justified (the default) and
left-justified numeric data.
If the numeric data completely fills the available column, this
\*(CT may impact the column header only.
.TP 7
-\ \ \'\fBj\fR\' :\fIJustify-Character-Columns\fR toggle \fR
+\ \ '\fBj\fR' :\fIJustify-Character-Columns\fR toggle \fR
Alternates between left-justified (the default) and
right-justified character data.
If the character data completely fills the available column, this
@@ -1076,12 +1076,12 @@ global 'B' (bold enable) toggle.
.RS -2
.TP 7
-\ \ \'\fBb\fR\' :\fIBold/Reverse\fR toggle \fR
+\ \ '\fBb\fR' :\fIBold/Reverse\fR toggle \fR
This command will impact how the 'x' and 'y' toggles are displayed.
Further, it will only be available when at least one of those toggles is \*O.
.TP 7
-\ \ \'\fBx\fR\' :\fIColumn-Highlight\fR toggle \fR
+\ \ '\fBx\fR' :\fIColumn-Highlight\fR toggle \fR
Changes highlighting for the current sort field.
If you forget which field is being sorted this command can serve as a quick
visual reminder, providing the sort field is being displayed.
@@ -1090,7 +1090,7 @@ The sort field might\fI not\fR be visibl
2) the 'f' \*(CI turned it \*F
.TP 7
-\ \ \'\fBy\fR\' :\fIRow-Highlight\fR toggle \fR
+\ \ '\fBy\fR' :\fIRow-Highlight\fR toggle \fR
Changes highlighting for "running" tasks.
For additional insight into this task state,
\*(Xt 3a. DESCRIPTIONS of Fields, the 'S' field (Process Status).
@@ -1099,7 +1099,7 @@ Use of this provision provides important
The only costs will be a few additional tty escape sequences.
.TP 7
-\ \ \'\fBz\fR\' :\fIColor/Monochrome\fR toggle \fR
+\ \ '\fBz\fR' :\fIColor/Monochrome\fR toggle \fR
Switches the \*(CW between your last used color scheme and the older form
of black-on-white or white-on-black.
This command will alter\fB both\fR the \*(SA and \*(TA but does not affect
@@ -1110,20 +1110,20 @@ the state of the 'x', 'y' or 'b' toggles
.B CONTENT\fR of \*(TW
.PD 0
.TP 7
-\ \ \'\fBc\fR\' :\fICommand-Line/Program-Name\fR toggle \fR
+\ \ '\fBc\fR' :\fICommand-Line/Program-Name\fR toggle \fR
This command will be honored whether or not the 'COMMAND' column
is currently visible.
Later, should that field come into view, the change you applied will be seen.
.TP 7
-\ \ \'\fBf\fR\' | \'\fBF\fR\' :\fIFields-Management \fR
+\ \ '\fBf\fR' | '\fBF\fR' :\fIFields-Management \fR
These keys display a separate screen where you can change which fields are
displayed, their order and also designate the sort field.
For additional information on these \*(CIs
\*(Xt 3b. MANAGING Fields.
.TP 7
-\ \ \'\fBS\fR\' :\fICumulative-Time-Mode\fR toggle \fR
+\ \ '\fBS\fR' :\fICumulative-Time-Mode\fR toggle \fR
When 'Cumulative mode' is \*O, each process is listed with the \*(Pu
time that it and its dead children have used.
@@ -1139,7 +1139,7 @@ If you wish to know in advance whether o
effect, simply ask for help and view the window summary on the second line.
.TP 7
-\ \ \'\fBu\fR' | '\fBU\fR' :\fIShow-Specific-User-Only \fR
+\ \ '\fBu\fR' | '\fBU\fR' :\fIShow-Specific-User-Only \fR
You will be prompted for the\fB uid\fR or\fB name\fR of the user to display.
The '-u' option matches on \fB effective\fR user whereas the '-U' option
matches on\fB any\fR user (real, effective, saved, or filesystem).
@@ -1152,7 +1152,7 @@ Later, if you wish to monitor all tasks
command but just press <Enter> at the prompt.
.TP 7
-\ \ \'\fBV\fR' :\fIForest-View-Mode\fR toggle \fR
+\ \ '\fBV\fR' :\fIForest-View-Mode\fR toggle \fR
In this mode, processes are reordered according to their parents and
the layout of the COMMAND column resembles that of a tree.
In forest view mode it is still possible to toggle between program
@@ -1168,7 +1168,7 @@ mode in the \*(CW.
.B SIZE\fR of \*(TW
.PD 0
.TP 7
-\ \ \'\fBi\fR\' :\fIIdle-Process\fR toggle \fR
+\ \ '\fBi\fR' :\fIIdle-Process\fR toggle \fR
Displays all tasks or just active tasks.
When this toggle is \*F, tasks that have not used any \*(PU since the
last update will not be displayed.
@@ -1180,7 +1180,7 @@ If this command is applied to the last \
affect the window's size, as all prior \*(TDs will have already been painted.
.TP 7
-\ \ \'\fBn\fR\' | \'\fB#\fR\' :\fISet-Maximum-Tasks \fR
+\ \ '\fBn\fR' | '\fB#\fR' :\fISet-Maximum-Tasks \fR
You will be prompted to enter the number of tasks to display.
The lessor of your number and available screen rows will be used.
@@ -1218,12 +1218,12 @@ The sort field might\fI not\fR be visibl
2) the 'f' \*(CI turned it \*F
.TP 7
-\ \ \'\fB<\fR\' :\fIMove-Sort-Field-Left \fR
+\ \ '\fB<\fR' :\fIMove-Sort-Field-Left \fR
Moves the sort column to the left unless the current sort field is
the first field being displayed.
.TP 7
-\ \ \'\fB>\fR\' :\fIMove-Sort-Field-Right \fR
+\ \ '\fB>\fR' :\fIMove-Sort-Field-Right \fR
Moves the sort column to the right unless the current sort field is
the last field being displayed.
@@ -1234,14 +1234,14 @@ the current sort field is visible.
.in
.TP 7
-\ \ \'\fBf\fR\' | \'\fBF\fR\' :\fIFields-Management \fR
+\ \ '\fBf\fR' | '\fBF\fR' :\fIFields-Management \fR
These keys display a separate screen where you can change which field
is used as the sort column, among other functions.
This can be a convenient way to simply verify the current sort field,
when running \*(We with column highlighting turned \*F.
.TP 7
-\ \ \'\fBR\fR\' :\fIReverse/Normal-Sort-Field\fR toggle \fR
+\ \ '\fBR\fR' :\fIReverse/Normal-Sort-Field\fR toggle \fR
Using this \*(CI you can alternate between high-to-low and low-to-high sorts.
.PP
@@ -1320,7 +1320,7 @@ know what window is the \*(CW.
.SS 5b. COMMANDS for Windows
.\" ----------------------------------------------------------------------
.TP 7
-\ \ \'\fB-\fR\' | \'\fB_\fR\' :\fIShow/Hide-Window(s)\fR toggles \fR
+\ \ '\fB-\fR' | '\fB_\fR' :\fIShow/Hide-Window(s)\fR toggles \fR
The '-' key turns the \*(CW's \*(TD \*O and \*F.
When \*O, that \*(TA will show a minimum of the columns header you've
established with the 'f' \*(CI.
@@ -1334,7 +1334,7 @@ If all 4 \*(TDs are currently visible, t
as the only display element.
.TP 7
-*\ \'\fB=\fR\' | \'\fB+\fR\' :\fIEqualize-(re-balance)-Window(s) \fR
+*\ '\fB=\fR' | '\fB+\fR' :\fIEqualize-(re-balance)-Window(s) \fR
The '=' key forces the \*(CW's \*(TD to be visible.
It also reverses any 'i' (idle tasks), 'n' (max tasks) and 'u'/'U'
(user filter) commands that might be active.
@@ -1349,7 +1349,7 @@ except for the 'i' (idle tasks), 'n' (ma
and scrolling \*(CIs.
.TP 7
-*\ \'\fBA\fR\' :\fIAlternate-Display-Mode\fR toggle \fR
+*\ '\fBA\fR' :\fIAlternate-Display-Mode\fR toggle \fR
This command will switch between \*(FM and \*(AM.
The first time you issue this command, all four \*(TDs will be shown.
@@ -1357,7 +1357,7 @@ Thereafter when you switch modes, you wi
chosen to make visible.
.TP 7
-*\ \'\fBa\fR\' | \'\fBw\fR\' :\fINext-Window-Forward/Backward \fR
+*\ '\fBa\fR' | '\fBw\fR' :\fINext-Window-Forward/Backward \fR
This will change the \*(CW, which in turn changes the window to which
commands are directed.
These keys act in a circular fashion so you can reach any desired \*(CW
@@ -1368,7 +1368,7 @@ whenever the \*(CW name loses its emphas
the \*(TD is \*F and many commands will be restricted.
.TP 7
-*\ \'\fBg\fR\' :\fIChoose-Another-Window/Field-Group \fR
+*\ '\fBg\fR' :\fIChoose-Another-Window/Field-Group \fR
You will be prompted to enter a number between 1 and 4 designating the
\*(FG which should be made the \*(CW.
@@ -1377,7 +1377,7 @@ In \*(AM, it is simply a less convenient
commands.
.TP 7
-\ \ \'\fBG\fR\' :\fIChange-Window/Field-Group-Name \fR
+\ \ '\fBG\fR' :\fIChange-Window/Field-Group-Name \fR
You will be prompted for a new name to be applied to the \*(CW.
It does not require that the window name be visible
(the 'l' toggle to be \*O).
@@ -1385,8 +1385,8 @@ It does not require that the window name
.IP "*" 3
The \*(CIs shown with an \*(AK have use beyond \*(AM.
.Bd -literal -compact
- \'=', 'A', 'g' are always available
- \'a', 'w' act the same with color mapping
+ '=', 'A', 'g' are always available
+ 'a', 'w' act the same with color mapping
\ and fields management
.Ed
@@ -1485,7 +1485,7 @@ available in \*(AM if the \*(CW's \*(TD
You can use these \*(CIs to locate a task row containing a particular value.
.TP 4
-'\fBL\fR\' :\fILocate-a-string\fR
+'\fBL\fR' :\fILocate-a-string\fR
You will be prompted for the case-sensitive string to locate starting from
the current window coordinates.
There are no restrictions on search string content.
@@ -1498,7 +1498,7 @@ Keying <Enter> with no input will effect
a new search string is entered.
.TP 4
-'\fB&\fR\' :\fILocate-next\fR
+'\fB&\fR' :\fILocate-next\fR
Assuming a search string has been established, \*(We will attempt to locate
the next occurrence.
Reference in New Issue View Git Blame Copy Permalink