The internal namespace, not for public use. More...

Classes
class	CaptureMemory

class	CaptureMemoryDelegateWin

class	CheckedAddressRangeGeneric
	Ensures that a range, composed of a base and a size, does not overflow the pointer type of the process it describes a range in. More...

class	ClientData
	The context data for registered threadpool waits. More...

union	CPUContextUnion

class	CpuidReader
	Reads x86-family CPU information by calling `cpuid`. More...

class	ExceptionSnapshotFuchsia
	An ExceptionSnapshot of an exception sustained by a process on a Fuchsia system. More...

class	ExceptionSnapshotIOS
	An ExceptionSnapshot of an exception sustained by a running (or crashed) process on an iOS system. More...

class	ExceptionSnapshotLinux
	An ExceptionSnapshot of an signal received by a running (or crashed) process on a Linux system. More...

class	ExceptionSnapshotMac
	An ExceptionSnapshot of an exception sustained by a running (or crashed) process on a macOS system. More...

class	ExceptionSnapshotMinidump
	An ExceptionSnapshot based on a minidump file. More...

class	ExceptionSnapshotWin

struct	LocalAllocTraits

class	MachOImageSymbolTableReaderInitializer
	The internal implementation for MachOImageSymbolTableReader. More...

class	MemoryMapRegionSnapshotFuchsia

class	MemoryMapRegionSnapshotMinidump

class	MemoryMapRegionSnapshotWin

class	MemorySnapshotGeneric
	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...

class	MemorySnapshotIOS
	A MemorySnapshot of a memory region. More...

class	MemorySnapshotMinidump

class	MemorySnapshotSanitized
	A MemorySnapshot which wraps and filters sensitive information from another MemorySnapshot. More...

class	MinidumpContextConverter

class	MinidumpModuleCodeViewRecordPDBLinkWriter
	The base class for writers of CodeView records that serve as links to `.pdb` (program database) files. More...

class	MinidumpRVAListWriter
	The writer for a MinidumpRVAList object in a minidump file, containing a list of RVA pointers. More...

class	MinidumpStreamWriter
	The base class for all second-level objects (“streams”) in a minidump file. More...

class	MinidumpStringListWriter
	The writer for a MinidumpRVAList object in a minidump file, containing a list of MinidumpStringWriterType objects. More...

class	MinidumpStringWriter
	Writes a variable-length string to a minidump file in accordance with the string type’s characteristics. More...

class	MinidumpUTF16StringWriter
	Writes a variable-length UTF-16-encoded MINIDUMP_STRING to a minidump file. More...

class	MinidumpUTF8StringWriter
	Writes a variable-length UTF-8-encoded MinidumpUTF8String to a minidump file. More...

class	MinidumpWritable
	The base class for all content that might be written to a minidump file. More...

class	MinidumpWriterUtil
	A collection of utility functions used by the MinidumpWritable family of classes. More...

class	ModuleSnapshotElf
	A ModuleSnapshot of a code module (binary image) loaded into a running (or crashed) process on a system that uses ELF modules. More...

class	ModuleSnapshotIOS
	A ModuleSnapshot of a code module (binary image) loaded into a running (or crashed) process on an iOS system. More...

class	ModuleSnapshotMac
	A ModuleSnapshot of a code module (binary image) loaded into a running (or crashed) process on a macOS system. More...

class	ModuleSnapshotMinidump
	A ModuleSnapshot based on a module in a minidump file. More...

class	ModuleSnapshotSanitized
	A ModuleSnapshot which wraps and filters sensitive information from another ModuleSnapshot. More...

class	ModuleSnapshotWin
	A ModuleSnapshot of a code module (binary image) loaded into a running (or crashed) process on a Windows system. More...

class	PipeServiceContext
	Context information for the named pipe handler threads. More...

class	ReadExactlyInternal
	The internal implementation of ReadFileExactly() and its wrappers. More...

struct	ScopedDIRCloseTraits

struct	ScopedFileHANDLECloseTraits

struct	ScopedKernelHANDLECloseTraits

struct	ScopedLockedFileHandleTraits

struct	ScopedSearchHANDLECloseTraits

struct	Siginfo

struct	SignalStack

struct	Sigset

struct	Sigset< Traits, typename std::enable_if< std::is_base_of< Traits32, Traits >::value >::type >

struct	Sigset< Traits, typename std::enable_if< std::is_base_of< Traits64, Traits >::value >::type >

union	Sigval

class	SystemSnapshotFuchsia
	A SystemSnapshot of the running system, when the system runs Fuchsia. More...

class	SystemSnapshotIOS
	A SystemSnapshot of the running system, when the system runs iOS. More...

class	SystemSnapshotLinux
	A SystemSnapshot of the running system, when the system runs Linux. More...

class	SystemSnapshotMac
	A SystemSnapshot of the running system, when the system runs macOS. More...

class	SystemSnapshotMinidump
	A SystemSnapshot based on a minidump file. More...

class	SystemSnapshotWin
	A SystemSnapshot of the running system, when the system runs Windows. More...

class	ThreadSnapshotFuchsia
	A ThreadSnapshot of a thread on a Fuchsia system. More...

class	ThreadSnapshotIOS
	A ThreadSnapshot of a thread on an iOS system. More...

class	ThreadSnapshotLinux
	A ThreadSnapshot of a thread on a Linux system. More...

class	ThreadSnapshotMac
	A ThreadSnapshot of a thread in a running (or crashed) process on a macOS system. More...

class	ThreadSnapshotMinidump
	A ThreadSnapshot based on a thread in a minidump file. More...

class	ThreadSnapshotSanitized
	A ThreadSnapshot which wraps and filters sensitive information from another ThreadSnapshot. More...

class	ThreadSnapshotWin
	A ThreadSnapshot of a thread in a running (or crashed) process on a Windows system. More...

class	UniversalMachExcServerImpl

struct	UserDataMinidumpStreamListEntry
	A linked list of blocks representing custom streams in the minidump, with addresses (and size) stored as uint64_t to simplify reading from the handler process. More...

class	WorkerThreadImpl

class	WriteAllInternal
	The internal implementation of WriteFile() and its wrappers. More...

Functions
void *	Dlsym (void handle, const char symbol)
	Provide a wrapper for `dlsym`. More...

std::string	MinidumpMiscInfoDebugBuildString ()
	Returns the string to set in MINIDUMP_MISC_INFO_4::DbgBldStr. More...

void	InitializeCPUContextX86_64_NoFloatingPoint (const zx_thread_state_general_regs_t &thread_context, CPUContextX86_64 *context)
	Initializes a CPUContextX86_64 structure from native context structures on Fuchsia. More...

void	InitializeCPUContextARM64 (const zx_thread_state_general_regs_t &thread_context, const zx_thread_state_vector_regs_t &vector_context, CPUContextARM64 *context)
	Initializes a CPUContextARM64 structure from native context structures on Fuchsia. More...

void	InitializeCPUContextX86_NoFloatingPoint (const SignalThreadContext32 &thread_context, CPUContextX86 *context)
	Initializes GPR and debug state in a CPUContextX86 from a native signal context structure on Linux. More...

void	InitializeCPUContextX86_64_NoFloatingPoint (const SignalThreadContext64 &thread_context, CPUContextX86_64 *context)
	Initializes GPR and debug state in a CPUContextX86_64 from a native signal context structure on Linux. More...

void	InitializeCPUContextARM (const ThreadContext::t32_t &thread_context, const FloatContext::f32_t &float_context, CPUContextARM *context)
	Initializes a CPUContextARM structure from native context structures on Linux. More...

void	InitializeCPUContextARM_NoFloatingPoint (const SignalThreadContext32 &thread_context, CPUContextARM *context)
	Initializes GPR state in a CPUContextARM from a native signal context structure on Linux. More...

void	InitializeCPUContextARM64 (const ThreadContext::t64_t &thread_context, const FloatContext::f64_t &float_context, CPUContextARM64 *context)
	Initializes a CPUContextARM64 structure from native context structures on Linux. More...

void	InitializeCPUContextARM64_NoFloatingPoint (const ThreadContext::t64_t &thread_context, CPUContextARM64 *context)
	Initializes GPR state in a CPUContextARM64 from a native context structure on Linux. More...

