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, |
11 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. | 11 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. |
12 // See the License for the specific language governing permissions and | 12 // See the License for the specific language governing permissions and |
13 // limitations under the License. | 13 // limitations under the License. |
14 | 14 |
15 #ifndef CRASHPAD_CLIENT_CRASHPAD_CLIENT_H_ | 15 #ifndef CRASHPAD_CLIENT_CRASHPAD_CLIENT_H_ |
16 #define CRASHPAD_CLIENT_CRASHPAD_CLIENT_H_ | 16 #define CRASHPAD_CLIENT_CRASHPAD_CLIENT_H_ |
17 | 17 |
18 #include <map> | 18 #include <map> |
19 #include <string> | 19 #include <string> |
20 #include <vector> | 20 #include <vector> |
21 | 21 |
22 #include "base/basictypes.h" | 22 #include "base/basictypes.h" |
23 #include "base/files/file_path.h" | 23 #include "base/files/file_path.h" |
24 #include "build/build_config.h" | 24 #include "build/build_config.h" |
25 | 25 |
26 #if defined(OS_MACOSX) | 26 #if defined(OS_MACOSX) |
27 #include "base/mac/scoped_mach_port.h" | 27 #include "base/mac/scoped_mach_port.h" |
| 28 #elif defined(OS_WIN) |
| 29 #include <windows.h> |
28 #endif | 30 #endif |
29 | 31 |
30 namespace crashpad { | 32 namespace crashpad { |
31 | 33 |
32 //! \brief The primary interface for an application to have Crashpad monitor | 34 //! \brief The primary interface for an application to have Crashpad monitor |
33 //! it for crashes. | 35 //! it for crashes. |
34 class CrashpadClient { | 36 class CrashpadClient { |
35 public: | 37 public: |
36 CrashpadClient(); | 38 CrashpadClient(); |
37 ~CrashpadClient(); | 39 ~CrashpadClient(); |
(...skipping 42 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
80 //! until UseHandler() is called. | 82 //! until UseHandler() is called. |
81 //! | 83 //! |
82 //! The IPC port name (somehow) encodes enough information so that | 84 //! The IPC port name (somehow) encodes enough information so that |
83 //! registration is done with a crash handler using the appropriate database | 85 //! registration is done with a crash handler using the appropriate database |
84 //! and upload server. | 86 //! and upload server. |
85 //! | 87 //! |
86 //! \param[in] ipc_port The full name of the crash handler IPC port. | 88 //! \param[in] ipc_port The full name of the crash handler IPC port. |
87 //! | 89 //! |
88 //! \return `true` on success and `false` on failure. | 90 //! \return `true` on success and `false` on failure. |
89 bool SetHandler(const std::string& ipc_port); | 91 bool SetHandler(const std::string& ipc_port); |
| 92 |
| 93 //! \brief Requests that the handler capture a dump even though there hasn't |
| 94 //! been a crash. |
| 95 //! |
| 96 //! \param[in] context A CONTEXT, generally captured by `RtlCaptureContext()` |
| 97 //! or similar. |
| 98 static void DumpWithoutCrash(const CONTEXT& context); |
90 #endif | 99 #endif |
91 | 100 |
92 //! \brief Configures the process to direct its crashes to a Crashpad handler. | 101 //! \brief Configures the process to direct its crashes to a Crashpad handler. |
93 //! | 102 //! |
94 //! The Crashpad handler must previously have been started by StartHandler() | 103 //! The Crashpad handler must previously have been started by StartHandler() |
95 //! or configured by SetHandler(). | 104 //! or configured by SetHandler(). |
96 //! | 105 //! |
97 //! On Mac OS X, this method sets the task’s exception port for `EXC_CRASH`, | 106 //! On Mac OS X, this method sets the task’s exception port for `EXC_CRASH`, |
98 //! `EXC_RESOURCE`, and `EXC_GUARD` exceptions to the Mach send right obtained | 107 //! `EXC_RESOURCE`, and `EXC_GUARD` exceptions to the Mach send right obtained |
99 //! by StartHandler(). The handler will be installed with behavior | 108 //! by StartHandler(). The handler will be installed with behavior |
(...skipping 17 matching lines...) Expand all Loading... |
117 #if defined(OS_MACOSX) | 126 #if defined(OS_MACOSX) |
118 base::mac::ScopedMachSendRight exception_port_; | 127 base::mac::ScopedMachSendRight exception_port_; |
119 #endif | 128 #endif |
120 | 129 |
121 DISALLOW_COPY_AND_ASSIGN(CrashpadClient); | 130 DISALLOW_COPY_AND_ASSIGN(CrashpadClient); |
122 }; | 131 }; |
123 | 132 |
124 } // namespace crashpad | 133 } // namespace crashpad |
125 | 134 |
126 #endif // CRASHPAD_CLIENT_CRASHPAD_CLIENT_H_ | 135 #endif // CRASHPAD_CLIENT_CRASHPAD_CLIENT_H_ |
OLD | NEW |