crashpad::internal::MemorySnapshotGeneric Class Reference

A MemorySnapshot of a memory region in a process on the running system. Works on multiple platforms by using a platform-specific ProcessMemory object. More...

#include "snapshot/memory_snapshot_generic.h"

Inheritance diagram for crashpad::internal::MemorySnapshotGeneric:

Collaboration diagram for crashpad::internal::MemorySnapshotGeneric:

Public Member Functions
	MemorySnapshotGeneric (const MemorySnapshotGeneric &)=delete
MemorySnapshotGeneric &	operator= (const MemorySnapshotGeneric &)=delete
void	Initialize (const ProcessMemory *process_memory, VMAddress address, VMSize size)
	Initializes the object.
uint64_t	Address () const override
	The base address of the memory snapshot in the snapshot process’ address space.
size_t	Size () const override
	The size of the memory snapshot.
bool	Read (Delegate *delegate) const override
	Calls Delegate::MemorySnapshotDelegateRead(), providing it with the memory snapshot’s data.
const MemorySnapshot *	MergeWithOtherSnapshot (const MemorySnapshot *other) const override
	Creates a new MemorySnapshot based on merging this one with other.

Friends
template<class T>
const MemorySnapshot *	MergeWithOtherSnapshotImpl (const T *self, const MemorySnapshot *other)

Detailed Description

A MemorySnapshot of a memory region in a process on the running system. Works on multiple platforms by using a platform-specific ProcessMemory object.

Member Function Documentation

Address()

uint64_t crashpad::internal::MemorySnapshotGeneric::Address ( ) const

inlineoverridevirtual

The base address of the memory snapshot in the snapshot process’ address space.

Implements crashpad::MemorySnapshot.

Initialize()

void crashpad::internal::MemorySnapshotGeneric::Initialize ( const ProcessMemory * process_memory, VMAddress address, VMSize size )

inline

Initializes the object.

Memory is read lazily. No attempt is made to read the memory snapshot data until Read() is called, and the memory snapshot data is discared when Read() returns.

Parameters

[in]	process_memory	A reader for the process being snapshotted.
[in]	address	The base address of the memory region to snapshot, in the snapshot process’ address space.
[in]	size	The size of the memory region to snapshot.

MergeWithOtherSnapshot()

const MemorySnapshot * crashpad::internal::MemorySnapshotGeneric::MergeWithOtherSnapshot ( const MemorySnapshot * other ) const

inlineoverridevirtual

Creates a new MemorySnapshot based on merging this one with other.

The ranges described by the two snapshots must either overlap or abut, and must be of the same concrete type.

Returns

A newly allocated MemorySnapshot representing the merged range, or nullptr with an error logged.

Implements crashpad::MemorySnapshot.

Read()

bool crashpad::internal::MemorySnapshotGeneric::Read ( Delegate * delegate ) const

inlineoverridevirtual

Calls Delegate::MemorySnapshotDelegateRead(), providing it with the memory snapshot’s data.

Implementations do not necessarily read the memory snapshot data prior to this method being called. Memory snapshot data may be loaded lazily and may be discarded after being passed to the delegate. This provides clean memory management without burdening a snapshot implementation with the requirement that it track all memory region data simultaneously.

Returns

false on failure, otherwise, the return value of Delegate::MemorySnapshotDelegateRead(), which should be true on success and false on failure.

Implements crashpad::MemorySnapshot.

Size()

size_t crashpad::internal::MemorySnapshotGeneric::Size ( ) const

inlineoverridevirtual

The size of the memory snapshot.

Implements crashpad::MemorySnapshot.

---

The documentation for this class was generated from the following file:

• snapshot/memory_snapshot_generic.h