#ifndef THIRD_PARTY_GBMCWEB_INCLUDE_EXCEPTION_STACK_TRACER_HPP_
#define THIRD_PARTY_GBMCWEB_INCLUDE_EXCEPTION_STACK_TRACER_HPP_

// Installs a std::terminate handler that prints the ORIGINAL throw-site stack
// of the uncaught exception, recorded at throw time by a __cxa_throw
// interposer (folly exception_tracer mechanism). Exceptions captured into a
// std::exception_ptr and rethrown later (asio scheduler
// rethrow_pending_exception, sdbusplus do_unpack posted rethrow) otherwise
// terminate with a stack that only shows the rethrow site.
//
// The terminate path never allocates, takes no locks, and guards against
// re-entry; see src/exception_stack_tracer.cpp for the full constraints.
//
// The interposer is active as soon as its TU is linked in; this call installs
// the terminate handler and snapshots the module table used to symbolize
// frames. Call it first thing in run() so nothing on the crash path
// allocates, dlopens, or takes the loader lock.
//
// With enable == false (--exception_stack_tracer=false kill switch),
// recording becomes a no-op and the default terminate handler is kept.
void installExceptionStackTracer(bool enable = true);

#endif  // THIRD_PARTY_GBMCWEB_INCLUDE_EXCEPTION_STACK_TRACER_HPP_