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 .TP 5
  19 .B \-a
  20 # Print all processes with controlling terminals
  21 .TP 5
  22 .B \-l
  23 # Give long listing
  24 .TP 5
  25 .B \-x
  26 # Include processes without a terminal
  27 .TP 5
  28 .B \-E
  29 # Print kernel endpoint numbers where pids are normally printed
  30 .SH EXAMPLES
  31 .TP 20
  32 .B ps
  33 # Show user's own processes in short format
  34 .TP 20
  35 .B ps \-axlE
  36 # Print all processes and tasks in long format
  37 .TP 20
  38 .B ps \axlE
  39 # Same -- the '\-' is optional
  40 .SH DESCRIPTION
  41 .PP
  42 \fIPs\fR prints the status of active processes.  Normally only the caller's own
  43 processes are listed in short format (the PID, TTY, TIME and CMD fields as
  44 explained below).  The long listing contains:
  45 .PP
  46   ST
  47         State:
  48                 R: runnable
  49                 W: waiting (on a message)
  50                 S: sleeping (i.e.,suspended on PM or VFS)
  51                 Z: zombie
  52                 T: stopped
  53 .PP
  54   UID, PID, PPID, PGRP
  55         The user, process, parent process and process group ID's.
  56 .PP
  57   SZ
  58         Size of the process in kilobytes.
  59 .PP
  60   RECV
  61         Process/task on which a receiving process is waiting or sleeping.
  62 .PP
  63   TTY
  64         Controlling tty for the process.
  65 .PP
  66   TIME
  67         Process' cumulative (user + system) execution time.
  68 .PP
  69   CMD   Command line arguments of the process.
  70 .PP
  71 .PP
  72 The \fI/proc\fR file system is used to obtain the process information.
  73 Terminal names in \fI/dev\fR are used to generate the
  74 mnemonic names in the TTY column, so \fIps\fR is independent of terminal naming
  75 conventions.
  76 .SH NOTES
  77 The '\-' option prefix is not required.
  78 For marginal compatibility with System V usage, the hidden option
  79 .B \-e
  80 means the same as
  81 .BR \-ax ,
  82 and
  83 .B \-f
  84 is the same as
  85 .BR \-l .
  86
  87 .\" edited by ASW 2004-12-14
  88