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