Update the description of the 'flags' keyword, including the known values,

aligning the table for easier reading.

ok ariane@, millert@, deraadt@

1 files changed, 33 insertions, 24 deletions

diff --git a/bin/ps/ps.1 b/bin/ps/ps.1
index a64c176bdf8..3603a1a8f27 100644
--- a/bin/ps/ps.1
+++ b/bin/ps/ps.1
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: ps.1,v 1.71 2010/09/03 09:53:20 jmc Exp $
+.\"	$OpenBSD: ps.1,v 1.72 2011/04/03 18:14:01 guenther Exp $
 .\"	$NetBSD: ps.1,v 1.16 1996/03/21 01:36:28 jtc Exp $
 .\"
 .\" Copyright (c) 1980, 1990, 1991, 1993, 1994
@@ -30,7 +30,7 @@
 .\"
 .\"     @(#)ps.1	8.3 (Berkeley) 4/18/94
 .\"
-.Dd $Mdocdate: September 3 2010 $
+.Dd $Mdocdate: April 3 2011 $
 .Dt PS 1
 .Os
 .Sh NAME
@@ -214,35 +214,44 @@ Name of system call emulation environment.
 .It Cm flags
 Alias:
 .Cm f .
-The flags (in hexadecimal) associated with the process as in
-the include file
+The union of the flags (in hexadecimal) associated with the process
+and the thread as in the include file
 .Aq Pa sys/proc.h :
 .Bd -literal
-P_CONTROLT 0x0000002  process has a controlling terminal
-P_NOCLDSTOP 0x0000008 no SIGCHLD when children stop
-P_PPWAIT 0x0000010    parent is waiting for child to
+PS_CONTROLT       0x2 process has a controlling terminal
+P_NOCLDSTOP       0x8 no SIGCHLD when children stop
+PS_PPWAIT        0x10 parent is waiting for child to
 		      exec/exit
-P_PROFIL 0x0000020    process has started profiling
-P_SELECT 0x0000040    selecting; wakeup/waiting danger
-P_SINTR 0x0000080     sleep is interruptible
-P_SUGID 0x0000100     process had set ID privileges since
+P_PROFIL         0x20 process has started profiling
+P_SELECT         0x40 selecting; wakeup/waiting danger
+P_SINTR          0x80 sleep is interruptible
+PS_SUGID        0x100 process had set ID privileges since
 		      last exec
-P_SYSTEM 0x0000200    system process: no sigs, stats, or
+P_SYSTEM        0x200 system process: no sigs, stats, or
 		      swapping
-P_TIMEOUT 0x0000400   timing out during sleep
-P_TRACED 0x0000800    process is being traced
-P_WAITED 0x0001000   debugging process has waited for child
-P_WEXIT 0x0002000     working on exiting
-P_EXEC 0x0004000      process called exec(3)
-P_OWEUPC 0x0008000    owe process an addupc() call at next
+P_TIMEOUT       0x400 timing out during sleep
+P_TRACED        0x800 process is being traced
+P_WAITED       0x1000 debugging process has waited for
+		      child
+P_WEXIT        0x2000 working on exiting
+P_EXEC         0x4000 process called exec(3)
+P_OWEUPC       0x8000 owe process an addupc() call at next
 		      ast
 .\" the routine addupc is not documented in the man pages
-P_SSTEP 0x0020000     process needs single-step fixup
-P_SUGIDEXEC 0x0040000 last exec(3) was set[ug]id
-P_NOCLDWAIT 0x0080000 let pid 1 wait for my children
-P_NOZOMBIE 0x0100000  pid 1 waits for me instead of dad
-P_INEXEC 0x0200000    process is doing an exec right now
-P_SYSTRACE 0x0400000  process system call tracing is active
+PS_ISPWAIT    0x10000 is parent of PPWAIT child
+P_SSTEP       0x20000 process needs single-step fixup
+PS_SUGIDEXEC  0x40000 last exec(3) was set[ug]id
+P_NOCLDWAIT   0x80000 let pid 1 wait for my children
+P_NOZOMBIE   0x100000 pid 1 waits for me instead of dad
+P_INEXEC     0x200000 process is doing an exec right now
+P_SYSTRACE   0x400000 process system call tracing is active
+P_BIGLOCK   0x2000000 process needs kernel "big lock" to
+		      run
+P_THREAD    0x4000000 only a thread, not a real process
+P_IGNEXITRV 0x8000000 for thread kills
+P_SOFTDEP  0x10000000 stuck processing softdep worklist
+P_STOPPED  0x20000000 just stopped
+P_CPUPEG   0x40000000 do not move to another cpu
 .Ed
 .It Cm gid
 Effective group.