Chromium Code Reviews
chromiumcodereview-hr@appspot.gserviceaccount.com (chromiumcodereview-hr) | Please choose your nickname with Settings | Help | Chromium Project | Gerrit Changes | Sign out
(52)

Side by Side Diff: third_party/crashpad/crashpad/snapshot/module_snapshot.h

Issue 2478633002: Update Crashpad to b47bf6c250c6b825dee1c5fbad9152c2c962e828 (Closed)
Patch Set: mac comment 2 Created 4 years, 1 month ago
Use n/p to move between diff chunks; N/P to move between comments. Draft comments are only viewable by you.
Jump to:
View unified diff | Download patch
OLDNEW
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 147 matching lines...) Expand 10 before | Expand all | Expand 10 after
158 //! \sa UUIDAndAge() 158 //! \sa UUIDAndAge()
159 virtual std::string DebugFileName() const = 0; 159 virtual std::string DebugFileName() const = 0;
160 160
161 //! \brief Returns string annotations recorded in the module. 161 //! \brief Returns string annotations recorded in the module.
162 //! 162 //!
163 //! This method retrieves annotations recorded in a module. These annotations 163 //! This method retrieves annotations recorded in a module. These annotations
164 //! are intended for diagnostic use, including crash analysis. A module may 164 //! are intended for diagnostic use, including crash analysis. A module may
165 //! contain multiple annotations, so they are returned in a vector. 165 //! contain multiple annotations, so they are returned in a vector.
166 //! 166 //!
167 //! For Mac OS X snapshots, these annotations are found by interpreting the 167 //! For Mac OS X snapshots, these annotations are found by interpreting the
168 //! module’s `__DATA, __crash_info` section as `crashreporter_annotations_t`. 168 //! module’s `__DATA,__crash_info` section as `crashreporter_annotations_t`.
169 //! System libraries using the crash reporter client interface may reference 169 //! System libraries using the crash reporter client interface may reference
170 //! annotations in this structure. Additional annotations messages may be 170 //! annotations in this structure. Additional annotations messages may be
171 //! found in other locations, which may be module-specific. The dynamic linker 171 //! found in other locations, which may be module-specific. The dynamic linker
172 //! (`dyld`) can provide an annotation at its `_error_string` symbol. 172 //! (`dyld`) can provide an annotation at its `_error_string` symbol.
173 //! 173 //!
174 //! The annotations returned by this method do not duplicate those returned by 174 //! The annotations returned by this method do not duplicate those returned by
175 //! AnnotationsSimpleMap(). 175 //! AnnotationsSimpleMap().
176 virtual std::vector<std::string> AnnotationsVector() const = 0; 176 virtual std::vector<std::string> AnnotationsVector() const = 0;
177 177
178 //! \brief Returns key-value string annotations recorded in the module. 178 //! \brief Returns key-value string annotations recorded in the module.
179 //! 179 //!
180 //! This method retrieves annotations recorded in a module. These annotations 180 //! This method retrieves annotations recorded in a module. These annotations
181 //! are intended for diagnostic use, including crash analysis. “Simple 181 //! are intended for diagnostic use, including crash analysis. “Simple
182 //! annotations” are structured as a sequence of key-value pairs, where all 182 //! annotations” are structured as a sequence of key-value pairs, where all
183 //! keys and values are strings. These are referred to in Chrome as “crash 183 //! keys and values are strings. These are referred to in Chrome as “crash
184 //! keys.” 184 //! keys.”
185 //! 185 //!
186 //! For Mac OS X snapshots, these annotations are found by interpreting the 186 //! For Mac OS X snapshots, these annotations are found by interpreting the
187 //! `__DATA, __crashpad_info` section as `CrashpadInfo`. Clients can use the 187 //! `__DATA,crashpad_info` section as `CrashpadInfo`. Clients can use the
188 //! Crashpad client interface to store annotations in this structure. Most 188 //! Crashpad client interface to store annotations in this structure. Most
189 //! annotations under the client’s direct control will be retrievable by this 189 //! annotations under the client’s direct control will be retrievable by this
190 //! method. For clients such as Chrome, this includes the process type. 190 //! method. For clients such as Chrome, this includes the process type.
191 //! 191 //!
192 //! The annotations returned by this method do not duplicate those returned by 192 //! The annotations returned by this method do not duplicate those returned by
193 //! AnnotationsVector(). Additional annotations related to the process, 193 //! AnnotationsVector(). Additional annotations related to the process,
194 //! system, or snapshot producer may be obtained by calling 194 //! system, or snapshot producer may be obtained by calling
195 //! ProcessSnapshot::AnnotationsSimpleMap(). 195 //! ProcessSnapshot::AnnotationsSimpleMap().
196 virtual std::map<std::string, std::string> AnnotationsSimpleMap() const = 0; 196 virtual std::map<std::string, std::string> AnnotationsSimpleMap() const = 0;
197 197
198 //! \brief Returns a set of extra memory ranges specified in the module as 198 //! \brief Returns a set of extra memory ranges specified in the module as
199 //! being desirable to include in the crash dump. 199 //! being desirable to include in the crash dump.
200 virtual std::set<CheckedRange<uint64_t>> ExtraMemoryRanges() const = 0; 200 virtual std::set<CheckedRange<uint64_t>> ExtraMemoryRanges() const = 0;
201 201
202 //! \brief Returns a list of custom minidump stream specified in the module to 202 //! \brief Returns a list of custom minidump stream specified in the module to
203 //! be included in the crash dump. 203 //! be included in the crash dump.
204 //! 204 //!
205 //! \return The caller does not take ownership of the returned objects, they 205 //! \return The caller does not take ownership of the returned objects, they
206 //! are scoped to the lifetime of the ModuleSnapshot object that they were 206 //! are scoped to the lifetime of the ModuleSnapshot object that they were
207 //! obtained from. 207 //! obtained from.
208 virtual std::vector<const UserMinidumpStream*> CustomMinidumpStreams() 208 virtual std::vector<const UserMinidumpStream*> CustomMinidumpStreams()
209 const = 0; 209 const = 0;
210 }; 210 };
211 211
212 } // namespace crashpad 212 } // namespace crashpad
213 213
214 #endif // CRASHPAD_SNAPSHOT_MODULE_SNAPSHOT_H_ 214 #endif // CRASHPAD_SNAPSHOT_MODULE_SNAPSHOT_H_
OLDNEW

Powered by Google App Engine
This is Rietveld 408576698