crashpad::MinidumpCrashpadInfo Struct Reference

Additional Crashpad-specific information carried within a minidump file. More...

#include "minidump/minidump_extensions.h"

Public Attributes
uint32_t	version
	The structure’s version number. More...
UUID	report_id
	A UUID identifying an individual crash report. More...
UUID	client_id
	A UUID identifying the client that crashed. More...
MINIDUMP_LOCATION_DESCRIPTOR	simple_annotations
	A MinidumpSimpleStringDictionary pointing to strings interpreted as key-value pairs. More...
MINIDUMP_LOCATION_DESCRIPTOR	module_list
	A pointer to a MinidumpModuleCrashpadInfoList structure. More...

Static Public Attributes
static constexpr uint32_t	kVersion = 1
	The structure’s currently-defined version number. More...

Detailed Description

Additional Crashpad-specific information carried within a minidump file.

This structure is versioned. When changing this structure, leave the existing structure intact so that earlier parsers will be able to understand the fields they are aware of, and make additions at the end of the structure. Revise kVersion and document each field’s validity based on version, so that newer parsers will be able to determine whether the added fields are valid or not.

Member Data Documentation

client_id

UUID crashpad::MinidumpCrashpadInfo::client_id

A UUID identifying the client that crashed.

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.

This field is present when version is at least 1.

kVersion

constexpr uint32_t crashpad::MinidumpCrashpadInfo::kVersion = 1

staticconstexpr

The structure’s currently-defined version number.

See also

version

module_list

MINIDUMP_LOCATION_DESCRIPTOR crashpad::MinidumpCrashpadInfo::module_list

A pointer to a MinidumpModuleCrashpadInfoList structure.

This field is present when version is at least 1.

report_id

UUID crashpad::MinidumpCrashpadInfo::report_id

A UUID identifying an individual crash report.

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.

If no identifier is available, this field will contain zeroes.

This field is present when version is at least 1.

simple_annotations

MINIDUMP_LOCATION_DESCRIPTOR crashpad::MinidumpCrashpadInfo::simple_annotations

A MinidumpSimpleStringDictionary pointing to strings interpreted as key-value pairs.

These key-value pairs correspond to ProcessSnapshot::AnnotationsSimpleMap().

This field is present when version is at least 1.

version

uint32_t crashpad::MinidumpCrashpadInfo::version

The structure’s version number.

Readers can use this field to determine which other fields in the structure are valid. Upon encountering a value greater than kVersion, a reader should assume that the structure’s layout is compatible with the structure defined as having value kVersion.

Writers may produce values less than kVersion in this field if there is no need for any fields present in later versions.

---

The documentation for this struct was generated from the following files:

• minidump/minidump_extensions.h
• minidump/minidump_extensions.cc