Skip to contentSkip to conversation

proc.5: PID/stat: add I, fix P state doc

PATCH In review Kir Kolyshkin 2 participants 2 messages Aug 4, 2021 Man-pages: manual pages for Linux -- Sections 2, 3, 4, 5, and 7

lore
Share & tools
lore
#0 lore raw

PATCH 1/1 proc.5: PID/stat: add I, fix P state doc

1. The I state was not documented -- add it.

2. The P state was documented to be absent since Linux 3.13. It appears it has been reintroduced in Linux 4.14. Document it, and move the description up (so that currently present states will be above the ones that got removed).

3. Consolidate the two descriptions of W state.

This way, the set of states documented matches those that are present as of Linux v5.14-rc4 ("RSDTtXZPI").

---
 man5/proc.5 | 19 +++++++++++--------
 1 file changed, 11 insertions(+), 8 deletions(-)
man5/proc.5 +11 -8
index 69f6e15dd..d6027c469 100644
@@ -2099,10 +2099,18 @@ Stopped (on a signal) or (before Linux 2.6.33) trace stopped
 .IP t
 .\" commit 44d90df6b757c59651ddd55f1a84f28132b50d29
 Tracing stop (Linux 2.6.33 onward)
-.IP W
-Paging (only before Linux 2.6.0)
 .IP X
 Dead (from Linux 2.6.0 onward)
+.IP I
+.\" commit 06eb61844d841d0032a9950ce7f8e783ee49c0d0
+Idle kernel thread (Linux 4.14 onward)
+.IP P
+.\" commit f2530dc71cf0822f90bb63ea4600caaef33a66bb
+Parked (Linux 3.9 to
+.\" commit 74e37200de8e9c4e09b70c21c3f13c2071e77457
+3.13,
+.\" commit 8ef9925b02c23e3838d5e593c5cf37984141150f
+from 4.14 onwards)
 .IP x
 .\" commit 44d90df6b757c59651ddd55f1a84f28132b50d29
 Dead (Linux 2.6.33 to
@@ -2117,12 +2125,7 @@ Wakekill (Linux 2.6.33 to
 .\" commit 44d90df6b757c59651ddd55f1a84f28132b50d29
 Waking (Linux 2.6.33 to
 .\" commit 74e37200de8e9c4e09b70c21c3f13c2071e77457
-3.13 only)
-.IP P
-.\" commit f2530dc71cf0822f90bb63ea4600caaef33a66bb
-Parked (Linux 3.9 to
-.\" commit 74e37200de8e9c4e09b70c21c3f13c2071e77457
-3.13 only)
+3.13 only) or (before Linux 2.6.0) paging
 .RE
 .TP
 (4) \fIppid\fP \ %d
Signature · 1 line
2.32.0
#1 lore raw

Hi Kir,

Quoted 7 lines · Kir Kolyshkin

1. The I state was not documented -- add it.

2. The P state was documented to be absent since Linux 3.13. It appears it has been reintroduced in Linux 4.14. Document it, and move the description up (so that currently present states will be above the ones that got removed).

Quoted 6 lines

3. Consolidate the two descriptions of W state.

This way, the set of states documented matches those that are present as of Linux v5.14-rc4 ("RSDTtXZPI").

Thanks for the patch! Please see a few minor comments below.

Thanks,

Alex

Quoted 16 lines
---
  man5/proc.5 | 19 +++++++++++--------
  1 file changed, 11 insertions(+), 8 deletions(-)
man5/proc.5 +0 -2
index 69f6e15dd..d6027c469 100644
@@ -2099,10 +2099,18 @@ Stopped (on a signal) or (before Linux 2.6.33) trace stopped
  .IP t
  .\" commit 44d90df6b757c59651ddd55f1a84f28132b50d29
  Tracing stop (Linux 2.6.33 onward)
-.IP W
-Paging (only before Linux 2.6.0)
  .IP X
  Dead (from Linux 2.6.0 onward)

man5/proc.5 Stopped (on a signal) or (before Linux 2.6.33) trace stopped · line 2113

Quoted 10 lines
man5/proc.5 +10 -0
+.IP I
+.\" commit 06eb61844d841d0032a9950ce7f8e783ee49c0d0
+Idle kernel thread (Linux 4.14 onward)
+.IP P
+.\" commit f2530dc71cf0822f90bb63ea4600caaef33a66bb
+Parked (Linux 3.9 to
+.\" commit 74e37200de8e9c4e09b70c21c3f13c2071e77457
+3.13,
+.\" commit 8ef9925b02c23e3838d5e593c5cf37984141150f
+from 4.14 onwards)

s/onwards/onward/

I'd add an "and" before "from", or change s/,/;/

Quoted 18 lines
man5/proc.5 +1 -6
  .IP x
  .\" commit 44d90df6b757c59651ddd55f1a84f28132b50d29
  Dead (Linux 2.6.33 to
@@ -2117,12 +2125,7 @@ Wakekill (Linux 2.6.33 to
  .\" commit 44d90df6b757c59651ddd55f1a84f28132b50d29
  Waking (Linux 2.6.33 to
  .\" commit 74e37200de8e9c4e09b70c21c3f13c2071e77457
-3.13 only)
-.IP P
-.\" commit f2530dc71cf0822f90bb63ea4600caaef33a66bb
-Parked (Linux 3.9 to
-.\" commit 74e37200de8e9c4e09b70c21c3f13c2071e77457
-3.13 only)
+3.13 only) or (before Linux 2.6.0) paging
  .RE
  .TP
  (4) \fIppid\fP \ %d
Signature · 3 lines
Alejandro Colomar
Linux man-pages comaintainer; https://www.kernel.org/doc/man-pages/
http://www.alejandro-colomar.es/