diff options
author | Daniel Lange <DLange@git.local> | 2024-01-10 11:17:08 +0100 |
---|---|---|
committer | Daniel Lange <DLange@git.local> | 2024-01-10 11:17:08 +0100 |
commit | e7372d18a1a661d8c3dba9f51e1f17b5f94171a7 (patch) | |
tree | e8270dd60ec096bee8157dbadf029e15ed584592 /htop.1.in | |
parent | 937052b231259a47d881d539ad5748245ef55b99 (diff) | |
download | debian_htop-e7372d18a1a661d8c3dba9f51e1f17b5f94171a7.tar.gz debian_htop-e7372d18a1a661d8c3dba9f51e1f17b5f94171a7.tar.bz2 debian_htop-e7372d18a1a661d8c3dba9f51e1f17b5f94171a7.zip |
New upstream version 3.3.0
Diffstat (limited to 'htop.1.in')
-rw-r--r-- | htop.1.in | 31 |
1 files changed, 25 insertions, 6 deletions
@@ -1,4 +1,4 @@ -.TH "HTOP" "1" "2022" "@PACKAGE_STRING@" "User Commands" +.TH "HTOP" "1" "2024" "@PACKAGE_STRING@" "User Commands" .SH "NAME" htop, pcp-htop \- interactive process viewer .SH "SYNOPSIS" @@ -258,6 +258,10 @@ 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 O +Hide containerized processes: prevent processes running in a container +from being displayed in the process list. (This is a toggle key.) +.TP .B p Show full paths to running programs, where applicable. (This is a toggle key.) .TP @@ -327,7 +331,8 @@ The process ID. .TP .B STATE (S) The state of the process: - \fBS\fR for sleeping (idle) + \fBS\fR for sleeping + \fBI\fR for idle (longer inactivity than sleeping on platforms that distinguish) \fBR\fR for running \fBD\fR for disk sleep (uninterruptible) \fBZ\fR for zombie (waiting for parent to read its exit status) @@ -448,6 +453,11 @@ resident memory size, see M_RESIDENT above). .B USER The username of the process owner, or the user ID if the name can't be determined. + +On Linux the username is highlighted if the process has elevated privileges, +i.e. if it has been started from binaries with file capabilities set or +retained Linux capabilities, via the ambient set, after switching from the +root user. .TP .B TIME (TIME+) The time, measured in clock ticks that the process has spent in user and system @@ -592,7 +602,7 @@ By default .B htop reads its configuration from the XDG-compliant path .IR ~/.config/htop/htoprc . -The configuration file is overwritten by +The configuration file is overwritten upon clean exit by .BR htop 's in-program Setup configuration, so it should not be hand-edited. If no user configuration exists @@ -634,15 +644,24 @@ can also be displayed by if the .BR pmdaopenmetrics (1) component is configured. +.LP +The configuration for both +.B htop +and +.B pcp-htop +is only saved when a clean exit is performed. Sending any signal will cause +.I all configuration changes to be lost. .SH "MEMORY SIZES" Memory sizes in .B htop are displayed in a human-readable form. -Sizes are printed in powers of 1024. (e.g., 1023M = 1072693248 Bytes) +Sizes are printed in powers of 1024 using binary IEC units. +If no suffix is shown the units are implicitly K as in KiB (kibibyte, 1 KiB = 1024 bytes). .LP The decision to use this convention was made in order to conserve screen space and make memory size representations consistent throughout -.BR htop . +.B htop +as allocations are granular to full memory pages (4 KiB for most platforms). .SH "SEE ALSO" .BR proc (5), .BR top (1), @@ -668,7 +687,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-2022 htop dev team. +Copyright \(co 2020-2024 htop dev team. .LP License GPLv2+: GNU General Public License version 2 or, at your option, any later version. .LP |