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_SNAPSHOT_PROCESS_SNAPSHOT_H_ | 15 #ifndef CRASHPAD_SNAPSHOT_PROCESS_SNAPSHOT_H_ |
16 #define CRASHPAD_SNAPSHOT_PROCESS_SNAPSHOT_H_ | 16 #define CRASHPAD_SNAPSHOT_PROCESS_SNAPSHOT_H_ |
17 | 17 |
18 #include <sys/time.h> | 18 #include <sys/time.h> |
19 #include <sys/types.h> | 19 #include <sys/types.h> |
20 | 20 |
21 #include <map> | 21 #include <map> |
22 #include <string> | 22 #include <string> |
23 #include <vector> | 23 #include <vector> |
24 | 24 |
25 #include "util/misc/uuid.h" | 25 #include "util/misc/uuid.h" |
26 | 26 |
27 namespace crashpad { | 27 namespace crashpad { |
28 | 28 |
29 class ExceptionSnapshot; | 29 class ExceptionSnapshot; |
30 class MemorySnapshot; | |
30 class ModuleSnapshot; | 31 class ModuleSnapshot; |
31 class SystemSnapshot; | 32 class SystemSnapshot; |
32 class ThreadSnapshot; | 33 class ThreadSnapshot; |
33 | 34 |
34 //! \brief An abstract interface to a snapshot representing the state of a | 35 //! \brief An abstract interface to a snapshot representing the state of a |
35 //! process. | 36 //! process. |
36 //! | 37 //! |
37 //! This is the top-level object in a family of Snapshot objects, because it | 38 //! This is the top-level object in a family of Snapshot objects, because it |
38 //! gives access to a SystemSnapshot, vectors of ModuleSnapshot and | 39 //! gives access to a SystemSnapshot, vectors of ModuleSnapshot and |
39 //! ThreadSnapshot objects, and possibly an ExceptionSnapshot. In turn, | 40 //! ThreadSnapshot objects, and possibly an ExceptionSnapshot. In turn, |
(...skipping 88 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... | |
128 const = 0; | 129 const = 0; |
129 | 130 |
130 //! \brief Returns a SystemSnapshot reflecting the characteristics of the | 131 //! \brief Returns a SystemSnapshot reflecting the characteristics of the |
131 //! system that ran the snapshot process at the time of the snapshot. | 132 //! system that ran the snapshot process at the time of the snapshot. |
132 //! | 133 //! |
133 //! \return A SystemSnapshot object. The caller does not take ownership of | 134 //! \return A SystemSnapshot object. The caller does not take ownership of |
134 //! this object, it is scoped to the lifetime of the ProcessSnapshot | 135 //! this object, it is scoped to the lifetime of the ProcessSnapshot |
135 //! object that it was obtained from. | 136 //! object that it was obtained from. |
136 virtual const SystemSnapshot* System() const = 0; | 137 virtual const SystemSnapshot* System() const = 0; |
137 | 138 |
139 //! \brief Returns a MemorySnapshot consisting of the Process Environment | |
140 //! Block of the process. | |
141 //! | |
Mark Mentovai
2015/09/23 21:40:50
Say that this is only a sensible thing on Windows.
scottmg
2015/09/24 20:00:10
Gone.
| |
142 //! \return A MemorySnapshot object. The caller does not take ownership of | |
143 //! this object, is is scoped to the lifetime of the ProcessSnapshot | |
144 //! object that it was obtained from. | |
145 virtual const MemorySnapshot* Peb() const = 0; | |
146 | |
138 //! \brief Returns ModuleSnapshot objects reflecting the code modules (binary | 147 //! \brief Returns ModuleSnapshot objects reflecting the code modules (binary |
139 //! images) loaded into the snapshot process at the time of the snapshot. | 148 //! images) loaded into the snapshot process at the time of the snapshot. |
140 //! | 149 //! |
141 //! \return A vector of ModuleSnapshot objects. The caller does not take | 150 //! \return A vector of ModuleSnapshot objects. The caller does not take |
142 //! ownership of these objects, they are scoped to the lifetime of the | 151 //! ownership of these objects, they are scoped to the lifetime of the |
143 //! ProcessSnapshot object that they were obtained from. | 152 //! ProcessSnapshot object that they were obtained from. |
144 virtual std::vector<const ModuleSnapshot*> Modules() const = 0; | 153 virtual std::vector<const ModuleSnapshot*> Modules() const = 0; |
145 | 154 |
146 //! \brief Returns ThreadSnapshot objects reflecting the threads (lightweight | 155 //! \brief Returns ThreadSnapshot objects reflecting the threads (lightweight |
147 //! processes) existing in the snapshot process at the time of the | 156 //! processes) existing in the snapshot process at the time of the |
(...skipping 10 matching lines...) Expand all Loading... | |
158 //! \return An ExceptionSnapshot object. The caller does not take ownership of | 167 //! \return An ExceptionSnapshot object. The caller does not take ownership of |
159 //! this object, it is scoped to the lifetime of the ProcessSnapshot | 168 //! this object, it is scoped to the lifetime of the ProcessSnapshot |
160 //! object that it was obtained from. If the snapshot is not a result of | 169 //! object that it was obtained from. If the snapshot is not a result of |
161 //! an exception, returns `nullptr`. | 170 //! an exception, returns `nullptr`. |
162 virtual const ExceptionSnapshot* Exception() const = 0; | 171 virtual const ExceptionSnapshot* Exception() const = 0; |
163 }; | 172 }; |
164 | 173 |
165 } // namespace crashpad | 174 } // namespace crashpad |
166 | 175 |
167 #endif // CRASHPAD_SNAPSHOT_PROCESS_SNAPSHOT_H_ | 176 #endif // CRASHPAD_SNAPSHOT_PROCESS_SNAPSHOT_H_ |
OLD | NEW |