summaryrefslogtreecommitdiffstats
path: root/htop.1
diff options
context:
space:
mode:
authorHisham Muhammad <hisham@gobolinux.org>2006-03-04 18:16:49 +0000
committerHisham Muhammad <hisham@gobolinux.org>2006-03-04 18:16:49 +0000
commitd6231bab89d634da5564491196b7c478db038505 (patch)
treebfc0bf00b138763eb41132fd27a8f389a78bf3a4 /htop.1
Initial import.
Diffstat (limited to 'htop.1')
-rw-r--r--htop.1120
1 files changed, 120 insertions, 0 deletions
diff --git a/htop.1 b/htop.1
new file mode 100644
index 00000000..ddca7bb5
--- /dev/null
+++ b/htop.1
@@ -0,0 +1,120 @@
+.TH "htop" "1" "0.6" "Bartosz Fenski <fenio@o2.pl>" "Utils"
+.SH "NAME"
+htop \- interactive process viewer
+.SH "SYNTAX"
+.LP
+.B htop
+.SH "DESCRIPTION"
+.LP
+This program is a free (GPL) ncurses-based process viewer.
+.LP
+It is similar to top, but allows to scroll the list vertically and
+horizontally to see all processes and their full command lines.
+.LP
+Tasks related to processes (killing, renicing) can be done without
+entering their PIDs.
+.br
+.SH "INTERACTIVE COMMANDS"
+.LP
+The following commands are supported:
+.LP
+.TP 5
+.B Arrows, PgUP, PgDn, Home, End
+Scroll process list.
+.TP
+.B Space
+"Tag": mark a process. Commands that can operate on multiple processes,
+like "kill", will then apply over the list of tagged processes, instead
+of the currently highlighted one.
+.TP
+.B U
+"Untag" all processes (remove all tags added with the Space key).
+.TP
+.B s
+Trace process system calls: if strace(1) is installed, pressing this key
+will attach it to the currently selected process, presenting a live
+update of system calls issued by the process.
+.TP
+.B F1, h
+Help screen
+.TP
+.B F2, S
+Setup screen. There you can configure meters displayed on the top side
+of the screen, as well as set various display options, choose among
+color schemes and select the layout of the displayed columns.
+.TP
+.B F3, /
+Incremental process search: type in part of a process command line and
+the selection highlight will be moved to it. While in search mode,
+pressing this key will cycle through matching occurrences.
+.TP
+.B F4, I
+Invert sort order: if sort order is increasing, switch to decreasing,
+and vice-versa.
+.TP
+.B F5, t
+Tree view: organize processes by parenthood, and layout the relations
+between them as a tree. Toggling the key will switch between tree and
+your previously selected sort view. Selecting a sort view will exit
+tree view.
+.TP
+.B F6, >
+Select field for sorting. The sort field is indicated by a
+highlight in the header.
+.TP
+.B F7, ], -
+Increase selected process priority (subtract from 'nice' value).
+This can be done by the superuser only.
+.TP
+.B F8, [, +
+Decrease selected process priority (add to 'nice' value)
+.TP
+.B F9, k
+"Kill" process: sends a signal which is selected in a menu, to one or a group
+of processes. If processes were tagged, sends the signal to all tagged processes.
+If none is tagged, sends to the currently selected process.
+.TP
+.B F10, q
+Quit
+.TP
+.B u
+Show only processes owned by a specified user.
+.TP
+.B M
+Sort by memory usage (top compatibility key).
+.TP
+.B P
+Sort by processor usage (top compatibility key).
+.TP
+.B T
+Sort by time (top compatibility key).
+.TP
+.B F
+"Follow" process: if the sort order causes the currently selected process
+to move in the list, make the selection bar follow it. This is useful for
+monitoring a process: this way, you can keep a process always visible on
+screen. When a movement key is used, "follow" loses effect.
+.TP
+.B K
+Hide kernel threads: prevent the threads belonging the kernel to be
+displayed in the process list. (This is a toggle key.)
+.TP
+.B H
+Hide user threads: on systems that represent them differently than ordinary
+processes (such as recent NPTL-based systems), this can hide threads from
+userspace processes in the process list. (This is a toggle key.)
+.TP
+.B Ctrl-L
+Refresh: redraw screen and recalculate values.
+.TP
+.B Numbers
+PID search: type in process ID and the selection highlight will be moved to it.
+.PD
+
+.SH "AUTHORS"
+.LP
+htop is developed by Hisham Muhammad <lode@gobolinux.org>.
+.br
+This man page was written by Bartosz Fenski <fenio@o2.pl> for the
+Debian GNU/Linux distribution (but it may be used by others), and
+updated by Hisham Muhammad.

© 2014-2024 Faster IT GmbH | imprint | privacy policy