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-2007, Free Software Foundation, 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, 51 Franklin Street, Fifth Floor, --
20 -- Boston, MA 02110-1301, 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 for Alpha/VMS
36 with Ada.Exceptions.Traceback; use Ada.Exceptions.Traceback;
40 with System.Soft_Links;
41 with System.Traceback_Entries;
43 package body GNAT.Traceback.Symbolic is
45 pragma Warnings (Off);
46 pragma Linker_Options ("--for-linker=sys$library:trace.exe");
51 use System.Traceback_Entries;
53 subtype User_Arg_Type is Unsigned_Longword;
54 subtype Cond_Value_Type is Unsigned_Longword;
57 Count : unsigned_char;
58 Data : char_array (1 .. 255);
60 pragma Convention (C, ASCIC);
63 Count at 0 range 0 .. 7;
64 Data at 1 range 0 .. 8 * 255 - 1;
66 for ASCIC'Size use 8 * 256;
68 function Fetch_ASCIC is new Fetch_From_Address (ASCIC);
70 -----------------------
71 -- Local Subprograms --
72 -----------------------
74 function Dummy_User_Act_Proc
75 (Msgvec : Address := Null_Address;
76 Actrtn : Address := Null_Address;
77 Facnam : Address := Null_Address;
78 Actprm : User_Arg_Type := 0) return Cond_Value_Type;
79 -- Dummy routine with SYS$PUTMSG signature
82 (Status : out Cond_Value_Type;
84 Adjusted_PC : Address;
86 Current_R26 : Address;
87 Image_Name : out Address;
88 Module_Name : out Address;
89 Routine_Name : out Address;
90 Line_Number : out Integer;
91 Relative_PC : out Address;
92 Absolute_PC : out Address;
93 PC_Is_Valid : out Long_Integer;
94 User_Act_Proc : Address := Dummy_User_Act_Proc'Address;
95 User_Arg_Value : User_Arg_Type := 0);
96 -- Comment on above procedure required ???
98 pragma Interface (External, Symbolize);
100 pragma Import_Valued_Procedure
101 (Symbolize, "TBK$SYMBOLIZE",
102 (Cond_Value_Type, Address, Address, Address, Address,
103 Address, Address, Address, Integer,
104 Address, Address, Long_Integer,
105 Address, User_Arg_Type),
106 (Value, Value, Value, Value, Value,
107 Reference, Reference, Reference, Reference,
108 Reference, Reference, Reference,
111 function Decode_Ada_Name (Encoded_Name : String) return String;
112 -- Decodes an Ada identifier name. Removes leading "_ada_" and trailing
113 -- __{DIGIT}+ or ${DIGIT}+, converts other "__" to '.'
115 ---------------------
116 -- Decode_Ada_Name --
117 ---------------------
119 function Decode_Ada_Name (Encoded_Name : String) return String is
120 Decoded_Name : String (1 .. Encoded_Name'Length);
121 Pos : Integer := Encoded_Name'First;
122 Last : Integer := Encoded_Name'Last;
130 -- Skip leading _ada_
132 if Encoded_Name'Length > 4
133 and then Encoded_Name (Pos .. Pos + 4) = "_ada_"
138 -- Skip trailing __{DIGIT}+ or ${DIGIT}+
140 if Encoded_Name (Last) in '0' .. '9' then
141 for J in reverse Pos + 2 .. Last - 1 loop
142 case Encoded_Name (J) is
149 if Encoded_Name (J - 1) = '_' then
159 -- Now just copy encoded name to decoded name, converting "__" to '.'
161 while Pos <= Last loop
162 if Encoded_Name (Pos) = '_' and then Encoded_Name (Pos + 1) = '_'
163 and then Pos /= Encoded_Name'First
165 Decoded_Name (DPos) := '.';
169 Decoded_Name (DPos) := Encoded_Name (Pos);
176 return Decoded_Name (1 .. DPos - 1);
179 -------------------------
180 -- Dummy_User_Act_Proc --
181 -------------------------
183 function Dummy_User_Act_Proc
184 (Msgvec : Address := Null_Address;
185 Actrtn : Address := Null_Address;
186 Facnam : Address := Null_Address;
187 Actprm : User_Arg_Type := 0) return Cond_Value_Type
191 end Dummy_User_Act_Proc;
193 ------------------------
194 -- Symbolic_Traceback --
195 ------------------------
197 function Symbolic_Traceback (Traceback : Tracebacks_Array) return String is
198 Status : Cond_Value_Type;
200 Image_Name_Addr : Address;
202 Module_Name_Addr : Address;
203 Routine_Name : ASCIC;
204 Routine_Name_Addr : Address;
205 Line_Number : Integer;
206 Relative_PC : Address;
207 Absolute_PC : Address;
208 PC_Is_Valid : Long_Integer;
209 Return_Address : Address;
210 Res : String (1 .. 256 * Traceback'Length);
214 if Traceback'Length > 0 then
217 -- Since image computation is not thread-safe we need task lockout
219 System.Soft_Links.Lock_Task.all;
221 for J in Traceback'Range loop
222 if J = Traceback'Last then
223 Return_Address := Address_Zero;
225 Return_Address := PC_For (Traceback (J + 1));
230 PC_For (Traceback (J)),
231 PC_For (Traceback (J)),
232 PV_For (Traceback (J)),
242 Image_Name := Fetch_ASCIC (Image_Name_Addr);
243 Module_Name := Fetch_ASCIC (Module_Name_Addr);
244 Routine_Name := Fetch_ASCIC (Routine_Name_Addr);
247 First : Integer := Len + 1;
248 Last : Integer := First + 80 - 1;
250 Routine_Name_D : String := Decode_Ada_Name
252 (Routine_Name.Data (1 .. size_t (Routine_Name.Count)),
256 Res (First .. Last) := (others => ' ');
258 Res (First .. First + Integer (Image_Name.Count) - 1) :=
260 (Image_Name.Data (1 .. size_t (Image_Name.Count)),
264 First + 10 + Integer (Module_Name.Count) - 1) :=
266 (Module_Name.Data (1 .. size_t (Module_Name.Count)),
270 First + 30 + Routine_Name_D'Length - 1) :=
273 -- If routine name doesn't fit 20 characters, output
274 -- the line number on next line at 50th position
276 if Routine_Name_D'Length > 20 then
277 Pos := First + 30 + Routine_Name_D'Length;
278 Res (Pos) := ASCII.LF;
280 Res (Pos + 1 .. Last) := (others => ' ');
286 Res (Pos .. Pos + Integer'Image (Line_Number)'Length - 1) :=
287 Integer'Image (Line_Number);
289 Res (Last) := ASCII.LF;
294 System.Soft_Links.Unlock_Task.all;
295 return Res (1 .. Len);
300 end Symbolic_Traceback;
302 function Symbolic_Traceback (E : Exception_Occurrence) return String is
304 return Symbolic_Traceback (Tracebacks (E));
305 end Symbolic_Traceback;
307 end GNAT.Traceback.Symbolic;