Caution: This version of this document is no longer maintained. For the latest documentation, see http://www.qnx.com/developers/docs.

bt_load_memmap()

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

See also:

bt_get_backtrace(), bt_init_accessor(), bt_release_accessor(), bt_set_flags(), bt_sprn_memmap(), bt_sprnf_addrs(), bt_translate_addrs(), bt_unload_memmap()

Backtraces in the QNX Neutrino technotes

pidin backtrace in the Utilities Reference