void	InitializeCPUContextARM64_OnlyFPSIMD (const SignalFPSIMDContext &float_context, CPUContextARM64 *context)
	Initializes FPSIMD state in a CPUContextARM64 from a native fpsimd signal context structure on Linux. More...

template<typename Traits >
void	InitializeCPUContextMIPS (const typename Traits::SignalThreadContext &thread_context, const typename Traits::SignalFloatContext &float_context, typename Traits::CPUContext *context)
	Initializes a CPUContextMIPS structure from native context structures on Linux. More...

void	InitializeCPUContextX86 (CPUContextX86 context, thread_state_flavor_t flavor, ConstThreadState state, mach_msg_type_number_t state_count, const x86_thread_state32_t x86_thread_state32, const x86_float_state32_t x86_float_state32, const x86_debug_state32_t x86_debug_state32)
	Initializes a CPUContextX86 structure from native context structures on macOS. More...

void	InitializeCPUContextX86_64 (CPUContextX86_64 context, thread_state_flavor_t flavor, ConstThreadState state, mach_msg_type_number_t state_count, const x86_thread_state64_t x86_thread_state64, const x86_float_state64_t x86_float_state64, const x86_debug_state64_t x86_debug_state64)
	Initializes a CPUContextX86_64 structure from native context structures on macOS. More...

bool	ReadMinidumpAnnotationList (FileReaderInterface file_reader, const MINIDUMP_LOCATION_DESCRIPTOR &location, std::vector< AnnotationSnapshot > list)
	Reads a MinidumpAnnotationList from a minidump file at location in file_reader, and returns it in list. More...

bool	ReadMinidumpSimpleStringDictionary (FileReaderInterface file_reader, const MINIDUMP_LOCATION_DESCRIPTOR &location, std::map< std::string, std::string > dictionary)
	Reads a MinidumpSimpleStringDictionary from a minidump file location in file_reader, and returns it in dictionary. More...

bool	ReadMinidumpStringList (FileReaderInterface file_reader, const MINIDUMP_LOCATION_DESCRIPTOR &location, std::vector< std::string > list)
	Reads a list of MinidumpUTF8String objects in a MinidumpRVAList from a minidump file location in file_reader, and returns it in list. More...

bool	ReadMinidumpUTF8String (FileReaderInterface file_reader, RVA rva, std::string string)
	Reads a MinidumpUTF8String from a minidump file at offset rva in file_reader, and returns it in string. More...

bool	ReadMinidumpUTF16String (FileReaderInterface file_reader, RVA rva, base::string16 string)
	Reads a MinidumpUTF16String from a minidump file at offset rva in file_reader, and returns it in string. More...

bool	ReadMinidumpUTF16String (FileReaderInterface file_reader, RVA rva, std::string string)
	Reads a MinidumpUTF16String from a minidump file at offset rva in file_reader, and returns it in string. More...

void	TimeZone (const timeval &snapshot_time, SystemSnapshot::DaylightSavingTimeStatus dst_status, int standard_offset_seconds, int daylight_offset_seconds, std::string standard_name, std::string *daylight_name)
	Returns time zone information from the snapshot system, based on its locale configuration and snapshot_time. More...

FileOperationResult	NativeWriteFile (FileHandle file, const void *buffer, size_t size)
	Writes to a file, retrying when interrupted on POSIX. More...

template<typename ArrayType >
constexpr size_t	ArraySizeHelper () noexcept
	A helper to implement ArraySize.

bool	ReinterpretBytesImpl (const char data, size_t data_size, char dest, size_t dest_size)

FARPROC	GetFunctionInternal (const wchar_t library, const char function, bool required)
	Returns a function pointer to a named function in a library. More...

template<typename FunctionType >
FunctionType *	GetFunction (const wchar_t library, const char function, bool required)
	Returns a function pointer to a named function in a library. More...

Variables
constexpr char	kNativeReadFunctionName [] = "read"
	The name of the native read function used by ReadFile(). More...

constexpr char	kNativeWriteFunctionName [] = "write"
	The name of the native write function used by WriteFile(). More...

Detailed Description

