OLD | NEW |
1 // Copyright 2014 The Crashpad Authors. All rights reserved. | 1 // Copyright 2014 The Crashpad Authors. All rights reserved. |
2 // | 2 // |
3 // Licensed under the Apache License, Version 2.0 (the "License"); | 3 // Licensed under the Apache License, Version 2.0 (the "License"); |
4 // you may not use this file except in compliance with the License. | 4 // you may not use this file except in compliance with the License. |
5 // You may obtain a copy of the License at | 5 // You may obtain a copy of the License at |
6 // | 6 // |
7 // http://www.apache.org/licenses/LICENSE-2.0 | 7 // http://www.apache.org/licenses/LICENSE-2.0 |
8 // | 8 // |
9 // Unless required by applicable law or agreed to in writing, software | 9 // Unless required by applicable law or agreed to in writing, software |
10 // distributed under the License is distributed on an "AS IS" BASIS, | 10 // distributed under the License is distributed on an "AS IS" BASIS, |
(...skipping 74 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
85 handles, but by comparing them to the port values for known bootstrap services, | 85 handles, but by comparing them to the port values for known bootstrap services, |
86 it is possible to verify that they are set as intended. | 86 it is possible to verify that they are set as intended. |
87 | 87 |
88 *-p*, *--pid*='PID':: | 88 *-p*, *--pid*='PID':: |
89 For operations on the task target, including *--set-handler* with 'TARGET' set | 89 For operations on the task target, including *--set-handler* with 'TARGET' set |
90 to *task*, *--show-task*, and *--show-new-task*, operates on the task associated | 90 to *task*, *--show-task*, and *--show-new-task*, operates on the task associated |
91 with process id 'PID' instead of the current task associated with the tool. When | 91 with process id 'PID' instead of the current task associated with the tool. When |
92 this option is supplied, 'COMMAND' must not be specified. | 92 this option is supplied, 'COMMAND' must not be specified. |
93 + | 93 + |
94 This option uses +task_for_pid()+ to access the process’ task port. This | 94 This option uses +task_for_pid()+ to access the process’ task port. This |
95 operation may be restricted to use by the superuser or processes permitted by | 95 operation may be restricted to use by the superuser, executables signed by an |
96 taskgated(8). Consequently, this program must normally be invoked by root to use | 96 authority trusted by the system, and processes otherwise permitted by |
97 this option. It is possible to install this program as a setuid root executable | 97 taskgated(8). Consequently, this program must normally either be signed or be |
98 to overcome this limitation. | 98 invoked by root to use this option. It is possible to install this program as a |
| 99 setuid root executable to overcome this limitation. |
99 | 100 |
100 *-h*, *--show-host*:: | 101 *-h*, *--show-host*:: |
101 Shows the original host exception ports before making any changes requested by | 102 Shows the original host exception ports before making any changes requested by |
102 *--set-handler*. This option is restricted to the superuser. | 103 *--set-handler*. This option is restricted to the superuser. |
103 | 104 |
104 *-t*, *--show-task*:: | 105 *-t*, *--show-task*:: |
105 Shows the original task exception ports before making any changes requested by | 106 Shows the original task exception ports before making any changes requested by |
106 *--set-handler*. | 107 *--set-handler*. |
107 | 108 |
108 *--show-thread*:: | 109 *--show-thread*:: |
(...skipping 69 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
178 | 179 |
179 *127*:: | 180 *127*:: |
180 The program specified by 'COMMAND' could not be found. | 181 The program specified by 'COMMAND' could not be found. |
181 | 182 |
182 == See Also | 183 == See Also |
183 | 184 |
184 catch_exception_tool(1), | 185 catch_exception_tool(1), |
185 on_demand_service_tool(1) | 186 on_demand_service_tool(1) |
186 | 187 |
187 include::../man_footer.ad[] | 188 include::../man_footer.ad[] |
OLD | NEW |