backtrace.c File Reference

Asterisk backtrace generation. More...

#include "asterisk.h"
#include "asterisk/backtrace.h"
#include "asterisk/vector.h"
#include <execinfo.h>
#include <pthread.h>
#include <stdbool.h>

Include dependency graph for backtrace.c:

Go to the source code of this file.

Macros
#define	_ASTERISK_LOCK_H
#define	ast_calloc(n, x)   calloc(n, x)
#define	ast_free(x)   free(x)
#define	ast_malloc(x)   malloc(x)
#define	ASTMM_LIBC   ASTMM_IGNORE
#define	S_OR(a, b)   (a && a[0] != '\0') ? a : b

Functions
struct ast_bt *	__ast_bt_create (void)
void *	__ast_bt_destroy (struct ast_bt *bt)
void	__ast_bt_free_symbols (struct ast_vector_string *symbols)
int	__ast_bt_get_addresses (struct ast_bt *bt)
struct ast_vector_string *	__ast_bt_get_symbols (void **addresses, size_t num_frames)

Detailed Description

Asterisk backtrace generation.

This file provides backtrace generation utilities

Definition in file backtrace.c.

Macro Definition Documentation

_ASTERISK_LOCK_H

#define _ASTERISK_LOCK_H

Definition at line 33 of file backtrace.c.

ast_calloc

#define ast_calloc	(		n,
			x
	)		calloc(n, x)

Definition at line 52 of file backtrace.c.

ast_free

#define ast_free

(

x

)

free(x)

Definition at line 51 of file backtrace.c.

ast_malloc

#define ast_malloc

(

x

)

malloc(x)

Definition at line 53 of file backtrace.c.

ASTMM_LIBC

#define ASTMM_LIBC   ASTMM_IGNORE

Definition at line 39 of file backtrace.c.

S_OR

#define S_OR	(		a,
			b
	)		(a && a[0] != '\0') ? a : b

Definition at line 78 of file backtrace.c.

Function Documentation

__ast_bt_create()

struct ast_bt * __ast_bt_create

(

void

)

Definition at line 80 of file backtrace.c.

{
    struct ast_bt *bt = calloc(1, sizeof(*bt));
 
    if (!bt) {
        return NULL;
    }
    bt->alloced = 1;
 
    ast_bt_get_addresses(bt);
 
    return bt;
}

References ast_bt::alloced, ast_bt_get_addresses, and NULL.

__ast_bt_destroy()

void * __ast_bt_destroy

(

struct ast_bt *

bt

)

Definition at line 100 of file backtrace.c.

{
    if (bt && bt->alloced) {
        free(bt);
    }
    return NULL;
}

References ast_bt::alloced, free(), and NULL.

__ast_bt_free_symbols()

void __ast_bt_free_symbols

(

struct ast_vector_string *

symbols

)

Definition at line 310 of file backtrace.c.

{
    AST_VECTOR_CALLBACK_VOID(symbols, free);
    AST_VECTOR_PTR_FREE(symbols);
}

References AST_VECTOR_CALLBACK_VOID, AST_VECTOR_PTR_FREE, and free().

__ast_bt_get_addresses()

int __ast_bt_get_addresses

(

struct ast_bt *

bt

)

Definition at line 94 of file backtrace.c.

{
    bt->num_frames = backtrace(bt->addresses, AST_MAX_BT_FRAMES);
    return 0;
}

References ast_bt::addresses, AST_MAX_BT_FRAMES, and ast_bt::num_frames.

__ast_bt_get_symbols()

struct ast_vector_string * __ast_bt_get_symbols	(	void **	addresses,
		size_t	num_frames
	)

Definition at line 283 of file backtrace.c.

{
    char **strings;
    struct ast_vector_string *return_strings;
    int i;
 
    return_strings = malloc(sizeof(struct ast_vector_string));
    if (!return_strings) {
        return NULL;
    }
    if (AST_VECTOR_INIT(return_strings, num_frames)) {
        free(return_strings);
        return NULL;
    }
 
    strings = backtrace_symbols(addresses, num_frames);
    if (strings) {
        for (i = 0; i < num_frames; i++) {
            AST_VECTOR_APPEND(return_strings, strdup(strings[i]));
        }
        free(strings);
    }
 
    return return_strings;
}

References AST_VECTOR_APPEND, AST_VECTOR_INIT, free(), malloc(), and NULL.