bt_set_flags()
Set or clear the flags for backtracing
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_set_flags( bt_accessor_t *acc,
unsigned flags,
int onoff );
Arguments:
- acc
- A pointer to a bt_accessor_t structure. This is an opaque structure that holds the identity of the thread to backtrace.
- flags
- A bitwise ORing of the flags you want to set:
- BTF_LIVE_BACKTRACE — typically bt_get_backtrace() freezes a thread before gathering the backtrace. If you set this flag, bt_get_backtrace() doesn't freeze the thread. This can be useful if you want to freeze many threads at the same time, and then collect the backtrace for all threads, thus providing a coherent snapshot for all of the threads.
- onoff
- Zero to clear the specified flags, or a nonzero value to set the flags.
Library:
libbacktrace
Use the -l backtrace option to qcc to link against this library.
Description:
The bt_set_flags() function lets you turn the specified flags on or off.
Returns:
- 0
- Success.
- -1
- An error occurred (errno is set).
Errors:
- EINVAL
- The flags argument specifies an invalid flag.
Classification:
| Safety: | |
|---|---|
| Cancellation point | No |
| Interrupt handler | Yes |
| Signal handler | Yes |
| Thread | Yes |
Page updated: