aboutsummaryrefslogtreecommitdiff
path: root/src/lib/err/backtrace.h
blob: 48b41fca0230e40c2b701962083aa01e68c1a09d (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
/* Copyright (c) 2013-2019, The Tor Project, Inc. */
/* See LICENSE for licensing information */

#ifndef TOR_BACKTRACE_H
#define TOR_BACKTRACE_H

/**
 * \file backtrace.h
 *
 * \brief Header for backtrace.c
 **/

#include "orconfig.h"
#include "lib/cc/compat_compiler.h"

typedef void (*tor_log_fn)(int, unsigned, const char *fmt, ...)
  CHECK_PRINTF(3,4);

void log_backtrace_impl(int severity, int domain, const char *msg,
                        tor_log_fn logger);
int configure_backtrace_handler(const char *tor_version);
void clean_up_backtrace_handler(void);
void dump_stack_symbols_to_error_fds(void);
const char *get_tor_backtrace_version(void);

#define log_backtrace(sev, dom, msg) \
  log_backtrace_impl((sev), (dom), (msg), tor_log)

#ifdef EXPOSE_CLEAN_BACKTRACE
#if defined(HAVE_EXECINFO_H) && defined(HAVE_BACKTRACE) && \
  defined(HAVE_BACKTRACE_SYMBOLS_FD) && defined(HAVE_SIGACTION)
void clean_backtrace(void **stack, size_t depth, const ucontext_t *ctx);
#endif
#endif /* defined(EXPOSE_CLEAN_BACKTRACE) */

#endif /* !defined(TOR_BACKTRACE_H) */