The internal namespace, not for public use.

Function Documentation

◆ Dlsym()

void * crashpad::internal::Dlsym	(	void *	handle,
		const char *	symbol
	)

Provide a wrapper for dlsym.

dlsym on Android KitKat (4.4.*) raises SIGFPE when searching for a non-existent symbol. This wrapper avoids crashing in this circumstance. https://code.google.com/p/android/issues/detail?id=61799

The parameters and return value for this function are the same as for dlsym, but a return value for dlerror may not be set in the event of an error.

◆ GetFunction()

template<typename FunctionType >

FunctionType* crashpad::internal::GetFunction	(	const wchar_t *	library,
		const char *	function,
		bool	required
	)

Returns a function pointer to a named function in a library.

Do not call this directly, use the GET_FUNCTION() or GET_FUNCTION_REQUIRED() macros instead.

This accesses library by calling LoadLibrary() and is subject to the same restrictions as that function. Notably, it can’t be used from a DllMain() entry point.

Parameters

[in]	library	The library to search in.
[in]	function	The function to search for. If a leading `::` is present, it will be stripped.
[in]	required	If `true`, require the function to resolve by `DCHECK`.

Returns: A pointer to the requested function on success. If required is true, triggers a DCHECK assertion on failure, otherwise, nullptr on failure.

◆ GetFunctionInternal()

FARPROC crashpad::internal::GetFunctionInternal	(	const wchar_t *	library,
		const char *	function,
		bool	required
	)

Returns a function pointer to a named function in a library.

Do not call this directly, use the GET_FUNCTION() or GET_FUNCTION_REQUIRED() macros instead.

This accesses library by calling LoadLibrary() and is subject to the same restrictions as that function. Notably, it can’t be used from a DllMain() entry point.

Parameters

[in]	library	The library to search in.
[in]	function	The function to search for. If a leading `::` is present, it will be stripped.
[in]	required	If `true`, require the function to resolve by `DCHECK`.

Returns: A pointer to the requested function on success. If required is true, triggers a DCHECK assertion on failure, otherwise, nullptr on failure.

◆ InitializeCPUContextARM()

void crashpad::internal::InitializeCPUContextARM	(	const ThreadContext::t32_t &	thread_context,
		const FloatContext::f32_t &	float_context,
		CPUContextARM *	context
	)

Initializes a CPUContextARM structure from native context structures on Linux.

Parameters

[in]	thread_context	The native thread context.
[in]	float_context	The native float context.
[out]	context	The CPUContextARM structure to initialize.

◆ InitializeCPUContextARM64() [1/2]

void crashpad::internal::InitializeCPUContextARM64	(	const ThreadContext::t64_t &	thread_context,
		const FloatContext::f64_t &	float_context,
		CPUContextARM64 *	context
	)

Initializes a CPUContextARM64 structure from native context structures on Linux.

Parameters

[in]	thread_context	The native thread context.
[in]	float_context	The native float context.
[out]	context	The CPUContextARM64 structure to initialize.

◆ InitializeCPUContextARM64() [2/2]

void crashpad::internal::InitializeCPUContextARM64	(	const zx_thread_state_general_regs_t &	thread_context,
		const zx_thread_state_vector_regs_t &	vector_context,
		CPUContextARM64 *	context
	)

Initializes a CPUContextARM64 structure from native context structures on Fuchsia.

Parameters

[in]	thread_context	The native thread context.
[in]	vector_context	The native vector context that also contains the floating point registers.
[out]	context	The CPUContextARM64 structure to initialize.

◆ InitializeCPUContextARM64_NoFloatingPoint()

void crashpad::internal::InitializeCPUContextARM64_NoFloatingPoint	(	const ThreadContext::t64_t &	thread_context,
		CPUContextARM64 *	context
	)

Initializes GPR state in a CPUContextARM64 from a native context structure on Linux.

Floating point state is initialized to zero.

Parameters

[in]	thread_context	The native thread context.
[out]	context	The CPUContextARM64 structure to initialize.

◆ InitializeCPUContextARM64_OnlyFPSIMD()

void crashpad::internal::InitializeCPUContextARM64_OnlyFPSIMD	(	const SignalFPSIMDContext &	float_context,
		CPUContextARM64 *	context
	)

Initializes FPSIMD state in a CPUContextARM64 from a native fpsimd signal context structure on Linux.

General purpose registers are not initialized.

Parameters

[in]	float_context	The native fpsimd context.
[out]	context	The CPUContextARM64 structure to initialize.

◆ InitializeCPUContextARM_NoFloatingPoint()

void crashpad::internal::InitializeCPUContextARM_NoFloatingPoint	(	const SignalThreadContext32 &	thread_context,
		CPUContextARM *	context
	)

Initializes GPR state in a CPUContextARM from a native signal context structure on Linux.

Floating point state is initialized to zero.

Parameters

[in]	thread_context	The native thread context.
[out]	context	The CPUContextARM structure to initialize.

◆ InitializeCPUContextMIPS()

template<typename Traits >

void crashpad::internal::InitializeCPUContextMIPS	(	const typename Traits::SignalThreadContext &	thread_context,
		const typename Traits::SignalFloatContext &	float_context,
		typename Traits::CPUContext *	context
	)

Initializes a CPUContextMIPS structure from native context structures on Linux.

This function has template specializations for MIPSEL and MIPS64EL architecture contexts, using ContextTraits32 or ContextTraits64 as template parameter, respectively.

Parameters

[in]	thread_context	The native thread context.
[in]	float_context	The native float context.
[out]	context	The CPUContextMIPS structure to initialize.

◆ InitializeCPUContextX86() [1/3]

void crashpad::internal::InitializeCPUContextX86	(	const SignalThreadContext32 &	thread_context,
		const SignalFloatContext32 &	float_context,
		CPUContextX86 *	context
	)

Initializes a CPUContextX86 structure from native context structures on Linux.

Parameters

[in]	thread_context	The native thread context.
[in]	float_context	The native float context.
[out]	context	The CPUContextX86 structure to initialize.

◆ InitializeCPUContextX86() [2/3]

void crashpad::internal::InitializeCPUContextX86	(	const ThreadContext::t32_t &	thread_context,
		const FloatContext::f32_t &	float_context,
		CPUContextX86 *	context
	)

Initializes a CPUContextX86 structure from native context structures on Linux.

Parameters

[in]	thread_context	The native thread context.
[in]	float_context	The native float context.
[out]	context	The CPUContextX86 structure to initialize.

◆ InitializeCPUContextX86() [3/3]

void crashpad::internal::InitializeCPUContextX86	(	CPUContextX86 *	context,
		thread_state_flavor_t	flavor,
		ConstThreadState	state,
		mach_msg_type_number_t	state_count,
		const x86_thread_state32_t *	x86_thread_state32,
		const x86_float_state32_t *	x86_float_state32,
		const x86_debug_state32_t *	x86_debug_state32
	)

Initializes a CPUContextX86 structure from native context structures on macOS.

flavor, state, and state_count may be supplied by exception handlers in order for the context parameter to be initialized by the thread state received by the exception handler to the extent possible. In that case, whatever thread state specified by these three parameters will supersede x86_thread_state32, x86_float_state32, or x86_debug_state32. If thread state in this format is not available, flavor may be set to THREAD_STATE_NONE, and all of x86_thread_state32, x86_float_state32, and x86_debug_state32 will be honored.

If flavor, state, and state_count are provided but do not contain valid values, a message will be logged and their values will be ignored as though flavor were specified as THREAD_STATE_NONE.

Parameters

[out]	context	The CPUContextX86 structure to initialize.
[in]	flavor	The native thread state flavor of state. This may be `x86_THREAD_STATE32`, `x86_FLOAT_STATE32`, `x86_DEBUG_STATE32`, `x86_THREAD_STATE`, `x86_FLOAT_STATE`, or `x86_DEBUG_STATE`. It may also be `THREAD_STATE_NONE` if state is not supplied (and is `nullptr`).
[in]	state	The native thread state, which may be a casted pointer to `x86_thread_state32_t`, `x86_float_state32_t`, `x86_debug_state32_t`, `x86_thread_state`, `x86_float_state`, or `x86_debug_state`. This parameter may be `nullptr` to not supply this data, in which case flavor must be `THREAD_STATE_NONE`. If a “universal” structure is used, it must carry 32-bit state data of the correct type.
[in]	state_count	The number of `natural_t`-sized (`int`-sized) units in state. This may be 0 if state is `nullptr`.
[in]	x86_thread_state32	The state of the thread’s integer registers.
[in]	x86_float_state32	The state of the thread’s floating-point registers.
[in]	x86_debug_state32	The state of the thread’s debug registers.

