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