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 25 matching lines...) Expand all Loading... |
36 This server is normally started by its initial client, and it performs a | 36 This server is normally started by its initial client, and it performs a |
37 handshake with this client via a pipe established by the client that is | 37 handshake with this client via a pipe established by the client that is |
38 inherited by the server, referenced by the *--handshake-fd* argument. During the | 38 inherited by the server, referenced by the *--handshake-fd* argument. During the |
39 handshake, the server furnishes the client with a send right that the client may | 39 handshake, the server furnishes the client with a send right that the client may |
40 use as an exception port. The server retains the corresponding receive right, | 40 use as an exception port. The server retains the corresponding receive right, |
41 which it monitors for exception messages. When the receive right loses all | 41 which it monitors for exception messages. When the receive right loses all |
42 senders, the server exits after allowing any upload in progress to complete. | 42 senders, the server exits after allowing any upload in progress to complete. |
43 | 43 |
44 It is not normally appropriate to invoke this program directly. Usually, it will | 44 It is not normally appropriate to invoke this program directly. Usually, it will |
45 be invoked by a Crashpad client using the Crashpad client library. Arbitrary | 45 be invoked by a Crashpad client using the Crashpad client library. Arbitrary |
46 programs may be run with a Crashpad handler by using run_with_crashpad(1) to | 46 programs may be run with a Crashpad handler by using |
47 establish the Crashpad client environment before running a program. | 47 man_link:run_with_crashpad[1] to establish the Crashpad client environment |
| 48 before running a program. |
48 | 49 |
49 == Options | 50 == Options |
50 *--annotation*='KEY=VALUE':: | 51 *--annotation*='KEY=VALUE':: |
51 Sets a process-level annotation mapping 'KEY' to 'VALUE' in each crash report | 52 Sets a process-level annotation mapping 'KEY' to 'VALUE' in each crash report |
52 that is written. This option may appear zero, one, or multiple times. | 53 that is written. This option may appear zero, one, or multiple times. |
53 + | 54 + |
54 Most annotations should be provided by the Crashpad client as module-level | 55 Most annotations should be provided by the Crashpad client as module-level |
55 annotations instead of process-level annotations. Module-level annotations are | 56 annotations instead of process-level annotations. Module-level annotations are |
56 more flexible in that they can be modified and cleared during the client | 57 more flexible in that they can be modified and cleared during the client |
57 program’s lifetime. Module-level annotations can be set via the Crashpad client | 58 program’s lifetime. Module-level annotations can be set via the Crashpad client |
(...skipping 34 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
92 == Exit Status | 93 == Exit Status |
93 | 94 |
94 *0*:: | 95 *0*:: |
95 Success. | 96 Success. |
96 | 97 |
97 *1*:: | 98 *1*:: |
98 Failure, with a message printed to the standard error stream. | 99 Failure, with a message printed to the standard error stream. |
99 | 100 |
100 == See Also | 101 == See Also |
101 | 102 |
102 catch_exception_tool(1), | 103 man_link:catch_exception_tool[1], |
103 generate_dump(1), | 104 man_link:generate_dump[1], |
104 run_with_crashpad(1) | 105 man_link:run_with_crashpad[1] |
105 | 106 |
106 include::../../doc/man_footer.ad[] | 107 include::../../doc/man_footer.ad[] |
OLD | NEW |