◆ InitializeCPUContextX86_64() [1/3]

void crashpad::internal::InitializeCPUContextX86_64	(	const SignalThreadContext64 &	thread_context,
		const SignalFloatContext64 &	float_context,
		CPUContextX86_64 *	context
	)

Initializes a CPUContextX86_64 structure from native context structures on Linux.

Parameters

[in]	thread_context	The native thread context.
[in]	float_context	The native float context.
[out]	context	The CPUContextX86_64 structure to initialize.

◆ InitializeCPUContextX86_64() [2/3]

void crashpad::internal::InitializeCPUContextX86_64	(	const ThreadContext::t64_t &	thread_context,
		const FloatContext::f64_t &	float_context,
		CPUContextX86_64 *	context
	)

Initializes a CPUContextX86_64 structure from native context structures on Linux.

Parameters

[in]	thread_context	The native thread context.
[in]	float_context	The native float context.
[out]	context	The CPUContextX86_64 structure to initialize.

◆ InitializeCPUContextX86_64() [3/3]

void crashpad::internal::InitializeCPUContextX86_64	(	CPUContextX86_64 *	context,
		thread_state_flavor_t	flavor,
		ConstThreadState	state,
		mach_msg_type_number_t	state_count,
		const x86_thread_state64_t *	x86_thread_state64,
		const x86_float_state64_t *	x86_float_state64,
		const x86_debug_state64_t *	x86_debug_state64
	)

Initializes a CPUContextX86_64 structure from native context structures on macOS.

flavor, state, and state_count may be supplied by exception handlers in order for the context parameter to be initialized by the thread state received by the exception handler to the extent possible. In that case, whatever thread state specified by these three parameters will supersede x86_thread_state64, x86_float_state64, or x86_debug_state64. If thread state in this format is not available, flavor may be set to THREAD_STATE_NONE, and all of x86_thread_state64, x86_float_state64, and x86_debug_state64 will be honored.

If flavor, state, and state_count are provided but do not contain valid values, a message will be logged and their values will be ignored as though flavor were specified as THREAD_STATE_NONE.

Parameters

[out]	context	The CPUContextX86_64 structure to initialize.
[in]	flavor	The native thread state flavor of state. This may be `x86_THREAD_STATE64`, `x86_FLOAT_STATE64`, `x86_DEBUG_STATE64`, `x86_THREAD_STATE`, `x86_FLOAT_STATE`, or `x86_DEBUG_STATE`. It may also be `THREAD_STATE_NONE` if state is not supplied (and is `nullptr`).
[in]	state	The native thread state, which may be a casted pointer to `x86_thread_state64_t`, `x86_float_state64_t`, `x86_debug_state64_t`, `x86_thread_state`, `x86_float_state`, or `x86_debug_state`. This parameter may be `nullptr` to not supply this data, in which case flavor must be `THREAD_STATE_NONE`. If a “universal” structure is used, it must carry 64-bit state data of the correct type.
[in]	state_count	The number of `int`-sized units in state. This may be 0 if state is `nullptr`.
[in]	x86_thread_state64	The state of the thread’s integer registers.
[in]	x86_float_state64	The state of the thread’s floating-point registers.
[in]	x86_debug_state64	The state of the thread’s debug registers.

◆ InitializeCPUContextX86_64_NoFloatingPoint() [1/2]

void crashpad::internal::InitializeCPUContextX86_64_NoFloatingPoint	(	const SignalThreadContext64 &	thread_context,
		CPUContextX86_64 *	context
	)

Initializes GPR and debug state in a CPUContextX86_64 from a native signal context structure on Linux.

Floating point state and debug registers are initialized to zero.

Parameters

