From e7372d18a1a661d8c3dba9f51e1f17b5f94171a7 Mon Sep 17 00:00:00 2001
From: Daniel Lange <DLange@git.local>
Date: Wed, 10 Jan 2024 11:17:08 +0100
Subject: New upstream version 3.3.0

---
 htop.1.in | 31 +++++++++++++++++++++++++------
 1 file changed, 25 insertions(+), 6 deletions(-)

(limited to 'htop.1.in')

diff --git a/htop.1.in b/htop.1.in
index c81c819..2376b7a 100644
--- a/htop.1.in
+++ b/htop.1.in
@@ -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
-- 
cgit v1.2.3