1htop(1)                              Utils                             htop(1)
2
3
4

NAME

6       htop - interactive process viewer
7

SYNTAX

9       htop
10

DESCRIPTION

12       This program is a free (GPL) ncurses-based process viewer.
13
14       It is similar to top, but allows to scroll the list vertically and hor‐
15       izontally to see all processes and their full command lines.
16
17       Tasks related to processes (killing,  renicing)  can  be  done  without
18       entering their PIDs.
19

COMMAND-LINE OPTIONS

21       The following flags are supported:
22
23       -d DELAY
24              Delay between updates, in tenths of seconds
25
26       -u USERNAME
27              Show only processes of a given user
28
29       --sort-key COLUMN
30              Sort by this column (use --sort-key help for a column list)
31

INTERACTIVE COMMANDS

33       The following commands are supported:
34
35       Arrows, PgUP, PgDn, Home, End
36            Scroll process list.
37
38       Space
39            "Tag":  mark a process. Commands that can operate on multiple pro‐
40            cesses, like "kill", will then apply over the list of tagged  pro‐
41            cesses, instead of the currently highlighted one.
42
43       U    "Untag" all processes (remove all tags added with the Space key).
44
45       s    Trace  process  system  calls: if strace(1) is installed, pressing
46            this key will attach it to the currently  selected  process,  pre‐
47            senting a live update of system calls issued by the process.
48
49       l    Display  open files for a process: if lsof(1) is installed, press‐
50            ing this key will display the list of file descriptors  opened  by
51            the process.
52
53       F1, h
54            Help screen
55
56       F2, S
57            Setup  screen. There you can configure meters displayed on the top
58            side of the screen, as well as set various display options, choose
59            among  color  schemes  and select the layout of the displayed col‐
60            umns.
61
62       F3, /
63            Incremental process search: type in part of a process command line
64            and  the  selection highlight will be moved to it. While in search
65            mode, pressing this key will cycle through matching occurrences.
66
67       F4, I
68            Invert sort order: if sort order is increasing, switch to decreas‐
69            ing, and vice-versa.
70
71       F5, t
72            Tree  view: organize processes by parenthood, and layout the rela‐
73            tions between them as a tree. Toggling the key will switch between
74            tree and your previously selected sort view. Selecting a sort view
75            will exit tree view.
76
77       F6, >
78            Select field for sorting. The sort field is indicated by  a  high‐
79            light in the header.
80
81       F7, ], -
82            Increase  selected  process priority (subtract from 'nice' value).
83            This can be done by the superuser only.
84
85       F8, [, +
86            Decrease selected process priority (add to 'nice' value)
87
88       F9, k
89            "Kill" process: sends a signal which is selected in a menu, to one
90            or  a group of processes. If processes were tagged, sends the sig‐
91            nal to all tagged processes.  If none is tagged, sends to the cur‐
92            rently selected process.
93
94       F10, q
95            Quit
96
97       a (on multiprocessor machines)
98            Set CPU affinity: mark which CPUs a process is allowed to use.
99
100       u    Show only processes owned by a specified user.
101
102       M    Sort by memory usage (top compatibility key).
103
104       P    Sort by processor usage (top compatibility key).
105
106       T    Sort by time (top compatibility key).
107
108       F    "Follow"  process: if the sort order causes the currently selected
109            process to move in the list, make the  selection  bar  follow  it.
110            This  is useful for monitoring a process: this way, you can keep a
111            process always visible on screen. When a  movement  key  is  used,
112            "follow" loses effect.
113
114       K    Hide  kernel  threads: prevent the threads belonging the kernel to
115            be displayed in the process list. (This is a toggle key.)
116
117       H    Hide user threads: on systems that represent them differently than
118            ordinary  processes  (such as recent NPTL-based systems), this can
119            hide threads from userspace processes in the process  list.  (This
120            is a toggle key.)
121
122       Ctrl-L
123            Refresh: redraw screen and recalculate values.
124
125       Numbers
126            PID search: type in process ID and the selection highlight will be
127            moved to it.
128
129

AUTHORS

131       htop  is  developed  by   Hisham   Muhammad   <loderunner@users.source‐
132       forge.net>.
133       This  man  page  was  written  by  Bartosz Fenski <fenio@o2.pl> for the
134       Debian GNU/Linux distribution (but it  may  be  used  by  others),  and
135       updated by Hisham Muhammad.
136
137
138
139Bartosz Fenski <fenio@o2.pl>         0.8.3                             htop(1)
Impressum