aboutsummaryrefslogtreecommitdiffstats
path: root/htop.1.in
diff options
context:
space:
mode:
Diffstat (limited to 'htop.1.in')
-rw-r--r--htop.1.in25
1 files changed, 15 insertions, 10 deletions
diff --git a/htop.1.in b/htop.1.in
index 49c4a52..c81c819 100644
--- a/htop.1.in
+++ b/htop.1.in
@@ -1,4 +1,4 @@
-.TH "HTOP" "1" "2021" "@PACKAGE_STRING@" "User Commands"
+.TH "HTOP" "1" "2022" "@PACKAGE_STRING@" "User Commands"
.SH "NAME"
htop, pcp-htop \- interactive process viewer
.SH "SYNOPSIS"
@@ -50,7 +50,8 @@ Start
in monochrome mode
.TP
\fB\-F \-\-filter=FILTER
-Filter processes by command
+Filter processes by terms matching the commands. The terms are matched
+case-insensitive and as fixed strings (not regexs). You can separate multiple terms with "|".
.TP
\fB\-h \-\-help
Display a help message and exit
@@ -95,6 +96,10 @@ held.
The following commands are supported while in
.BR htop :
.TP 5
+.B Tab, Shift-Tab
+Select the next / the previous screen tab to display.
+You can enable showing the screen tab names in the Setup screen (F2).
+.TP
.B Up, Alt-k
Select (highlight) the previous process in the process list. Scroll the list
if necessary.
@@ -175,6 +180,8 @@ bindings take precedence.
Incremental process filtering: type in part of a process command line and
only processes whose names match will be shown. To cancel filtering,
enter the Filter option again and press Esc.
+The matching is done case-insensitive. Terms are fixed strings (no regex).
+You can separate multiple terms with "|".
.TP
.B F5, t
Tree view: organize processes by parenthood, and layout the relations
@@ -289,6 +296,8 @@ highlighting can be configured for stale executables (cf. EXE column below).
.TP
.B COMM
The command name of the process obtained from /proc/[pid]/comm, if readable.
+
+Requires Linux kernel 2.6.33 or newer.
.TP
.B EXE
The abbreviated basename of the executable of the process, obtained from
@@ -310,6 +319,8 @@ been replaced or deleted.
This additional color markup can be configured in the "Display Options" section of
the setup screen.
+
+Displaying EXE requires CAP_SYS_PTRACE and PTRACE_MODE_READ_FSCRED.
.TP
.B PID
The process ID.
@@ -496,7 +507,7 @@ This performs some pattern-based replacements to shorten the displayed string an
\fB/*.slice\fR is shortened to \fB/[*]\fR (exceptions below)
\fB/system.slice\fR is shortened to \fB/[S]\fR
\fB/user.slice\fR is shortened to \fB/[U]\fR
- \fB/user-*.slice\fR is shortened to \fB/[U:*]\fR (directly preceeding \fB/[U]\fR before dropped)
+ \fB/user-*.slice\fR is shortened to \fB/[U:*]\fR (directly preceding \fB/[U]\fR before dropped)
\fB/machine.slice\fR is shortened to \fB/[M]\fR
\fB/machine-*.scope\fR is shortened to \fB/[SNC:*]\fR (SNC: systemd nspawn container), uppercase for the monitor
\fB/lxc.monitor.*\fR is shortened to \fB/[LXC:*]\fR
@@ -527,12 +538,6 @@ The percentage of time spent waiting for the completion of synchronous block I/O
.B PERCENT_SWAP_DELAY (SWAPD%)
The percentage of time spent swapping in pages. Requires CAP_NET_ADMIN.
.TP
-.B COMM
-The command name for the process. Requires Linux kernel 2.6.33 or newer.
-.TP
-.B EXE
-The executable file of the process as reported by the kernel. Requires CAP_SYS_PTRACE and PTRACE_MODE_READ_FSCRED.
-.TP
.B AGRP
The autogroup identifier for the process. Requires Linux CFS to be enabled.
.TP
@@ -663,7 +668,7 @@ communities, and forms part of the Performance Co-Pilot suite of tools.
.SH "COPYRIGHT"
Copyright \(co 2004-2019 Hisham Muhammad.
.br
-Copyright \(co 2020-2021 htop dev team.
+Copyright \(co 2020-2022 htop dev team.
.LP
License GPLv2+: GNU General Public License version 2 or, at your option, any later version.
.LP

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