MAN Solaris - ptree (1)

advertisement


NAME

ptree - print process trees

CONTENTS

Synopsis
Description
Options
Operands
Examples
Exit Status
Files
Attributes
See Also

SYNOPSIS

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

advertisements

advertisements


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 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 TYPEATTRIBUTE VALUE
AvailabilitySUNWesu

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)

Jump to page    or go to Top of page |  Section 1 |  Main Solaris Index.


SunOS 5.11 ptree (1) 11 Oct 2005
Generated by Open Solaris Forum from /usr/share/man/man1/ptree.1 using man macros with tbl support.