PS(1)                                                       PS(1)

     NAME
          ps, psu, pstree - process status

     SYNOPSIS
          ps [ -apnr ]

          psu [ -apnr ] [ user ]

          pstree [ pid ]

     DESCRIPTION
          Ps prints information about processes.  Psu prints only
          information about processes started by user (default $user).

          For each process reported, the user, process id, user time,
          system time, size, state, and command name are printed.
          State is one of the following:

          Moribund      Process has exited and is about to have its
                        resources reclaimed.

          Ready         on the queue of processes ready to be run.

          Scheding      about to be run.

          Running       running.

          Queueing      waiting on a queue for a resource.

          Wakeme        waiting for I/O or some other kernel event to
                        wake it up.

          Broken        dead of unnatural causes; lingering so that it
                        can be examined.

          Stopped       stopped.

          Stopwait      waiting for another process to stop.

          Fault         servicing a page fault.

          Idle          waiting for something to do (kernel processes
                        only).

          New           being created.

          Pageout       paging out some other process.

          Syscall       performing the named system call.

     Page 1                       Plan 9            (printed 12/22/24)

     PS(1)                                                       PS(1)

          no resource   waiting for more of a critical resource.

          The -n flag causes ps to print, after the process id, the
          note group to which the process belongs.

          The -r flag causes ps to print, before the user time, the
          elapsed real time for the process.

          The -p flag causes ps to print, after the system time, the
          baseline and current priorities of each process.

          The -a flag causes ps to print the arguments for the pro-
          cess.  Newlines in arguments will be translated to spaces
          for display.

          Pstree prints the processes as a tree in a two-column layout
          where the first column being the process id and second col-
          umn the program name and arguments indented and prefixed
          with line drawing runes to reflect the nesting in the hier-
          archy.  It optionally accepts an argument pid to only print
          a tree for the corresponding process.

     FILES
          /proc/*/status

     SOURCE
          /sys/src/cmd/ps.c
          /rc/bin/psu
          /rc/bin/pstree

     SEE ALSO
          acid(1), db(1), kill(1), ns(1), proc(3)

     HISTORY
          Pstree first appeared in 9front (June, 2011).

     Page 2                       Plan 9            (printed 12/22/24)