Print this page
10270 Convert ptree(1) to mandoc
*** 1,66 ****
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
! 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
--- 1,57 ----
PTREE(1) User Commands PTREE(1)
NAME
ptree - print process trees
SYNOPSIS
! 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 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.
! FILES
! /proc/* process files
+ EXIT STATUS
+ The ptree utility exits 0 on success, and >0 if an error occurs.
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
*** 67,113 ****
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),
! signal.h(3HEAD), core(4), proc(4), process(4), attributes(5), zones(5)
!
!
! October 11, 2005 PTREE(1)
--- 58,72 ----
569159 -ksh
569171 bash
569173 /bin/ksh
569193 bash
+ INTERFACE STABILITY
+ Not-an-Interface
SEE ALSO
gcore(1), ldd(1), pargs(1), pgrep(1), pkill(1), plimit(1), pmap(1),
! ppgsz(1), preap(1), proc(1), ps(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)
! illumos January 12, 2019 illumos