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 |