| 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 22 matching lines...) Expand all Loading... |
| 33 while the minidump is generated, and the minidump file will be written to | 33 while the minidump is generated, and the minidump file will be written to |
| 34 +minidump.PID+. After the minidump file is generated, the target process resumes | 34 +minidump.PID+. After the minidump file is generated, the target process resumes |
| 35 running. | 35 running. |
| 36 | 36 |
| 37 The minidump file will contain information about the process, its threads, its | 37 The minidump file will contain information about the process, its threads, its |
| 38 modules, and the system. It will not contain any exception information because | 38 modules, and the system. It will not contain any exception information because |
| 39 it will be generated from a live running process, not as a result of an | 39 it will be generated from a live running process, not as a result of an |
| 40 exception occurring. | 40 exception occurring. |
| 41 | 41 |
| 42 This program uses +task_for_pid()+ to access the process’ task port. This | 42 This program uses +task_for_pid()+ to access the process’ task port. This |
| 43 operation may be restricted to use by the superuser or processes permitted by | 43 operation may be restricted to use by the superuser, executables signed by an |
| 44 taskgated(8). Consequently, this program must normally be invoked by root. It is | 44 authority trusted by the system, and processes otherwise permitted by |
| 45 possible to install this program as a setuid root executable to overcome this | 45 taskgated(8). Consequently, this program must normally either be signed or be |
| 46 limitation. | 46 invoked by root. It is possible to install this program as a setuid root |
| 47 executable to overcome this limitation. |
| 47 | 48 |
| 48 This program is similar to the gcore(1) program available on some operating | 49 This program is similar to the gcore(1) program available on some operating |
| 49 systems. | 50 systems. |
| 50 | 51 |
| 51 == Options | 52 == Options |
| 52 | 53 |
| 53 *-r*, *--no-suspend*:: | 54 *-r*, *--no-suspend*:: |
| 54 The target process will continue running while the minidump file is generated. | 55 The target process will continue running while the minidump file is generated. |
| 55 Normally, the target process is suspended during this operation, which | 56 Normally, the target process is suspended during this operation, which |
| 56 guarantees that the minidump file will contain an atomic snapshot of the | 57 guarantees that the minidump file will contain an atomic snapshot of the |
| (...skipping 29 matching lines...) Expand all Loading... |
| 86 Success. | 87 Success. |
| 87 | 88 |
| 88 *1*:: | 89 *1*:: |
| 89 Failure, with a message printed to the standard error stream. | 90 Failure, with a message printed to the standard error stream. |
| 90 | 91 |
| 91 == See Also | 92 == See Also |
| 92 | 93 |
| 93 catch_exception_tool(1) | 94 catch_exception_tool(1) |
| 94 | 95 |
| 95 include::man_footer.ad[] | 96 include::man_footer.ad[] |
| OLD | NEW |