------------------------------------------------------------------------------ -- -- -- GNAT COMPILER COMPONENTS -- -- -- -- G N A T . E X C E P T I O N _ A C T I O N S -- -- -- -- B o d y -- -- -- -- Copyright (C) 2002-2025, Free Software Foundation, Inc. -- -- -- -- GNAT is free software; you can redistribute it and/or modify it under -- -- terms of the GNU General Public License as published by the Free Soft- -- -- ware Foundation; either version 3, or (at your option) any later ver- -- -- sion. GNAT is distributed in the hope that it will be useful, but WITH- -- -- OUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY -- -- or FITNESS FOR A PARTICULAR PURPOSE. -- -- -- -- As a special exception under Section 7 of GPL version 3, you are granted -- -- additional permissions described in the GCC Runtime Library Exception, -- -- version 3.1, as published by the Free Software Foundation. -- -- -- -- You should have received a copy of the GNU General Public License and -- -- a copy of the GCC Runtime Library Exception along with this program; -- -- see the files COPYING3 and COPYING.RUNTIME respectively. If not, see -- -- . -- -- -- -- GNAT was originally developed by the GNAT team at New York University. -- -- Extensive contributions were provided by Ada Core Technologies Inc. -- -- -- ------------------------------------------------------------------------------ with Ada.Unchecked_Conversion; with System; with System.Soft_Links; use System.Soft_Links; with System.Standard_Library; use System.Standard_Library; with System.Exception_Table; use System.Exception_Table; with Interfaces.C; use Interfaces.C; package body GNAT.Exception_Actions is Global_Action : Exception_Action; pragma Import (Ada, Global_Action, "__gnat_exception_actions_global_action"); pragma Atomic (Global_Action); -- Imported from Ada.Exceptions. Any change in the external name needs to -- be coordinated with a-exextr.adb. Global_Unhandled_Action : Exception_Action; pragma Import (Ada, Global_Unhandled_Action, "__gnat_exception_actions_global_unhandled_action"); pragma Atomic (Global_Unhandled_Action); -- Imported from Ada.Exceptions. Any change in the external name needs to -- be coordinated with a-exextr.adb. Raise_Hook_Initialized : Boolean; pragma Import (Ada, Raise_Hook_Initialized, "__gnat_exception_actions_initialized"); function To_Raise_Action is new Ada.Unchecked_Conversion (Exception_Action, Raise_Action); -- ??? Would be nice to have this in System.Standard_Library function To_Data is new Ada.Unchecked_Conversion (Exception_Id, Exception_Data_Ptr); function To_Id is new Ada.Unchecked_Conversion (Exception_Data_Ptr, Exception_Id); ---------------------------- -- Register_Global_Action -- ---------------------------- procedure Register_Global_Action (Action : Exception_Action) is begin Global_Action := Action; end Register_Global_Action; -------------------------------------- -- Register_Global_Unhandled_Action -- -------------------------------------- procedure Register_Global_Unhandled_Action (Action : Exception_Action) is begin Global_Unhandled_Action := Action; end Register_Global_Unhandled_Action; ------------------------ -- Register_Id_Action -- ------------------------ procedure Register_Id_Action (Id : Exception_Id; Action : Exception_Action) is begin if Id = Null_Id then raise Program_Error; end if; Lock_Task.all; To_Data (Id).Raise_Hook := To_Raise_Action (Action); Raise_Hook_Initialized := True; Unlock_Task.all; end Register_Id_Action; --------------- -- Core_Dump -- --------------- procedure Core_Dump (Occurrence : Exception_Occurrence) is separate; ------------------------ -- Exception_Language -- ------------------------ function Exception_Language (E : Exception_Occurrence) return Exception_Languages is Foreign_Exception : aliased Exception_Data; pragma Import (Ada, Foreign_Exception, "system__exceptions__foreign_exception"); function To_Exception_Data_Ptr is new Ada.Unchecked_Conversion (Exception_Id, Exception_Data_Ptr); IdD : constant Exception_Data_Ptr := To_Exception_Data_Ptr (Exception_Identity (E)); Lang : constant Character := IdD.Lang; begin if Lang in 'B' .. 'C' then return EL_Cpp; end if; if Lang /= 'A' then return EL_Unknown; end if; if IdD /= Foreign_Exception'Unchecked_Access then return EL_Ada; end if; declare function Get_Exception_Machine_Occurrence (E : Exception_Occurrence) return System.Address; pragma Import (Ada, Get_Exception_Machine_Occurrence, "__gnat_get_exception_machine_occurrence"); function Exception_Language_Is_CPlusPlus (E : System.Address) return C_bool; pragma Import (C, Exception_Language_Is_CPlusPlus, "__gnat_exception_language_is_cplusplus"); function Exception_Language_Is_Ada (E : System.Address) return C_bool; pragma Import (C, Exception_Language_Is_Ada, "__gnat_exception_language_is_ada"); Occurrence : constant System.Address := Get_Exception_Machine_Occurrence (E); begin if Exception_Language_Is_CPlusPlus (Occurrence) then return EL_Cpp; elsif Exception_Language_Is_Ada (Occurrence) then -- This might some day indicate third-party Ada exceptions. -- With GNAT exceptions, we should not reach this point. return EL_Ada; end if; end; return EL_Unknown; end Exception_Language; -------------------------- -- Is_Foreign_Exception -- -------------------------- function Is_Foreign_Exception (E : Exception_Occurrence) return Boolean is begin return Exception_Language (E) /= EL_Ada; end Is_Foreign_Exception; ---------------- -- Name_To_Id -- ---------------- function Name_To_Id (Name : String) return Exception_Id is begin return To_Id (Internal_Exception (Name, Create_If_Not_Exist => False)); end Name_To_Id; --------------------------------- -- Registered_Exceptions_Count -- --------------------------------- function Registered_Exceptions_Count return Natural renames System.Exception_Table.Registered_Exceptions_Count; ------------------------------- -- Get_Registered_Exceptions -- ------------------------------- -- This subprogram isn't an iterator to avoid concurrency problems, -- since the exceptions are registered dynamically. Since we have to lock -- the runtime while computing this array, this means that any callback in -- an active iterator would be unable to access the runtime. procedure Get_Registered_Exceptions (List : out Exception_Id_Array; Last : out Integer) is Ids : Exception_Data_Array (List'Range); begin Get_Registered_Exceptions (Ids, Last); for L in List'First .. Last loop List (L) := To_Id (Ids (L)); end loop; end Get_Registered_Exceptions; end GNAT.Exception_Actions;