[in]	thread_context	The native thread context.
[out]	context	The CPUContextX86_64 structure to initialize.

◆ InitializeCPUContextX86_64_NoFloatingPoint() [2/2]

void crashpad::internal::InitializeCPUContextX86_64_NoFloatingPoint	(	const zx_thread_state_general_regs_t &	thread_context,
		CPUContextX86_64 *	context
	)

Initializes a CPUContextX86_64 structure from native context structures on Fuchsia.

Floating point registers are currently initialized to zero. Segment registers are currently initialized to zero.

Parameters

[in]	thread_context	The native thread context.
[out]	context	The CPUContextX86_64 structure to initialize.

◆ InitializeCPUContextX86_NoFloatingPoint()

void crashpad::internal::InitializeCPUContextX86_NoFloatingPoint	(	const SignalThreadContext32 &	thread_context,
		CPUContextX86 *	context
	)

Initializes GPR and debug state in a CPUContextX86 from a native signal context structure on Linux.

Floating point state and debug registers are initialized to zero.

Parameters

[in]	thread_context	The native thread context.
[out]	context	The CPUContextX86 structure to initialize.

◆ MinidumpMiscInfoDebugBuildString()

std::string crashpad::internal::MinidumpMiscInfoDebugBuildString ( )

Returns the string to set in MINIDUMP_MISC_INFO_4::DbgBldStr.

dbghelp produces strings like "dbghelp.i386,6.3.9600.16520" and "dbghelp.amd64,6.3.9600.16520". This function mimics that format, and adds the OS that wrote the minidump along with any relevant platform-specific data describing the compilation environment.

This function is an implementation detail of MinidumpMiscInfoWriter::InitializeFromSnapshot() and is only exposed for testing purposes.

◆ NativeWriteFile()

FileOperationResult crashpad::internal::NativeWriteFile	(	FileHandle	file,
		const void *	buffer,
		size_t	size
	)

Writes to a file, retrying when interrupted on POSIX.

Fewer than size bytes may be written to file. This can happen if the underlying write operation returns before writing the entire buffer, or if the buffer is too large to write in a single operation, possibly due to a limitation of a data type used to express the number of bytes written.

This function adapts native write operations for uniform use by WriteFile(). This function should only be called by WriteFile(). Other code should call WriteFile() or another function that wraps WriteFile().

Parameters

[in]	file	The file to write to.
[in]	buffer	A buffer containing data to be written.
[in]	size	The number of bytes from buffer to write.

Returns: The number of bytes actually written from buffer to file on success. -1 on error, with errno or GetLastError() set appropriately.

◆ ReadMinidumpAnnotationList()

bool crashpad::internal::ReadMinidumpAnnotationList	(	FileReaderInterface *	file_reader,
		const MINIDUMP_LOCATION_DESCRIPTOR &	location,
		std::vector< AnnotationSnapshot > *	list
	)

Reads a MinidumpAnnotationList from a minidump file at location in file_reader, and returns it in list.

Returns: true on success, with list set by replacing its contents. false on failure, with a message logged.

◆ ReadMinidumpSimpleStringDictionary()

bool crashpad::internal::ReadMinidumpSimpleStringDictionary	(	FileReaderInterface *	file_reader,
		const MINIDUMP_LOCATION_DESCRIPTOR &	location,
		std::map< std::string, std::string > *	dictionary
	)

Reads a MinidumpSimpleStringDictionary from a minidump file location in file_reader, and returns it in dictionary.

Returns: true on success, with dictionary set by replacing its contents. false on failure, with a message logged.

◆ ReadMinidumpStringList()

bool crashpad::internal::ReadMinidumpStringList	(	FileReaderInterface *	file_reader,
		const MINIDUMP_LOCATION_DESCRIPTOR &	location,
		std::vector< std::string > *	list
	)

Reads a list of MinidumpUTF8String objects in a MinidumpRVAList from a minidump file location in file_reader, and returns it in list.

Returns: true on success, with list set by replacing its contents. false on failure, with a message logged.

◆ ReadMinidumpUTF16String() [1/2]

