bt_load_memmap()

Load a memory map associated with a backtrace

---

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

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