


PS(1)                                                       PS(1)


NNAAMMEE
       ps -- display processes

SSYYNNOOPPSSIISS
       ppss --aacceehhjjllmmnnrrssuuvvwwxxSSUU --tt_x_x _s_y_s_t_e_m_p_a_t_h _s_w_a_p_p_a_t_h

DDEESSCCRRIIPPTTIIOONN
       PPss shows information about running processes.  tty name or
       pid must be given after the last option, no space  between
       options and pid or tty, -- is optional.

       Description of the displayed fields:

       PRI    priority,  this is not the priority in task_struct,
              a low number means that the process gets  more  cpu
              time if it can run.

       NI     nice value, a positive value means less cpu time.

       SIZE   virtual image size, size of text+data+stack

       RSS    resident  set size, kilobytes of program in memory.

       WCHAN  name of the kernel function where  the  process  is
              sleeping.

       STAT   status

              R      runnable

              S      sleeping

              D      uninterruptible sleep

              T      stopped or traced

              Z      zombie

              W      process has no resident pages

       %CPU   percentage of cpu time / real time, this is differ-
              ent from UNIX ps

       %MEM   percentage of available memory in use by this  pro-
              cess,  the  total  of all processes can exceed 100%
              because of shared pages. This  is  not  a  decaying
              average as in UNIX ps.

       TT     controlling tty

       TPGID  current process group of controlling tty

       PAGEIN number of major page faults




                           25 June 1992                         1





PS(1)                                                       PS(1)


       TRS    text   resident   size,  does  not  include  shared
              libraries

       DRS    data resident size, includes  dirty  library  pages
              and stack.

       SWAP   kilobytes (with --pp pages) on swap device

       SHRD   shared memory

       DT     dirty library pages (kb or # pages with -p)

       F      process flags

              04     process has used math emulator

              10     process is being traced

OOPPTTIIOONNSS
       --aa     show processes of all users

       --cc     show command name stored in task_struct

       --ee     show environment, cannot be combined with --ee option

       --hh     no header

       --jj     jobs format: pgid sid

       --ll     long format: flags, wchan, nice value, priority

       --mm     displays memory info (combine with --pp flag  to  get
              number  of  pages): shared and swapped sizes, minor
              and major page faults.  The size field  shown  with
              this  option  is  the  size  computed from the page
              tables, it should be equal to the sum of  SWAP  and
              RSS.

       --XX     another format: displays the registers eip and esp,
              timeout and alarm

       --nn     numeric output for USER and WCHAN

       --rr     running processes only, these include processes  in
              an uninterruptible sleep

       --ss     signal format

       --uu     user format: gives user name and start-time

       --vv     vm format

       --ww     wide output, can be specified more then once




                           25 June 1992                         2





PS(1)                                                       PS(1)


       --xx     show processes without controlling terminal

       --SS     add cpu time and page fault count from reaped chil-
              dren

       --UU     update psdatabase. The arguments syspath and  swap-
              path  if given are stored in the psdatabase and the
              symbol info is updated, if no system path is  given
              the path in the old psdatabase is used.

       --tt_x_x   only  procs with controlling tty _x_x, use for _x_x the
              same letters as shown in TT field. If _x_x is omitted
              the controlling terminal of ps is used.

FFIILLEESS
       /dev/kmem kernel memory
       /dev/swap swapdevice or (link to) swap file
       /etc/psdatabase symbol information

SSEEEE AALLSSOO
       kill(1)

BBUUGGSS
       Tty names are hard coded: virtual consoles are a1, a2, ...
       serial lines are s0 and s1, pty's are p0, p1 ...

       %CPU and %MEM don't give decaying averages, %CPU  is  dif-
       ferent from UNIX ps.

       Things  can  change  while  ppss  is running, the picture it
       gives is only a close approximation to reality.

AAUUTTHHOORR
       Branko Lankester (lankeste@fwi.uva.nl)
       Initial man-page by Michael Haardt






















                           25 June 1992                         3


