1 ------------------------------------------------------------------------------
3 -- GNAT RUN-TIME COMPONENTS --
5 -- G N A T . T R A C E B A C K . S Y M B O L I C --
9 -- Copyright (C) 1999-2003 Ada Core Technologies, Inc. --
11 -- GNAT is free software; you can redistribute it and/or modify it under --
12 -- terms of the GNU General Public License as published by the Free Soft- --
13 -- ware Foundation; either version 2, or (at your option) any later ver- --
14 -- sion. GNAT is distributed in the hope that it will be useful, but WITH- --
15 -- OUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY --
16 -- or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License --
17 -- for more details. You should have received a copy of the GNU General --
18 -- Public License distributed with GNAT; see file COPYING. If not, write --
19 -- to the Free Software Foundation, 59 Temple Place - Suite 330, Boston, --
20 -- MA 02111-1307, USA. --
22 -- As a special exception, if other files instantiate generics from this --
23 -- unit, or you link this unit with other files to produce an executable, --
24 -- this unit does not by itself cause the resulting executable to be --
25 -- covered by the GNU General Public License. This exception does not --
26 -- however invalidate any other reasons why the executable file might be --
27 -- covered by the GNU Public License. --
29 -- GNAT was originally developed by the GNAT team at New York University. --
30 -- Extensive contributions were provided by Ada Core Technologies Inc. --
32 ------------------------------------------------------------------------------
34 -- Run-time symbolic traceback support
36 -- Note: this is only available on selected targets. Currently it is
37 -- supported on Sparc/Solaris, GNU/Linux, Windows NT, HP-UX and Tru64.
39 -- The routines provided in this package assume that your application has
40 -- been compiled with debugging information turned on, since this information
41 -- is used to build a symbolic traceback.
43 -- In order to retrieve symbolic information, functions in this package will
44 -- read on disk all the debug information of the executable file (found via
45 -- Argument (0), so any path information needed to read the executable file
46 -- need to be provided when launching the executable), and load then in
47 -- memory, causing a significant cpu and memory overhead.
49 -- This package is not intended to be used within a shared library,
50 -- symbolic tracebacks are only supported for the main executable
51 -- and not for shared libraries.
53 -- You should consider using off-line symbolic traceback instead, using
56 with Ada.Exceptions; use Ada.Exceptions;
58 package GNAT.Traceback.Symbolic is
59 pragma Elaborate_Body (Traceback.Symbolic);
61 ------------------------
62 -- Symbolic_Traceback --
63 ------------------------
65 function Symbolic_Traceback (Traceback : Tracebacks_Array) return String;
66 -- Build a string containing a symbolic traceback of the given call chain
68 function Symbolic_Traceback (E : Exception_Occurrence) return String;
69 -- Build string containing symbolic traceback of given exception occurrence
71 end GNAT.Traceback.Symbolic;