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 100 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
111 | 111 |
112 //! \brief Returns the module’s UUID in the \a uuid parameter, and the age of | 112 //! \brief Returns the module’s UUID in the \a uuid parameter, and the age of |
113 //! that UUID in \a age. | 113 //! that UUID in \a age. |
114 //! | 114 //! |
115 //! A snapshot module’s UUID is taken directly from the module itself. If the | 115 //! A snapshot module’s UUID is taken directly from the module itself. If the |
116 //! module does not have a UUID, the \a uuid parameter will be zeroed out. | 116 //! module does not have a UUID, the \a uuid parameter will be zeroed out. |
117 //! | 117 //! |
118 //! \a age is the number of times the UUID has been reused. This occurs on | 118 //! \a age is the number of times the UUID has been reused. This occurs on |
119 //! Windows with incremental linking. On other platforms \a age will always be | 119 //! Windows with incremental linking. On other platforms \a age will always be |
120 //! `0`. | 120 //! `0`. |
| 121 //! |
| 122 //! \sa DebugFileName() |
121 virtual void UUIDAndAge(crashpad::UUID* uuid, uint32_t* age) const = 0; | 123 virtual void UUIDAndAge(crashpad::UUID* uuid, uint32_t* age) const = 0; |
122 | 124 |
| 125 //! \brief Returns the module’s debug file info name. |
| 126 //! |
| 127 //! On Windows, this references the PDB file, which contains symbol |
| 128 //! information held separately from the module itself. On other platforms, |
| 129 //! this is normally just be the basename of the module, because the debug |
| 130 //! info file’s name is not relevant even in split-debug scenarios. |
| 131 //! |
| 132 //! \sa UUIDAndAge() |
| 133 virtual std::string DebugFileName() const = 0; |
| 134 |
123 //! \brief Returns string annotations recorded in the module. | 135 //! \brief Returns string annotations recorded in the module. |
124 //! | 136 //! |
125 //! This method retrieves annotations recorded in a module. These annotations | 137 //! This method retrieves annotations recorded in a module. These annotations |
126 //! are intended for diagnostic use, including crash analysis. A module may | 138 //! are intended for diagnostic use, including crash analysis. A module may |
127 //! contain multiple annotations, so they are returned in a vector. | 139 //! contain multiple annotations, so they are returned in a vector. |
128 //! | 140 //! |
129 //! For Mac OS X snapshots, these annotations are found by interpreting the | 141 //! For Mac OS X snapshots, these annotations are found by interpreting the |
130 //! module’s `__DATA, __crash_info` section as `crashreporter_annotations_t`. | 142 //! module’s `__DATA, __crash_info` section as `crashreporter_annotations_t`. |
131 //! System libraries using the crash reporter client interface may reference | 143 //! System libraries using the crash reporter client interface may reference |
132 //! annotations in this structure. Additional annotations messages may be | 144 //! annotations in this structure. Additional annotations messages may be |
(...skipping 21 matching lines...) Expand all Loading... |
154 //! The annotations returned by this method do not duplicate those returned by | 166 //! The annotations returned by this method do not duplicate those returned by |
155 //! AnnotationsVector(). Additional annotations related to the process, | 167 //! AnnotationsVector(). Additional annotations related to the process, |
156 //! system, or snapshot producer may be obtained by calling | 168 //! system, or snapshot producer may be obtained by calling |
157 //! ProcessSnapshot::AnnotationsSimpleMap(). | 169 //! ProcessSnapshot::AnnotationsSimpleMap(). |
158 virtual std::map<std::string, std::string> AnnotationsSimpleMap() const = 0; | 170 virtual std::map<std::string, std::string> AnnotationsSimpleMap() const = 0; |
159 }; | 171 }; |
160 | 172 |
161 } // namespace crashpad | 173 } // namespace crashpad |
162 | 174 |
163 #endif // CRASHPAD_SNAPSHOT_MODULE_SNAPSHOT_H_ | 175 #endif // CRASHPAD_SNAPSHOT_MODULE_SNAPSHOT_H_ |
OLD | NEW |