From owner-freebsd-doc@FreeBSD.ORG Mon Jul 30 23:40:01 2007 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 8ACE916A419 for ; Mon, 30 Jul 2007 23:40:01 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28]) by mx1.freebsd.org (Postfix) with ESMTP id 7187C13C4F4 for ; Mon, 30 Jul 2007 23:40:01 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1]) by freefall.freebsd.org (8.14.1/8.14.1) with ESMTP id l6UNe1k5097493 for ; Mon, 30 Jul 2007 23:40:01 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.1/8.14.1/Submit) id l6UNe1YA097492; Mon, 30 Jul 2007 23:40:01 GMT (envelope-from gnats) Resent-Date: Mon, 30 Jul 2007 23:40:01 GMT Resent-Message-Id: <200707302340.l6UNe1YA097492@freefall.freebsd.org> Resent-From: FreeBSD-gnats-submit@FreeBSD.org (GNATS Filer) Resent-To: freebsd-doc@FreeBSD.org Resent-Reply-To: FreeBSD-gnats-submit@FreeBSD.org, pluknet Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 0C70A16A469 for ; 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 ; 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 ; 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 To: freebsd-gnats-submit@FreeBSD.org X-Send-Pr-Version: www-3.0 Cc: Subject: docs/115065: [patch] sync ps.1 with p_flag and keywords X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 30 Jul 2007 23:40:01 -0000 >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: