blob: 0a44be3e31f5b6ac0ab4d267bf9a0abd419bc4de [file] [log] [blame]
/**
* Entry point for exception handling support routines.
*
* There are three style of exception handling being supported by DMD:
* DWARF, Win32, and Win64. The Win64 code also supports POSIX.
* Support for those scheme is in `rt.dwarfeh`, `rt.deh_win32`, and
* `rt.deh_win64_posix`, respectively, and publicly imported here.
*
* When an exception is thrown by the user, the compiler translates
* code like `throw e;` into either `_d_throwdwarf` (for DWARF exceptions)
* or `_d_throwc` (Win32 / Win64), with the `Exception` object as argument.
*
* During those functions' handling, they eventually call `_d_createTrace`,
* which will store inside the `Exception` object the return of
* `_d_traceContext`, which is an object implementing `Throwable.TraceInfo`.
* `_d_traceContext` is a configurable hook, and by default will call
* `core.runtime : defaultTraceHandler`, which itself will call `backtrace`
* or something similar to store an array of stack frames (`void*` pointers)
* in the object it returns.
* Note that `defaultTraceHandler` returns a GC-allocated instance,
* hence a GC allocation can happen in the middle of throwing an `Exception`.
*
* The `Throwable.TraceInfo`-implementing should not resolves function names,
* file and line number until its `opApply` function is called, avoiding the
* overhead of reading the debug infos until the user call `toString`.
* If the user only calls `Throwable.message` (or use `Throwable.msg` directly),
* only the overhead of `backtrace` will be paid, which is minimal enouh.
*
* Copyright: Copyright Digital Mars 1999 - 2020.
* License: Distributed under the
* $(LINK2 http://www.boost.org/LICENSE_1_0.txt, Boost Software License 1.0).
* (See accompanying file LICENSE)
* Authors: Walter Bright
* Source: $(DRUNTIMESRC rt/deh.d)
*/
/* NOTE: This file has been patched from the original DMD distribution to
* work with the GDC compiler.
*/
module rt.deh;
extern (C)
{
Throwable.TraceInfo _d_traceContext(void* ptr = null);
Throwable.TraceDeallocator rt_getTraceDeallocator();
void _d_createTrace(Throwable t, void* context)
{
if (t !is null && t.info is null &&
cast(byte*) t !is typeid(t).initializer.ptr)
{
t.info = _d_traceContext(context);
t.infoDeallocator = rt_getTraceDeallocator();
}
}
}
version (GNU)
public import gcc.deh;
else version (Win32)
public import rt.deh_win32;
else version (Win64)
public import rt.deh_win64_posix;
else version (Posix)
public import rt.deh_win64_posix;
else
static assert (0, "Unsupported architecture");