Chromium Code Reviews| 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 |