PTREE(1)							      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 par‐
       ent  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  process(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

       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 attributes:

       ┌────────────────────┬─────────────────┐
       │  ATTRIBUTE TYPE    │ ATTRIBUTE VALUE │
       ├────────────────────┼─────────────────┤
       │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),	 rlogin(1),   time(1),
       truss(1),  wait(1),  fcntl(2),  fstat(2),  setuid(2),  dlopen(3C), sig‐
       nal.h(3HEAD), core(4), proc(4), process(4), attributes(5), zones(5)

				 Oct 11, 2005			      PTREE(1)

Vote for polarhome