bt_load_memmap()

Updated: April 19, 2023

Load a memory map associated with a backtrace

Note: The backtrace library is an unsupported feature, due to its fragility. For more information, see Backtraces in the QNX Neutrino technotes.

Synopsis:

#include <backtrace.h>

int bt_load_memmap( bt_accessor_t *acc,
                    bt_memmap_t * memmap );

Arguments:

acc
A pointer to a bt_accessor_t structure. This is an opaque structure that holds the identity of the thread to backtrace.
memmap
A pointer to a location where the function can store the memory map.

Library:

libbacktrace

Use the -l backtrace option to qcc to link against this library.

Description:

The bt_load_memmap() function reads the memory map information from the process represented by acc, and saves the information in memmap.

Returns:

0
Success.
-1
An error occurred (errno is set).

Errors:

EINVAL
The acc or memmap argument is NULL.
ENOMEM
There wasn't enough memory to load the memory map.

This function can also set errno to any of the values that devctl() and open() can.

Classification:

QNX Neutrino

Safety:  
Cancellation point No
Interrupt handler No
Signal handler No
Thread Yes