bt_init_accessor()

Инициализировать метод доступа обратной трассировки

Библиотека обратной трассировки не поддерживается из-за ее недостаточной надежности.

Прототип:

#include <backtrace.h>
                                       
int bt_init_accessor( bt_accessor_t *acc,
                      bt_acc_type_t type,
                      ... );

Аргументы:

acc

Указатель на структуру bt_accessor_t. Это непрозрачная структура, в которой хранится идентификатор потока, для которого нужно выполнить обратную трассировку.

type

Тип обратной трассировки для выполнения; один из следующих:

BT_SELF: для вызывающего потока.
BT_THREAD: для указанного потока текущего процесса.
BT_PROCESS: для указанного потока другого процесса.

Требуются дополнительные аргументы для BT_THREAD и BT_PROCESS, как описано ниже.

Описание:

Функция bt_init_accessor() инициализирует метод доступа с идентификатором потока для обратной трассировки:

вызывающего потока:

bt_init_accessor( bt_accessor_t *acc, BT_SELF );

потока в текущем процессе:

bt_init_accessor( bt_accessor_t *acc, BT_THREAD, pthread_t tid );

потока в любом процессе:

bt_init_accessor( bt_accessor_t *acc, BT_PROCESS, pid_t pid, pthread_t tid );

Глобальная переменная bt_acc_self - это предварительно инициализированный метод доступа, используемый для отслеживания текущего потока. Не вызывайте bt_init_accessor() или bt_release_accessor() для этой переменной.

Возвращаемое значение:

0: Успешное завершение.
-1: Возникла ошибка. Код ошибки записан в errno.

Коды ошибок:

EINVAL: Аргумент acc равен NULL, или передан некорректный type.

Классификация:

ЗОСРВ «Нейтрино»

Безопасность использования
Точка остановки потока: Нет
Обработчик прерываний: Нет
Обработчик сигналов: Да
В потоке: Да

Тематические ссылки:

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

Примеры использования и сведения об архитектуре библиотеки доступны в разделе общие сведения.

pidin backtrace в Справочнике по Утилитам

Предыдущий раздел: Описание API библиотеки backtrace