/** * 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 #include #include #include 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 stackTrace_; }; template struct Holder : E, ExceptionTraceHolder { Holder(E&& e) : E{std::forward(e)}, ExceptionTraceHolder{} {} }; template struct Holder : E { Holder(E&& e) : E{std::forward(e)} {} }; } /** * Retrieves the stack trace of an exception */ const std::vector& 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 [[noreturn]] void fbthrow(E&& exception) { throw detail::Holder::value>{std::forward(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); } }