From nobody@FreeBSD.org  Mon Jul 30 23:36:28 2007
Return-Path: <nobody@FreeBSD.org>
Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34])
	by hub.freebsd.org (Postfix) with ESMTP id 0C70A16A469
	for <freebsd-gnats-submit@FreeBSD.org>; Mon, 30 Jul 2007 23:36:28 +0000 (UTC)
	(envelope-from nobody@FreeBSD.org)
Received: from www.freebsd.org (www.freebsd.org [IPv6:2001:4f8:fff6::21])
	by mx1.freebsd.org (Postfix) with ESMTP id E9F6113C481
	for <freebsd-gnats-submit@FreeBSD.org>; Mon, 30 Jul 2007 23:36:27 +0000 (UTC)
	(envelope-from nobody@FreeBSD.org)
Received: from www.freebsd.org (localhost [127.0.0.1])
	by www.freebsd.org (8.14.1/8.14.1) with ESMTP id l6UNaRHY072351
	for <freebsd-gnats-submit@FreeBSD.org>; Mon, 30 Jul 2007 23:36:27 GMT
	(envelope-from nobody@www.freebsd.org)
Received: (from nobody@localhost)
	by www.freebsd.org (8.14.1/8.14.1/Submit) id l6UNaRcK072350;
	Mon, 30 Jul 2007 23:36:27 GMT
	(envelope-from nobody)
Message-Id: <200707302336.l6UNaRcK072350@www.freebsd.org>
Date: Mon, 30 Jul 2007 23:36:27 GMT
From: pluknet <pluknet@gmail.com>
To: freebsd-gnats-submit@FreeBSD.org
Subject: [patch] sync ps.1 with p_flag and keywords
X-Send-Pr-Version: www-3.0

>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:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Mon Jul 30 23:40:00 GMT 2007
>Closed-Date:    Sun Jan 27 00:13:26 UTC 2013
>Last-Modified:  Sun Jan 27 00:13:26 UTC 2013
>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:
State-Changed-From-To: open->patched 
State-Changed-By: pluknet 
State-Changed-When: Fri Jul 1 15:14:49 UTC 2011 
State-Changed-Why:  
All chunks committed to HEAD (except keyword aliases, I'm not sure about them). 

http://www.freebsd.org/cgi/query-pr.cgi?pr=115065 
State-Changed-From-To: patched->closed 
State-Changed-By: eadler 
State-Changed-When: Sun Jan 27 00:13:26 UTC 2013 
State-Changed-Why:  
MFCed/fixed by now or it will never be MFCed 

http://www.freebsd.org/cgi/query-pr.cgi?pr=115065 
>Unformatted:
