1------------------------------------------------------------------------------ 2-- -- 3-- GNAT COMPILER COMPONENTS -- 4-- -- 5-- S Y S T E M . T R A C E B A C K -- 6-- -- 7-- B o d y -- 8-- -- 9-- Copyright (C) 1999-2014, Free Software Foundation, Inc. -- 10-- -- 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. -- 17-- -- 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. -- 21-- -- 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/>. -- 26-- -- 27-- GNAT was originally developed by the GNAT team at New York University. -- 28-- Extensive contributions were provided by Ada Core Technologies Inc. -- 29-- -- 30------------------------------------------------------------------------------ 31 32-- This is the default version of this package 33 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. 36 37pragma Compiler_Unit_Warning; 38 39package body System.Traceback is 40 41 ------------------ 42 -- C_Call_Chain -- 43 ------------------ 44 45 function C_Call_Chain 46 (Traceback : System.Address; 47 Max_Len : Natural) return Natural 48 is 49 Val : Natural; 50 begin 51 Call_Chain (Traceback, Max_Len, Val); 52 return Val; 53 end C_Call_Chain; 54 55 ---------------- 56 -- Call_Chain -- 57 ---------------- 58 59 function Backtrace 60 (Traceback : System.Address; 61 Len : Integer; 62 Exclude_Min : System.Address; 63 Exclude_Max : System.Address; 64 Skip_Frames : Integer) 65 return Integer; 66 pragma Import (C, Backtrace, "__gnat_backtrace"); 67 68 procedure Call_Chain 69 (Traceback : System.Address; 70 Max_Len : Natural; 71 Len : out Natural; 72 Exclude_Min : System.Address := System.Null_Address; 73 Exclude_Max : System.Address := System.Null_Address; 74 Skip_Frames : Natural := 1) 75 is 76 begin 77 -- Note: Backtrace relies on the following call actually creating a 78 -- stack frame. To ensure that this is the case, it is essential to 79 -- compile this unit without sibling call optimization. 80 81 -- We want the underlying engine to skip its own frame plus the 82 -- ones we have been requested to skip ourselves. 83 84 Len := Backtrace (Traceback => Traceback, 85 Len => Max_Len, 86 Exclude_Min => Exclude_Min, 87 Exclude_Max => Exclude_Max, 88 Skip_Frames => Skip_Frames + 1); 89 end Call_Chain; 90 91 procedure Call_Chain 92 (Traceback : in out System.Traceback_Entries.Tracebacks_Array; 93 Max_Len : Natural; 94 Len : out Natural; 95 Exclude_Min : System.Address := System.Null_Address; 96 Exclude_Max : System.Address := System.Null_Address; 97 Skip_Frames : Natural := 1) 98 is 99 begin 100 Call_Chain 101 (Traceback'Address, Max_Len, Len, 102 Exclude_Min, Exclude_Max, 103 104 -- Skip one extra frame to skip the other Call_Chain entry as well 105 106 Skip_Frames => Skip_Frames + 1); 107 end Call_Chain; 108 109end System.Traceback; 110