diff options
Diffstat (limited to 'gcc/ada/g-trasym.ads')
-rw-r--r-- | gcc/ada/g-trasym.ads | 70 |
1 files changed, 3 insertions, 67 deletions
diff --git a/gcc/ada/g-trasym.ads b/gcc/ada/g-trasym.ads index a3ac108..1d9b3f7 100644 --- a/gcc/ada/g-trasym.ads +++ b/gcc/ada/g-trasym.ads @@ -31,71 +31,7 @@ -- Run-time symbolic traceback support --- The full capability is currently supported on the following targets: +-- See file s-trasym.ads for full documentation of the interface --- HP-UX ia64 --- GNU/Linux x86, x86_64, ia64 --- FreeBSD x86, x86_64 --- Solaris sparc and x86 --- OpenVMS Alpha and ia64 --- Windows - --- Note: on targets other than those listed above, a dummy implementation of --- the body returns a series of LF separated strings of the form "0x..." --- corresponding to the addresses. - --- The routines provided in this package assume that your application has --- been compiled with debugging information turned on, since this information --- is used to build a symbolic traceback. - --- If you want to retrieve tracebacks from exception occurrences, it is also --- necessary to invoke the binder with -E switch. Please refer to the gnatbind --- documentation for more information. - --- Note that it is also possible (and often recommended) to compute symbolic --- traceback outside the program execution, which in addition allows you --- to distribute the executable with no debug info: --- --- - build your executable with debug info --- - archive this executable --- - strip a copy of the executable and distribute/deploy this version --- - at run time, compute absolute traceback (-bargs -E) from your --- executable and log it using Ada.Exceptions.Exception_Information --- - off line, compute the symbolic traceback using the executable archived --- with debug info and addr2line or gdb (using info line *<addr>) on the --- absolute addresses logged by your application. - --- In order to retrieve symbolic information, functions in this package will --- read on disk all the debug information of the executable file (found via --- Argument (0), and looked in the PATH if needed) or shared libraries using --- OS facilities, and load them in memory, causing a significant cpu and --- memory overhead. - --- Symbolic traceback from shared libraries is only supported for VMS, Windows --- and GNU/Linux. On other targets symbolic tracebacks are only supported for --- the main executable. You should consider using gdb to obtain symbolic --- traceback in such cases. - --- On VMS, there is no restriction on using this facility with shared --- libraries. However, the OS should be at least v7.3-1 and OS patch --- VMS731_TRACE-V0100 must be applied in order to use this package. - --- On platforms where the full capability is not supported, function --- Symbolic_Traceback return a list of addresses expressed as "0x..." --- separated by line feed. - -with Ada.Exceptions; - -package GNAT.Traceback.Symbolic is - pragma Elaborate_Body; - - function Symbolic_Traceback (Traceback : Tracebacks_Array) return String; - -- Build a string containing a symbolic traceback of the given call chain. - -- Note: This procedure may be installed by Set_Trace_Decorator, to get a - -- symbolic traceback on all exceptions raised (see GNAT.Exception_Traces). - - function Symbolic_Traceback - (E : Ada.Exceptions.Exception_Occurrence) return String; - -- Build string containing symbolic traceback of given exception occurrence - -end GNAT.Traceback.Symbolic; +with System.Traceback.Symbolic; +package GNAT.Traceback.Symbolic renames System.Traceback.Symbolic; |