| 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 |