docs: Document I idle state in ps and top

Linux 4.2 provided a new process state of I which is used for an idle
kernel thread. This new state means that kernel threads do not
contribute to the loadavg as they are no longer state D or S but I.

While both ps and top displayed this state, it wasn't documented in
either manual page until now.

References:
 https://bugs.debian.org/886967
 https://www.quora.com/What-does-mean-Linux-process-state-I-in-the-top-output
 https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git/commit/?id=80ed87c8a9ca0cad7ca66cf3bbdfb17559a66dcf

diff --git a/NEWS b/NEWS
index 7ffe74a9cc8db7d3875c55df0dc4c293d262a462..89a52b1000ea32cfba2745345bd62c260cfba6fb 100644 (file)
--- a/NEWS
+++ b/NEWS
@@ -1,5 +1,6 @@
 procps-ng-NEXT
 ----------------
+  * doc: Document I idle state in ps.1 and top.1           Debian #886967
   * kill: -l space between name parses correctly           Debian #854407
   * library: dont use vm_min_free on non Linux             Debian #831396
   * library: dont use SIGPWR on FreeBSD                    Debian #832148

diff --git a/ps/ps.1 b/ps/ps.1
index 89463b289129f547a0cddb68c6869e74abefd8da..c16d00db4c5d76ded3858673101e685065d7d9eb 100644 (file)
--- a/ps/ps.1
+++ b/ps/ps.1
@@ -4,7 +4,7 @@
 .\" Quick hack conversion by Albert Cahalan, 1998.
 .\" Licensed under version 2 of the Gnu General Public License.
 .\"
-.TH PS 1 "May 2017" "procps-ng" "User Commands"
+.TH PS 1 2018-01-13 "procps-ng" "User Commands"
 .\"
 .\" To render this page:
 .\"    groff -t -b -man -X -P-resolution -P100 -Tps ps.1 &
@@ -832,6 +832,9 @@ of a process:
 D
 uninterruptible sleep (usually IO)
 .TP
+I
+Idle kernel thread
+.TP
 R
 running or runnable (on run queue)
 .TP

diff --git a/top/top.1 b/top/top.1
index 4abe16e2cbb7b0db6bb93bb272b79f2306eda55d..f621ce02dba5e4ed23e5654abe1b8de90997c03d 100644 (file)
--- a/top/top.1
+++ b/top/top.1
@@ -837,6 +837,7 @@ The\fI real\fR user name.
 29.\fB S \*(Em Process Status \fR
 The status of the task which can be one of:
     \fBD\fR = uninterruptible sleep
+    \fBI\fR = idle
     \fBR\fR = running
     \fBS\fR = sleeping
     \fBT\fR = stopped by job control signal