diff options
Diffstat (limited to 'htop.1.in')
| -rw-r--r-- | htop.1.in | 28 |
1 files changed, 23 insertions, 5 deletions
@@ -1,4 +1,4 @@ -.TH "HTOP" "1" "2023" "@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 @@ -449,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 @@ -593,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 @@ -635,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), @@ -669,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-2023 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 |