Crashpad
|
A ProcessSnapshot based on a minidump file. More...
#include "snapshot/minidump/process_snapshot_minidump.h"
Public Member Functions | |
bool | Initialize (FileReaderInterface *file_reader) |
Initializes the object. More... | |
crashpad::ProcessID | ProcessID () const override |
Returns the snapshot process’ process ID. | |
crashpad::ProcessID | ParentProcessID () const override |
Returns the snapshot process’ parent process’ process ID. | |
void | SnapshotTime (timeval *snapshot_time) const override |
Returns the time that the snapshot was taken in snapshot_time. More... | |
void | ProcessStartTime (timeval *start_time) const override |
Returns the time that the snapshot process was started in start_time. More... | |
void | ProcessCPUTimes (timeval *user_time, timeval *system_time) const override |
Returns the snapshot process’ CPU usage times in user_time and system_time. More... | |
void | ReportID (UUID *report_id) const override |
Returns a UUID identifying the event that the snapshot describes. More... | |
void | ClientID (UUID *client_id) const override |
Returns a UUID identifying the client that the snapshot represents. More... | |
const std::map< std::string, std::string > & | AnnotationsSimpleMap () const override |
Returns key-value string annotations recorded for the process, system, or snapshot producer. More... | |
const SystemSnapshot * | System () const override |
Returns a SystemSnapshot reflecting the characteristics of the system that ran the snapshot process at the time of the snapshot. More... | |
std::vector< const ThreadSnapshot * > | Threads () const override |
Returns ThreadSnapshot objects reflecting the threads (lightweight processes) existing in the snapshot process at the time of the snapshot. More... | |
std::vector< const ModuleSnapshot * > | Modules () const override |
Returns ModuleSnapshot objects reflecting the code modules (binary images) loaded into the snapshot process at the time of the snapshot. More... | |
std::vector< UnloadedModuleSnapshot > | UnloadedModules () const override |
Returns UnloadedModuleSnapshot objects reflecting the code modules the were recorded as unloaded at the time of the snapshot. More... | |
const ExceptionSnapshot * | Exception () const override |
Returns an ExceptionSnapshot reflecting the exception that the snapshot process sustained to trigger the snapshot being taken. More... | |
std::vector< const MemoryMapRegionSnapshot * > | MemoryMap () const override |
Returns MemoryMapRegionSnapshot objects reflecting the regions of the memory map in the snapshot process at the time of the snapshot. More... | |
std::vector< HandleSnapshot > | Handles () const override |
Returns HandleSnapshot objects reflecting the open handles in the snapshot process at the time of the snapshot. More... | |
std::vector< const MemorySnapshot * > | ExtraMemory () const override |
Returns a vector of additional memory blocks that should be included in a minidump. More... | |
const ProcessMemory * | Memory () const override |
Returns a ProcessMemory object that allows accessing the process' memory directly. More... | |
std::vector< const MinidumpStream * > | CustomMinidumpStreams () const |
Returns a list of custom minidump streams. This routine is the equivalent of ModuleSnapshot::CustomMinidumpStreams(), except that in a minidump it is impossible to associate a custom stream to a specific module. More... | |
A ProcessSnapshot based on a minidump file.
|
overridevirtual |
Returns key-value string annotations recorded for the process, system, or snapshot producer.
This method retrieves annotations recorded for a process. These annotations are intended for diagnostic use, including crash analysis. “Simple annotations” are structured as a sequence of key-value pairs, where all keys and values are strings. These are referred to in Chrome as “crash keys.”
Annotations stored here may reflect the process, system, or snapshot producer. Most annotations not under the client’s direct control will be retrievable by this method. For clients such as Chrome, this includes the product name and version.
Additional per-module annotations may be obtained by calling ModuleSnapshot::AnnotationsSimpleMap().
Implements crashpad::ProcessSnapshot.
|
overridevirtual |
Returns a UUID identifying the client that the snapshot represents.
Client identification is within the scope of the application, but it is expected that the identifier will be unique for an instance of Crashpad monitoring an application or set of applications for a user. The identifier shall remain stable over time.
If no identifier is available, this field will contain zeroes.
Implements crashpad::ProcessSnapshot.
std::vector< const MinidumpStream * > crashpad::ProcessSnapshotMinidump::CustomMinidumpStreams | ( | ) | const |
Returns a list of custom minidump streams. This routine is the equivalent of ModuleSnapshot::CustomMinidumpStreams(), except that in a minidump it is impossible to associate a custom stream to a specific module.
|
overridevirtual |
Returns an ExceptionSnapshot reflecting the exception that the snapshot process sustained to trigger the snapshot being taken.
nullptr
. Implements crashpad::ProcessSnapshot.
|
overridevirtual |
Returns a vector of additional memory blocks that should be included in a minidump.
Implements crashpad::ProcessSnapshot.
|
overridevirtual |
Returns HandleSnapshot objects reflecting the open handles in the snapshot process at the time of the snapshot.
Implements crashpad::ProcessSnapshot.
bool crashpad::ProcessSnapshotMinidump::Initialize | ( | FileReaderInterface * | file_reader | ) |
Initializes the object.
[in] | file_reader | A file reader corresponding to a minidump file. The file reader must support seeking. |
true
if the snapshot could be created, false
otherwise with an appropriate message logged.
|
overridevirtual |
Returns a ProcessMemory object that allows accessing the process' memory directly.
Implements crashpad::ProcessSnapshot.
|
overridevirtual |
Returns MemoryMapRegionSnapshot objects reflecting the regions of the memory map in the snapshot process at the time of the snapshot.
Implements crashpad::ProcessSnapshot.
|
overridevirtual |
Returns ModuleSnapshot objects reflecting the code modules (binary images) loaded into the snapshot process at the time of the snapshot.
Implements crashpad::ProcessSnapshot.
|
overridevirtual |
Returns the snapshot process’ CPU usage times in user_time and system_time.
[out] | user_time | The time that the process has spent executing in user mode. |
[out] | system_time | The time that the process has spent executing in system (kernel) mode. |
Implements crashpad::ProcessSnapshot.
|
overridevirtual |
Returns the time that the snapshot process was started in start_time.
Normally, process uptime in wall clock time can be computed as SnapshotTime() − ProcessStartTime(), but this cannot be guaranteed in cases where the real-time clock has been set during the snapshot process’ lifetime.
[out] | start_time | The time that the process was started. |
Implements crashpad::ProcessSnapshot.
|
overridevirtual |
Returns a UUID identifying the event that the snapshot describes.
This provides a stable identifier for a crash even as the report is converted to different formats, provided that all formats support storing a crash report ID. When a report is originally created, a report ID should be assigned. From that point on, any operations involving the same report should preserve the same report ID.
If no identifier is available, this field will contain zeroes.
Implements crashpad::ProcessSnapshot.
|
overridevirtual |
Returns the time that the snapshot was taken in snapshot_time.
[out] | snapshot_time | The time that the snapshot was taken. This is distinct from the time that a ProcessSnapshot object was created or initialized, although it may be that time for ProcessSnapshot objects representing live or recently-crashed process state. |
Implements crashpad::ProcessSnapshot.
|
overridevirtual |
Returns a SystemSnapshot reflecting the characteristics of the system that ran the snapshot process at the time of the snapshot.
Implements crashpad::ProcessSnapshot.
|
overridevirtual |
Returns ThreadSnapshot objects reflecting the threads (lightweight processes) existing in the snapshot process at the time of the snapshot.
Implements crashpad::ProcessSnapshot.
|
overridevirtual |
Returns UnloadedModuleSnapshot objects reflecting the code modules the were recorded as unloaded at the time of the snapshot.
Implements crashpad::ProcessSnapshot.