struct CrashpadInfo

Returns the global CrashpadInfo structure.

Adds a custom stream to the minidump.

The memory block referenced by

and

will added to the

minidump as separate stream with type

The memory referred

to by

and

is owned by the caller and must remain valid

while it is in effect for the CrashpadInfo object.

Note that streams will appear in the minidump in the reverse order to

which they are added.

TODO(scottmg) This is currently not supported on Mac.

Parameters

Returns

A handle to the added stream, for use in calling

UpdateUserDataMinidumpStream() if needed.

Replaces the given stream with an updated stream.

Creates a new memory block referencing the given

and

with

type

The memory referred to be

and

is

owned by the caller and must remain valid while it is in effect for the

CrashpadInfo object.

Frees

and returns a new handle to the updated stream.

Parameters

Returns

A handle to the new memory block that references the updated data,

for use in calling this method again if needed.

Sets the bag of extra memory ranges to be included in the snapshot.

Extra memory ranges may exist in

at the time that

this method is called, or they may be added, removed, or modified in

after this method is called.

TODO(scottmg) This is currently only supported on Windows and iOS.

Parameters

Returns

The simple extra memory ranges SimpleAddressRangeBag object.

Sets the simple annotations dictionary.

Simple annotations set on a CrashpadInfo structure are interpreted by

Crashpad as module-level annotations.

Annotations may exist in

at the time that this

method is called, or they may be added, removed, or modified in

after this method is called.

Parameters

Returns

The simple annotations dictionary.

Sets the annotations list.

Unlike the

structure, the

can

typed data and it is not limited to a dictionary form. Annotations are

interpreted by Crashpad as module-level annotations.

Annotations may exist in

at the time that this method is called,

or they may be added, removed, or modified in

after this method is

called.

Parameters

Returns

The annotations list.

Enables or disables Crashpad handler processing.

When handling an exception, the Crashpad handler will scan all modules in

a process. The first one that has a CrashpadInfo structure populated with

a value other than TriState::kUnset for this field will dictate whether

the handler is functional or not. If all modules with a CrashpadInfo

structure specify TriState::kUnset, the handler will be enabled. If

disabled, the Crashpad handler will still run and receive exceptions, but

will not take any action on an exception on its own behalf, except for the

action necessary to determine that it has been disabled.

The Crashpad handler should not normally be disabled. More commonly, it is

appropriate to disable crash report upload by calling

Settings::SetUploadsEnabled().

Enables or disables Crashpad forwarding of exceptions to the

system’s crash reporter.

When handling an exception, the Crashpad handler will scan all modules in

a process. The first one that has a CrashpadInfo structure populated with

a value other than TriState::kUnset for this field will dictate whether

the exception is forwarded to the system’s crash reporter. If all modules

with a CrashpadInfo structure specify TriState::kUnset, forwarding will be

enabled. Unless disabled, forwarding may still occur if the Crashpad

handler is disabled by SetCrashpadHandlerState(). Even when forwarding is

enabled, the Crashpad handler may choose not to forward all exceptions to

the system’s crash reporter in cases where it has reason to believe that

the system’s crash reporter would not normally have handled the exception

in Crashpad’s absence.

Enables or disables Crashpad capturing indirectly referenced memory

in the minidump.

When handling an exception, the Crashpad handler will scan all modules in

a process. The first one that has a CrashpadInfo structure populated with

a value other than TriState::kUnset for this field will dictate whether

the extra memory is captured.

This causes Crashpad to include pages of data referenced by locals or

other stack memory. Turning this on can increase the size of the minidump

significantly.

Parameters