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

bt_release_accessor()

Release an accessor for 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_release_accessor(bt_accessor_t *acc);

Arguments:

acc
A pointer to a bt_accessor_t structure. This is an opaque structure that holds the identity of the thread to backtrace.

Library:

libbacktrace

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

Description:

The bt_release_accessor() function releases all resources that acc keeps track of.


Note: Don't release an accessor while another function is using it.

Don't call bt_init_accessor() or bt_release_accessor() for the bt_acc_self global variable.


Returns:

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

Errors:

EINVAL
The acc argument is NULL.

Classification:

QNX Neutrino

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

See also:

bt_get_backtrace(), bt_init_accessor(), bt_load_memmap(), 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