85 lines
2.5 KiB
C
85 lines
2.5 KiB
C
|
/**
|
||
|
|
* Copyright (c) Facebook, Inc. and its affiliates.
|
||
|
|
*
|
||
|
|
* This source code is licensed under the MIT license found in the LICENSE
|
||
|
|
* file in the root directory of this source tree.
|
||
|
|
*/
|
||
|
|
#pragma once
|
||
|
|
|
||
|
|
#include <exception>
|
||
|
|
#include <typeinfo>
|
||
|
|
#include <vector>
|
||
|
|
|
||
|
|
#include <lyra/lyra.h>
|
||
|
|
|
||
|
|
namespace facebook {
|
||
|
|
namespace lyra {
|
||
|
|
|
||
|
|
namespace detail {
|
||
|
|
struct ExceptionTraceHolder {
|
||
|
|
ExceptionTraceHolder();
|
||
|
|
// Need some virtual function to make this a polymorphic type.
|
||
|
|
virtual ~ExceptionTraceHolder();
|
||
|
|
ExceptionTraceHolder(const ExceptionTraceHolder&) = delete;
|
||
|
|
ExceptionTraceHolder(ExceptionTraceHolder&&) = default;
|
||
|
|
|
||
|
|
std::vector<InstructionPointer> stackTrace_;
|
||
|
|
};
|
||
|
|
|
||
|
|
template <typename E, bool hasTraceHolder>
|
||
|
|
struct Holder : E, ExceptionTraceHolder {
|
||
|
|
Holder(E&& e) : E{std::forward<E>(e)}, ExceptionTraceHolder{} {}
|
||
|
|
};
|
||
|
|
template <typename E>
|
||
|
|
struct Holder<E, true> : E {
|
||
|
|
Holder(E&& e) : E{std::forward<E>(e)} {}
|
||
|
|
};
|
||
|
|
}
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Retrieves the stack trace of an exception
|
||
|
|
*/
|
||
|
|
const std::vector<InstructionPointer>& getExceptionTrace(std::exception_ptr ptr);
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Throw an exception and store the stack trace. This works like
|
||
|
|
* std::throw_with_nested in that it will actually throw a type that is
|
||
|
|
* publicly derived from both E and detail::ExceptionTraceHolder.
|
||
|
|
*/
|
||
|
|
template <class E>
|
||
|
|
[[noreturn]] void fbthrow(E&& exception) {
|
||
|
|
throw detail::Holder<E, std::is_base_of<detail::ExceptionTraceHolder, E>::value>{std::forward<E>(exception)};
|
||
|
|
}
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Ensure that a terminate handler that logs traces is installed.
|
||
|
|
* setLibraryIdentifierFunction should be called first if the stack
|
||
|
|
* trace should log build ids for libraries.
|
||
|
|
*/
|
||
|
|
void ensureRegisteredTerminateHandler();
|
||
|
|
|
||
|
|
/**
|
||
|
|
* Helper to convert an exception to a string
|
||
|
|
*/
|
||
|
|
std::string toString(std::exception_ptr exceptionPointer);
|
||
|
|
|
||
|
|
/**
|
||
|
|
* lyra's cxa_throw will delegate to the original cxa throw. That pointer must
|
||
|
|
* be set before lyra::cxa_throw is called.
|
||
|
|
*
|
||
|
|
* One example use would be to statically compile against something that overrides __cxa_throw.
|
||
|
|
* That would look something like:
|
||
|
|
*
|
||
|
|
* [[noreturn]] void __cxa_throw(void* obj, const std::type_info* type, void (*destructor) (void*)) {
|
||
|
|
* static auto initializer = lyra::original_cxa_throw = lookupOriginalCxaThrow();
|
||
|
|
* lyra::cxa_throw(obj, type, destructor);
|
||
|
|
* }
|
||
|
|
*/
|
||
|
|
[[gnu::noreturn]] extern void (*original_cxa_throw)(void*, const std::type_info*, void (*) (void*));
|
||
|
|
[[noreturn]] void cxa_throw(void* obj, const std::type_info* type, void (*destructor) (void *));
|
||
|
|
|
||
|
|
void enableCxaThrowHookBacktraces(bool enable);
|
||
|
|
|
||
|
|
}
|
||
|
|
}
|