1 ------------------------------------------------------------------------------
3 -- GNAT COMPILER COMPONENTS --
5 -- S Y S T E M . T R A C E B A C K --
9 -- Copyright (C) 1999-2014, 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 3, 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. --
18 -- As a special exception under Section 7 of GPL version 3, you are granted --
19 -- additional permissions described in the GCC Runtime Library Exception, --
20 -- version 3.1, as published by the Free Software Foundation. --
22 -- You should have received a copy of the GNU General Public License and --
23 -- a copy of the GCC Runtime Library Exception along with this program; --
24 -- see the files COPYING3 and COPYING.RUNTIME respectively. If not, see --
25 -- <http://www.gnu.org/licenses/>. --
27 -- GNAT was originally developed by the GNAT team at New York University. --
28 -- Extensive contributions were provided by Ada Core Technologies Inc. --
30 ------------------------------------------------------------------------------
32 -- This is the default version of this package
34 -- Note: this unit must be compiled using -fno-optimize-sibling-calls.
35 -- See comment below in body of Call_Chain for details on the reason.
37 pragma Compiler_Unit_Warning
;
39 package body System
.Traceback
is
41 -- procedure Call_Chain
42 -- (Traceback : System.Address;
45 -- Exclude_Min : System.Address := System.Null_Address;
46 -- Exclude_Max : System.Address := System.Null_Address;
47 -- Skip_Frames : Natural := 1);
48 -- -- Same as the exported version, but takes Traceback as an Address
49 -- ???See declaration in the spec for why this is temporarily commented out.
56 (Traceback
: System
.Address
;
57 Max_Len
: Natural) return Natural
61 Call_Chain
(Traceback
, Max_Len
, Val
);
70 (Traceback
: System
.Address
;
72 Exclude_Min
: System
.Address
;
73 Exclude_Max
: System
.Address
;
74 Skip_Frames
: Integer)
76 pragma Import
(C
, Backtrace
, "__gnat_backtrace");
79 (Traceback
: System
.Address
;
82 Exclude_Min
: System
.Address
:= System
.Null_Address
;
83 Exclude_Max
: System
.Address
:= System
.Null_Address
;
84 Skip_Frames
: Natural := 1)
87 -- Note: Backtrace relies on the following call actually creating a
88 -- stack frame. To ensure that this is the case, it is essential to
89 -- compile this unit without sibling call optimization.
91 -- We want the underlying engine to skip its own frame plus the
92 -- ones we have been requested to skip ourselves.
94 Len
:= Backtrace
(Traceback
=> Traceback
,
96 Exclude_Min
=> Exclude_Min
,
97 Exclude_Max
=> Exclude_Max
,
98 Skip_Frames
=> Skip_Frames
+ 1);
102 (Traceback
: in out System
.Traceback_Entries
.Tracebacks_Array
;
105 Exclude_Min
: System
.Address
:= System
.Null_Address
;
106 Exclude_Max
: System
.Address
:= System
.Null_Address
;
107 Skip_Frames
: Natural := 1)
111 (Traceback
'Address, Max_Len
, Len
,
112 Exclude_Min
, Exclude_Max
,
114 -- Skip one extra frame to skip the other Call_Chain entry as well
116 Skip_Frames
=> Skip_Frames
+ 1);
119 end System
.Traceback
;