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 sleep-
        ing.

    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  different
        from UNIX ps

    %MEM
        percentage  of  available  memory in use by this process,
        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



                           25 June 1992                         1





PS(1)                                                       PS(1)


    TPGID
        current process group of controlling tty

    PAGEIN
        number of major page faults

    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, time-
        out and alarm

    --nn  numeric output for USER and WCHAN

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

    --ss  signal format




                           25 June 1992                         2





PS(1)                                                       PS(1)


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

    --vv  vm format

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

    --xx  show processes without controlling terminal

    --SS  add cpu time and page fault count from reaped children

    --UU  update  psdatabase. The arguments syspath and swappath 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 con-
        trolling 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 different
    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