libbacktrace_wrapper.h

/*
 * Copyright (c) 2019-2024 Status Research & Development GmbH
 * Licensed under either of
 *  * Apache License, version 2.0,
 *  * MIT license
 * at your option.
 * This file may not be copied, modified, or distributed except according to
 * those terms.
 */

#ifndef LIBBACKTRACE_WRAPPER_H
#define LIBBACKTRACE_WRAPPER_H

#include <stdint.h>

#ifdef __cplusplus
extern "C" {
#endif

// The returned string needs to be freed by the caller.
char *get_backtrace_max_length_c(int max_length, int skip) __attribute__((noinline));

// The returned string needs to be freed by the caller.
char *get_backtrace_c(void) __attribute__((noinline));

/*
 * The returned array needs to be freed by the caller.
 */
uintptr_t *get_program_counters_c(
	int max_program_counters, int *num_program_counters, int skip) __attribute__((noinline));

struct debugging_info {
	char *filename;
	int lineno;
	char *function;
};

/*
 * The returned array needs to be freed by the caller.
 * Char pointers in the returned structs need to be freed by the caller.
 */
struct debugging_info *get_debugging_info_c(
	const uintptr_t *program_counters, int num_program_counters,
	int max_debugging_infos, int *num_debugging_infos);

#ifdef __cplusplus
} // extern "C"
#endif

#endif // LIBBACKTRACE_WRAPPER_H