Reformatting page.  Please Wait... done


User Commands                                            PTREE(1)


NAME
     ptree - print process trees

SYNOPSIS
     /usr/bin/ptree [-a] [-c] [-z zone] [pid | user]...


DESCRIPTION
     The ptree utility prints the process  trees  containing  the
     specified  pids or users, with child processes indented from
     their respective parent processes. An argument of all digits
     is taken to be a process-ID, otherwise it is assumed to be a
     user login name. The default is all processes.

OPTIONS
     The following options are supported:

     -a
                All. Print all processes, including  children  of
                process 0.


     -c
                Contracts. Print process contract memberships  in
                addition  to parent-child relationships. See pro-
                cess(4). This option implies the -a option.


     -z zone
                Zones. Print  only  processes  in  the  specified
                zone.  Each  zone ID can be specified as either a
                zone name or a numerical zone ID.

                This option is only useful when executed  in  the
                global zone.


OPERANDS
     The following operands are supported:

     pid
             Process-id or a  list  of  process-ids.  ptree  also
             accepts  /proc/nnn  as  a  process-id,  so the shell
             expansion  /proc/*  can  be  used  to  specify   all
             processes in the system.


     user
             Username  or  list  of  usernames.  Processes  whose
             effective user IDs match those given are displayed.


Illumos             Last change: Oct 11, 2005                   1


User Commands                                            PTREE(1)


EXAMPLES
     Example 1 Using ptree


     The following example prints  the  process  tree  (including
     children of process 0) for processes which match the command
     name ssh:


       $ ptree -a `pgrep ssh`
               1     /sbin/init
                 100909 /usr/lib/ssh/sshd
                   569150 /usr/lib/ssh/sshd
                     569157 /usr/lib/ssh/sshd
                       569159 -ksh
                         569171 bash
                           569173 /bin/ksh
                             569193 bash


EXIT STATUS
     The following exit values are returned:

     0
                 Successful operation.


     non-zero
                 An error has occurred.


FILES
     /proc/*
                process files


ATTRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:


     _______________________________________
    |   ATTRIBUTE TYPE   |  ATTRIBUTE VALUE|
    |____________________|_________________|
    | Interface Stability|  See below.     |
    |____________________|_________________|


Illumos             Last change: Oct 11, 2005                   2


User Commands                                            PTREE(1)


     The human readable  output  is  Unstable.  The  options  are
     Evolving.

SEE ALSO
     gcore(1)ldd(1)pargs(1)pgrep(1),  pkill(1),  plimit(1),
     pmap(1),  preap(1),  proc(1),  ps(1)ppgsz(1)pwd(1), rlo-
     gin(1),  time(1),  truss(1),  wait(1),  fcntl(2),  fstat(2),
     setuid(2),  dlopen(3C),  signal.h(3HEAD),  core(4)proc(4),
     process(4)attributes(5)zones(5)


Illumos             Last change: Oct 11, 2005                   3