bool crashpad::internal::ReadMinidumpUTF16String	(	FileReaderInterface *	file_reader,
		RVA	rva,
		base::string16 *	string
	)

Reads a MinidumpUTF16String from a minidump file at offset rva in file_reader, and returns it in string.

Returns: true on success, with string set. false on failure, with a message logged.

◆ ReadMinidumpUTF16String() [2/2]

bool crashpad::internal::ReadMinidumpUTF16String	(	FileReaderInterface *	file_reader,
		RVA	rva,
		std::string *	string
	)

Reads a MinidumpUTF16String from a minidump file at offset rva in file_reader, and returns it in string.

Returns: true on success, with string set. false on failure, with a message logged.

◆ ReadMinidumpUTF8String()

bool crashpad::internal::ReadMinidumpUTF8String	(	FileReaderInterface *	file_reader,
		RVA	rva,
		std::string *	string
	)

Reads a MinidumpUTF8String from a minidump file at offset rva in file_reader, and returns it in string.

Returns: true on success, with string set. false on failure, with a message logged.

◆ TimeZone()

void crashpad::internal::TimeZone	(	const timeval &	snapshot_time,
		SystemSnapshot::DaylightSavingTimeStatus *	dst_status,
		int *	standard_offset_seconds,
		int *	daylight_offset_seconds,
		std::string *	standard_name,
		std::string *	daylight_name
	)

Returns time zone information from the snapshot system, based on its locale configuration and snapshot_time.

Parameters

[in]	snapshot_time	The time to use collect daylight saving time status for, given in time since Epoch.
[out]	dst_status	Whether the location observes daylight saving time, and if so, whether it or standard time is currently being observed.
[out]	standard_offset_seconds	The number of seconds that the location’s time zone is east (ahead) of UTC during standard time.
[out]	daylight_offset_seconds	The number of seconds that the location’s time zone is east (ahead) of UTC during daylight saving. time.
[out]	standard_name	The name of the time zone while standard time is being observed.
[out]	daylight_name	The name of the time zone while daylight saving time is being observed.

See also: SystemSnapshot::TimeZone

Variable Documentation

◆ kNativeReadFunctionName

constexpr char crashpad::internal::kNativeReadFunctionName[] = "read"

constexpr

The name of the native read function used by ReadFile().

This value may be useful for logging.

See also: kNativeWriteFunctionName

◆ kNativeWriteFunctionName

constexpr char crashpad::internal::kNativeWriteFunctionName[] = "write"

constexpr

The name of the native write function used by WriteFile().

This value may be useful for logging.

See also: kNativeReadFunctionName

Classes

Functions

Variables

Detailed Description

Function Documentation

◆ Dlsym()

◆ GetFunction()

◆ GetFunctionInternal()

◆ InitializeCPUContextARM()

◆ InitializeCPUContextARM64() [1/2]

◆ InitializeCPUContextARM64() [2/2]

◆ InitializeCPUContextARM64_NoFloatingPoint()

◆ InitializeCPUContextARM64_OnlyFPSIMD()

◆ InitializeCPUContextARM_NoFloatingPoint()

◆ InitializeCPUContextMIPS()

◆ InitializeCPUContextX86() [1/3]

◆ InitializeCPUContextX86() [2/3]

◆ InitializeCPUContextX86() [3/3]

◆ InitializeCPUContextX86_64() [1/3]

◆ InitializeCPUContextX86_64() [2/3]

◆ InitializeCPUContextX86_64() [3/3]

◆ InitializeCPUContextX86_64_NoFloatingPoint() [1/2]

◆ InitializeCPUContextX86_64_NoFloatingPoint() [2/2]

◆ InitializeCPUContextX86_NoFloatingPoint()

◆ MinidumpMiscInfoDebugBuildString()

◆ NativeWriteFile()

◆ ReadMinidumpAnnotationList()

◆ ReadMinidumpSimpleStringDictionary()

◆ ReadMinidumpStringList()

◆ ReadMinidumpUTF16String() [1/2]

◆ ReadMinidumpUTF16String() [2/2]

◆ ReadMinidumpUTF8String()

◆ TimeZone()

Variable Documentation

◆ kNativeReadFunctionName

◆ kNativeWriteFunctionName