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 |