man/man1/ps.1

   1 .TH PS 1
   2 .SH NAME
   3 ps \- process status
   4 .SH SYNOPSIS
   5 \fBps \fR[\fR[\fB\-\fR]\fBalxE\fR]
   6 .br
   7 .de FL
   8 .TP
   9 \\fB\\$1\\fR
  10 \\$2
  11 ..
  12 .de EX
  13 .TP 20
  14 \\fB\\$1\\fR
  15 # \\$2
  16 ..
  17 .SH OPTIONS
  18 .FL "\-a" "Print all processes with controlling terminals"
  19 .FL "\-l" "Give long listing"
  20 .FL "\-x" "Include processes without a terminal"
  21 .FL "\-E" "Print kernel endpoint numbers where pids are normally printed"
  22 .SH EXAMPLES
  23 .EX "ps " "Show user's own processes in short format"
  24 .EX "ps \-axlE" "Print all processes and tasks in long format"
  25 .EX "ps \axlE" "Same -- the '\-' is optional"
  26 .SH DESCRIPTION
  27 .PP
  28 \fIPs\fR prints the status of active processes.  Normally only the caller's own
  29 processes are listed in short format (the PID, TTY, TIME and CMD fields as
  30 explained below).  The long listing contains:
  31 .PP
  32 .ta 0.5i 1.0i
  33   F     Kernel flags:
  34                 001: free slot
  35                 002: no memory map
  36                 004: sending;
  37                 010: receiving
  38                 020: inform on pending signals
  39                 040: pending signals
  40                 100: being traced.
  41 .PP
  42   S
  43         State:
  44                 R: runnable
  45                 W: waiting (on a message)
  46                 S: sleeping (i.e.,suspended on MM or FS)
  47                 Z: zombie
  48                 T: stopped
  49 .PP
  50   UID, PID, PPID, PGRP
  51         The user, process, parent process and process group ID's.
  52 .PP
  53   SZ
  54         Size of the process in kilobytes.
  55 .PP
  56   RECV
  57         Process/task on which a receiving process is waiting or sleeping.
  58 .PP
  59   TTY
  60         Controlling tty for the process.
  61 .PP
  62   TIME
  63         Process' cumulative (user + system) execution time.
  64 .PP
  65   CMD   Command line arguments of the process.
  66 .PP
  67 .PP
  68 The files \fI/dev/{mem,kmem}\fR are used to read the system tables and command
  69 line arguments from.  Terminal names in \fI/dev\fR are used to generate the
  70 mnemonic names in the TTY column, so \fIps\fR is independent of terminal naming
  71 conventions.
  72 .SH NOTES
  73 The '\-' option prefix is not required.
  74 For marginal compatibility with System V usage, the hidden option
  75 .B \-e
  76 means the same as
  77 .BR \-ax ,
  78 and
  79 .B \-f
  80 is the same as
  81 .BR \-l .
  82
  83 .\" edited by ASW 2004-12-14
  84