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.


EXAMPLES
     Example 1 Using ptree






SunOS 5.11          Last change: 11 Oct 2005                    1






User Commands                                            ptree(1)



     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


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



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     Availability                 SUNWesu                     
    
     Interface Stability          See below.                  
    



     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),



SunOS 5.11          Last change: 11 Oct 2005                    2






User Commands                                            ptree(1)



     rlogin(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)




















































SunOS 5.11          Last change: 11 Oct 2005                    3