ptree(1)							   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 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	   |
       +-----------------------------+-----------------------------+
       |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), 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							    11 Oct 2005 							  ptree(1)