1 PTREE(1) User Commands PTREE(1)
2
3
4
5 NAME
6 ptree - print process trees
7
8 SYNOPSIS
9 /usr/bin/ptree [-a] [-c] [-z zone] [pid | user]...
10
11
12 DESCRIPTION
13 The ptree utility prints the process trees containing the specified
14 pids or users, with child processes indented from their respective
15 parent processes. An argument of all digits is taken to be a process-
16 ID, otherwise it is assumed to be a user login name. The default is all
17 processes.
18
19 OPTIONS
20 The following options are supported:
21
22 -a
23 All. Print all processes, including children of process 0.
24
25
26 -c
27 Contracts. Print process contract memberships in addition to
28 parent-child relationships. See process(4). This option
29 implies the -a option.
30
31
32 -z zone
33 Zones. Print only processes in the specified zone. Each zone
34 ID can be specified as either a zone name or a numerical
35 zone ID.
36
37 This option is only useful when executed in the global zone.
38
39
40 OPERANDS
41 The following operands are supported:
42
43 pid
44 Process-id or a list of process-ids. ptree also accepts
45 /proc/nnn as a process-id, so the shell expansion /proc/* can
46 be used to specify all processes in the system.
47
48
49 user
50 Username or list of usernames. Processes whose effective user
51 IDs match those given are displayed.
52
53
54 EXAMPLES
55 Example 1 Using ptree
56
57
58 The following example prints the process tree (including children of
59 process 0) for processes which match the command name ssh:
60
61
62 $ ptree -a `pgrep ssh`
63 1 /sbin/init
64 100909 /usr/lib/ssh/sshd
65 569150 /usr/lib/ssh/sshd
66 569157 /usr/lib/ssh/sshd
67 569159 -ksh
68 569171 bash
69 569173 /bin/ksh
70 569193 bash
71
72
73
74 EXIT STATUS
75 The following exit values are returned:
76
77 0
78 Successful operation.
79
80
81 non-zero
82 An error has occurred.
83
84
85 FILES
86 /proc/*
87 process files
88
89
90 ATTRIBUTES
91 See attributes(5) for descriptions of the following attributes:
92
93
94
95
96 +--------------------+-----------------+
97 | ATTRIBUTE TYPE | ATTRIBUTE VALUE |
98 +--------------------+-----------------+
99 |Interface Stability | See below. |
100 +--------------------+-----------------+
101
102
103 The human readable output is Unstable. The options are Evolving.
104
105 SEE ALSO
106 gcore(1), ldd(1), pargs(1), pgrep(1), pkill(1), plimit(1), pmap(1),
107 preap(1), proc(1), ps(1), ppgsz(1), pwd(1), rlogin(1), time(1),
108 truss(1), wait(1), fcntl(2), fstat(2), setuid(2), dlopen(3C),
109 signal.h(3HEAD), core(4), proc(4), process(4), attributes(5), zones(5)
110
111
112
113 October 11, 2005 PTREE(1)
|
1 PTREE(1) User Commands PTREE(1)
2
3 NAME
4 ptree - print process trees
5
6 SYNOPSIS
7 ptree [-a] [-c] [-z zone] [pid | user]...
8
9 DESCRIPTION
10 The ptree utility prints the process trees containing the specified pids
11 or users, with child processes indented from their respective parent
12 processes. An argument of all digits is taken to be a process-ID,
13 otherwise it is assumed to be a user login name. The default is all
14 processes.
15
16 OPTIONS
17 The following options are supported:
18
19 -a All. Print all processes, including children of process 0.
20
21 -c Contracts. Print process contract memberships in addition to
22 parent-child relationships. See process(4). This option
23 implies the -a option.
24
25 -z zone Zones. Print only processes in the specified zone. Each zone
26 ID can be specified as either a zone name or a numerical zone
27 ID.
28
29 This option is only useful when executed in the global zone.
30
31 OPERANDS
32 The following operands are supported:
33
34 pid Process-id or a list of process-ids. ptree also accepts /proc/nnn
35 as a process-id, so the shell expansion /proc/* can be used to
36 specify all processes in the system.
37
38 user Username or list of usernames. Processes whose effective user IDs
39 match those given are displayed.
40
41 FILES
42 /proc/* process files
43
44 EXIT STATUS
45 The ptree utility exits 0 on success, and >0 if an error occurs.
46
47 EXAMPLES
48 Example 1 Using ptree
49
50 The following example prints the process tree (including children of
51 process 0) for processes which match the command name ssh:
52
53 $ ptree -a `pgrep ssh`
54 1 /sbin/init
55 100909 /usr/lib/ssh/sshd
56 569150 /usr/lib/ssh/sshd
57 569157 /usr/lib/ssh/sshd
58 569159 -ksh
59 569171 bash
60 569173 /bin/ksh
61 569193 bash
62
63 INTERFACE STABILITY
64 Not-an-Interface
65
66 SEE ALSO
67 gcore(1), ldd(1), pargs(1), pgrep(1), pkill(1), plimit(1), pmap(1),
68 ppgsz(1), preap(1), proc(1), ps(1), pwd(1), rlogin(1), time(1), truss(1),
69 wait(1), fcntl(2), fstat(2), setuid(2), dlopen(3C), signal.h(3HEAD),
70 core(4), proc(4), process(4), attributes(5), zones(5)
71
72 illumos January 12, 2019 illumos
|