docs/115065: [patch] sync ps.1 with p_flag and keywords

[pluknet]

>Number:         115065
>Category:       docs
>Synopsis:       [patch] sync ps.1 with p_flag and keywords
>Confidential:   no
>Severity:       non-critical
>Priority:       medium
>Responsible:    freebsd-doc
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Mon Jul 30 23:40:00 GMT 2007
>Closed-Date:
>Last-Modified:
>Originator:     pluknet
>Release:        
>Organization:
n/a
>Environment:
7.0-CURRENT from Sat Jul 21 2007
>Description:
ps.1 manpage wasn't synced up to date in the past several years with:
o flags (kept in p_flag in struct proc) changes in sys/proc.h
o keywords changes in bin/ps/keyword.c (partly from bin/65803)
>How-To-Repeat:
See mentioned manpage.
>Fix:
Apply the patch.

Patch attached with submission follows:

--- bin/ps/ps.1.orig	2007-07-31 01:43:45.000000000 +0400
+++ bin/ps/ps.1	2007-07-31 03:21:30.000000000 +0400
@@ -27,7 +27,7 @@
 .\" SUCH DAMAGE.
 .\"
 .\"     @(#)ps.1	8.3 (Berkeley) 4/18/94
-.\" $FreeBSD: src/bin/ps/ps.1,v 1.89 2006/09/17 17:40:06 ru Exp $
+.\" $FreeBSD$
 .\"
 .Dd August 21, 2006
 .Dt PS 1
@@ -271,7 +271,7 @@
 fields to exceed 100%.
 .It Cm %mem
 The percentage of real memory used by this process.
-.It Cm flags
+.It Cm f
 The flags associated with the process as in
 the include file
 .In sys/proc.h :
@@ -283,6 +283,7 @@
 .It Dv "P_PPWAIT" Ta No "0x00010	Parent is waiting for child to exec/exit"
 .It Dv "P_PROFIL" Ta No "0x00020	Has started profiling"
 .It Dv "P_STOPPROF" Ta No "0x00040	Has thread in requesting to stop prof"
+.It Dv "P_HADTHREADS" Ta No "0x00080	Has had threads (no cleanup shortcuts)"
 .It Dv "P_SUGID" Ta No "0x00100		Had set id privileges since last exec"
 .It Dv "P_SYSTEM" Ta No "0x00200	System proc: no sigs, stats or swapping"
 .It Dv "P_SINGLE_EXIT" Ta No "0x00400	Threads suspending should exit, not wait"
@@ -297,8 +298,11 @@
 .It Dv "P_STOPPED_SINGLE" Ta No "0x80000	Only one thread can continue"
 .It Dv "P_PROTECTED" Ta No "0x100000	Do not kill on memory overcommit"
 .It Dv "P_SIGEVENT" Ta No "0x200000	Process pending signals changed"
+.It Dv "P_SINGLE_BOUNDARY" Ta No "0x400000	Threads should suspend at user boundary"
+.It Dv "P_HWPMC" Ta No "0x800000	Process is using HWPMCs"
 .It Dv "P_JAILED" Ta No "0x1000000	Process is in jail"
 .It Dv "P_INEXEC" Ta No "0x4000000	Process is in execve()"
+.It Dv "P_STATCHILD" Ta No "0x8000000	Child process stopped or exited"
 .El
 .It Cm label
 The MAC label of the process.
@@ -315,7 +319,7 @@
 If the name is invalid or unknown, then
 .Dq ???\&
 is displayed.
-.It Cm logname
+.It Cm login
 The login name associated with the session the process is in (see
 .Xr getlogin 2 ) .
 .It Cm mwchan
@@ -465,11 +469,13 @@
 command and arguments
 .It Cm cpu
 short-term CPU usage factor (for scheduling)
+.It Cm emul
+system-call emulation environment
 .It Cm etime
 elapsed running time
-.It Cm flags
+.It Cm f
 the process flags, in hexadecimal (alias
-.Cm f )
+.Cm flags )
 .It Cm inblk
 total blocks read (alias
 .Cm inblock )
@@ -485,10 +491,13 @@
 memoryuse limit
 .It Cm lockname
 lock currently blocked on (as a symbolic name)
-.It Cm logname
-login name of user who started the session
+.It Cm login
+login name of user who started the session (alias
+.Cm logname )
 .It Cm lstart
 time started
+.It Cm lwp
+process thread-id
 .It Cm majflt
 total page faults
 .It Cm minflt
@@ -504,6 +513,8 @@
 .Cm ni )
 .It Cm nivcsw
 total involuntary context switches
+.It Cm nlwp
+number of threads tied to a process
 .It Cm nsigs
 total signals taken (alias
 .Cm nsignals )
@@ -524,8 +535,6 @@
 process group number
 .It Cm pid
 process ID
-.It Cm poip
-pageouts in progress
 .It Cm ppid
 parent process ID
 .It Cm pri
@@ -536,8 +545,6 @@
 real group ID
 .It Cm rgroup
 group name (from rgid)
-.It Cm rlink
-reverse link on run queue, or 0
 .It Cm rss
 resident set size
 .It Cm rtprio
@@ -588,8 +595,6 @@
 control terminal name (two letter abbreviation)
 .It Cm tty
 full name of control terminal
-.It Cm uprocp
-process pointer
 .It Cm ucomm
 name to be used for accounting
 .It Cm uid
@@ -597,6 +602,8 @@
 .It Cm upr
 scheduling priority on return from system call (alias
 .Cm usrpri )
+.It Cm uprocp
+process pointer
 .It Cm user
 user name (from UID)
 .It Cm vsz


>Release-Note:
>Audit-Trail:
>Unformatted: