Martin Willi
4c6c934635
The invocation of addr2line to resolve backtrace source locations is slow and cumbersome. When using libbfd directly, we can eliminate the overhead of the process invocation. Even better, we can cache library symbol names, bringing wicked fast lookups. As a neat bonus, we can resolve static function names.
100 lines
2.5 KiB
C
100 lines
2.5 KiB
C
/*
|
|
* Copyright (C) 2008 Martin Willi
|
|
* Hochschule fuer Technik Rapperswil
|
|
*
|
|
* This program is free software; you can redistribute it and/or modify it
|
|
* under the terms of the GNU General Public License as published by the
|
|
* Free Software Foundation; either version 2 of the License, or (at your
|
|
* option) any later version. See <http://www.fsf.org/copyleft/gpl.txt>.
|
|
*
|
|
* This program is distributed in the hope that it will be useful, but
|
|
* WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
|
|
* or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
|
|
* for more details.
|
|
*/
|
|
|
|
/**
|
|
* @defgroup backtrace backtrace
|
|
* @{ @ingroup utils
|
|
*/
|
|
|
|
#ifndef BACKTRACE_H_
|
|
#define BACKTRACE_H_
|
|
|
|
#include <stdio.h>
|
|
|
|
#include <library.h>
|
|
|
|
typedef struct backtrace_t backtrace_t;
|
|
|
|
/**
|
|
* A backtrace registers the frames on the stack during creation.
|
|
*/
|
|
struct backtrace_t {
|
|
|
|
/**
|
|
* Log the backtrace to a FILE stream.
|
|
*
|
|
* @param file FILE to log backtrace to
|
|
* @param detailed TRUE to resolve line/file using addr2line (slow)
|
|
*/
|
|
void (*log)(backtrace_t *this, FILE *file, bool detailed);
|
|
|
|
/**
|
|
* Check if the backtrace contains a frame having a function in a list.
|
|
*
|
|
* @param function name array
|
|
* @param number of elements in function array
|
|
* @return TRUE if one of the functions is in the stack
|
|
*/
|
|
bool (*contains_function)(backtrace_t *this, char *function[], int count);
|
|
|
|
/**
|
|
* Check two backtraces for equality.
|
|
*
|
|
* @param other backtrace to compare to this
|
|
* @return TRUE if backtraces are equal
|
|
*/
|
|
bool (*equals)(backtrace_t *this, backtrace_t *other);
|
|
/**
|
|
* Create an enumerator over the stack frame addresses.
|
|
*
|
|
* @return enumerator_t over void*
|
|
*/
|
|
enumerator_t* (*create_frame_enumerator)(backtrace_t *this);
|
|
|
|
/**
|
|
* Destroy a backtrace instance.
|
|
*/
|
|
void (*destroy)(backtrace_t *this);
|
|
};
|
|
|
|
/**
|
|
* Create a backtrace of the current stack.
|
|
*
|
|
* @param skip how many of the innerst frames to skip
|
|
* @return backtrace
|
|
*/
|
|
backtrace_t *backtrace_create(int skip);
|
|
|
|
/**
|
|
* Create a backtrace, dump it and clean it up.
|
|
*
|
|
* @param label description to print for this backtrace, or NULL
|
|
* @param file FILE to log backtrace to
|
|
* @param detailed TRUE to resolve line/file using addr2line (slow)
|
|
*/
|
|
void backtrace_dump(char *label, FILE *file, bool detailed);
|
|
|
|
/**
|
|
* Initialize backtracing framework.
|
|
*/
|
|
void backtrace_init();
|
|
|
|
/**
|
|
* Deinitialize backtracing framework.
|
|
*/
|
|
void backtrace_deinit();
|
|
|
|
#endif /** BACKTRACE_H_ @}*/
|