diff options
Diffstat (limited to 'gcc-4.8.1/gcc/ada/s-tasdeb-vms.adb')
| -rw-r--r-- | gcc-4.8.1/gcc/ada/s-tasdeb-vms.adb | 2158 |
1 files changed, 2158 insertions, 0 deletions
diff --git a/gcc-4.8.1/gcc/ada/s-tasdeb-vms.adb b/gcc-4.8.1/gcc/ada/s-tasdeb-vms.adb new file mode 100644 index 000000000..1dbb5c53f --- /dev/null +++ b/gcc-4.8.1/gcc/ada/s-tasdeb-vms.adb @@ -0,0 +1,2158 @@ +------------------------------------------------------------------------------ +-- -- +-- GNAT RUN-TIME LIBRARY (GNARL) COMPONENTS -- +-- -- +-- S Y S T E M . T A S K I N G . D E B U G -- +-- -- +-- B o d y -- +-- -- +-- Copyright (C) 2008-2012, 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 -- +-- <http://www.gnu.org/licenses/>. -- +-- -- +-- GNARL was developed by the GNARL team at Florida State University. -- +-- Extensive contributions were provided by Ada Core Technologies, Inc. -- +-- -- +------------------------------------------------------------------------------ + +-- OpenVMS Version + +with Ada.Unchecked_Conversion; +with Ada.Unchecked_Deallocation; +with System.Aux_DEC; +with System.CRTL; +with System.Task_Primitives.Operations; +package body System.Tasking.Debug is + + package OSI renames System.OS_Interface; + package STPO renames System.Task_Primitives.Operations; + + use System.Aux_DEC; + + -- Condition value type + + subtype Cond_Value_Type is Unsigned_Longword; + + type Trace_Flag_Set is array (Character) of Boolean; + + Trace_On : Trace_Flag_Set := ('A' .. 'Z' => False, others => True); + + -- Print_Routine fuction codes + + type Print_Functions is + (No_Print, Print_Newline, Print_Control, + Print_String, Print_Symbol, Print_FAO); + for Print_Functions use + (No_Print => 0, Print_Newline => 1, Print_Control => 2, + Print_String => 3, Print_Symbol => 4, Print_FAO => 5); + + -- Counted ascii type declarations + + subtype Count_Type is Natural range 0 .. 255; + for Count_Type'Object_Size use 8; + + type ASCIC (Count : Count_Type) is record + Text : String (1 .. Count); + end record; + + for ASCIC use record + Count at 0 range 0 .. 7; + end record; + pragma Pack (ASCIC); + + type AASCIC is access ASCIC; + for AASCIC'Size use 32; + + type AASCIC_Array is array (Positive range <>) of AASCIC; + + type ASCIC127 is record + Count : Count_Type; + Text : String (1 .. 127); + end record; + + for ASCIC127 use record + Count at 0 range 0 .. 7; + Text at 1 range 0 .. 127 * 8 - 1; + end record; + + -- DEBUG Event record types used to signal DEBUG about Ada events + + type Debug_Event_Record is record + Code : Unsigned_Word; -- Event code that uniquely identifies event + Flags : Bit_Array_8; -- Flag bits + -- Bit 0: This event allows a parameter list + -- Bit 1: Parameters are address expressions + Sentinal : Unsigned_Byte; -- Sentinal valuye: Always K_EVENT_SENT + TS_Kind : Unsigned_Byte; -- DST type specification: Always K_TS_TASK + DType : Unsigned_Byte; -- DTYPE of parameter if of atomic data type + -- Always K_DTYPE_TASK + MBZ : Unsigned_Byte; -- Unused (must be zero) + Minchr : Count_Type; -- Minimum chars needed to identify event + Name : ASCIC (31); -- Event name uppercase only + Help : AASCIC; -- Event description + end record; + + for Debug_Event_Record use record + Code at 0 range 0 .. 15; + Flags at 2 range 0 .. 7; + Sentinal at 3 range 0 .. 7; + TS_Kind at 4 range 0 .. 7; + Dtype at 5 range 0 .. 7; + MBZ at 6 range 0 .. 7; + Minchr at 7 range 0 .. 7; + Name at 8 range 0 .. 32 * 8 - 1; + Help at 40 range 0 .. 31; + end record; + + type Ada_Event_Control_Block_Type is record + Code : Unsigned_Word; -- Reserved and defined by DEBUG + Unused1 : Unsigned_Byte; -- Reserved and defined by DEBUG + Sentinal : Unsigned_Byte; -- Reserved and defined by DEBUG + Facility : Unsigned_Word; -- Reserved and defined by DEBUG + Flags : Unsigned_Word; -- Reserved and defined by DEBUG + Value : Unsigned_Longword; -- Reserved and defined by DEBUG + Unused2 : Unsigned_Longword; -- Reserved and defined by DEBUG + Sigargs : Unsigned_Longword; + P1 : Unsigned_Longword; + Sub_Event : Unsigned_Longword; + end record; + + for Ada_Event_Control_Block_Type use record + Code at 0 range 0 .. 15; + Unused1 at 2 range 0 .. 7; + Sentinal at 3 range 0 .. 7; + Facility at 4 range 0 .. 15; + Flags at 6 range 0 .. 15; + Value at 8 range 0 .. 31; + Unused2 at 12 range 0 .. 31; + Sigargs at 16 range 0 .. 31; + P1 at 20 range 0 .. 31; + Sub_Event at 24 range 0 .. 31; + end record; + + type Ada_Event_Control_Block_Access is access Ada_Event_Control_Block_Type; + for Ada_Event_Control_Block_Access'Size use 32; + + -- Print_Routine_Type with max optional parameters + + type Print_Routine_Type is access procedure + (Print_Function : Print_Functions; + Print_Subfunction : Print_Functions; + P1 : Unsigned_Longword := 0; + P2 : Unsigned_Longword := 0; + P3 : Unsigned_Longword := 0; + P4 : Unsigned_Longword := 0; + P5 : Unsigned_Longword := 0; + P6 : Unsigned_Longword := 0); + for Print_Routine_Type'Size use 32; + + --------------- + -- Constants -- + --------------- + + -- These are used to obtain and convert task values + K_CVT_VALUE_NUM : constant := 1; + K_CVT_NUM_VALUE : constant := 2; + K_NEXT_TASK : constant := 3; + + -- These are used to ask ADA to display task information + K_SHOW_TASK : constant := 4; + K_SHOW_STAT : constant := 5; + K_SHOW_DEADLOCK : constant := 6; + + -- These are used to get and set various attributes of one or more tasks + -- Task state + -- K_GET_STATE : constant := 7; + -- K_GET_ACTIVE : constant := 8; + -- K_SET_ACTIVE : constant := 9; + K_SET_ABORT : constant := 10; + -- K_SET_HOLD : constant := 11; + + -- Task priority + K_GET_PRIORITY : constant := 12; + K_SET_PRIORITY : constant := 13; + K_RESTORE_PRIORITY : constant := 14; + + -- Task registers + -- K_GET_REGISTERS : constant := 15; + -- K_SET_REGISTERS : constant := 16; + + -- These are used to control definable events + K_ENABLE_EVENT : constant := 17; + K_DISABLE_EVENT : constant := 18; + K_ANNOUNCE_EVENT : constant := 19; + + -- These are used to control time-slicing. + -- K_SHOW_TIME_SLICE : constant := 20; + -- K_SET_TIME_SLICE : constant := 21; + + -- This is used to symbolize task stack addresses. + -- K_SYMBOLIZE_ADDRESS : constant := 22; + + K_GET_CALLER : constant := 23; + -- This is used to obtain the task value of the caller task + + -- Miscellaneous functions - see below for details + + K_CLEANUP_EVENT : constant := 24; + K_SHOW_EVENT_DEF : constant := 25; + -- K_CHECK_TASK_STACK : constant := 26; -- why commented out ??? + + -- This is used to obtain the DBGEXT-interface revision level + -- K_GET_DBGEXT_REV : constant := 27; -- why commented out ??? + + K_GET_STATE_1 : constant := 28; + -- This is used to obtain additional state info, primarily for PCA + + K_FIND_EVENT_BY_CODE : constant := 29; + K_FIND_EVENT_BY_NAME : constant := 30; + -- These are used to search for user-defined event entries + + -- This is used to stop task schedulding. Why commented out ??? + -- K_STOP_ALL_OTHER_TASKS : constant := 31; + + -- Debug event constants + + K_TASK_NOT_EXIST : constant := 3; + K_SUCCESS : constant := 1; + K_EVENT_SENT : constant := 16#9A#; + K_TS_TASK : constant := 18; + K_DTYPE_TASK : constant := 44; + + -- Status signal constants + + SS_BADPARAM : constant := 20; + SS_NORMAL : constant := 1; + + -- Miscellaneous mask constants + + V_EVNT_ALL : constant := 0; + V_Full_Display : constant := 11; + V_Suppress_Header : constant := 13; + + -- CMA constants (why are some commented out???) + + CMA_C_DEBGET_GUARDSIZE : constant := 1; + CMA_C_DEBGET_IS_HELD : constant := 2; +-- CMA_C_DEBGET_IS_INITIAL : constant := 3; +-- CMA_C_DEBGET_NUMBER : constant := 4; + CMA_C_DEBGET_STACKPTR : constant := 5; + CMA_C_DEBGET_STACK_BASE : constant := 6; + CMA_C_DEBGET_STACK_TOP : constant := 7; + CMA_C_DEBGET_SCHED_STATE : constant := 8; + CMA_C_DEBGET_YELLOWSIZE : constant := 9; +-- CMA_C_DEBGET_BASE_PRIO : constant := 10; +-- CMA_C_DEBGET_REGS : constant := 11; +-- CMA_C_DEBGET_ALT_PENDING : constant := 12; +-- CMA_C_DEBGET_ALT_A_ENABLE : constant := 13; +-- CMA_C_DEBGET_ALT_G_ENABLE : constant := 14; +-- CMA_C_DEBGET_SUBSTATE : constant := 15; +-- CMA_C_DEBGET_OBJECT_ADDR : constant := 16; +-- CMA_C_DEBGET_THKIND : constant := 17; +-- CMA_C_DEBGET_DETACHED : constant := 18; + CMA_C_DEBGET_TCB_SIZE : constant := 19; +-- CMA_C_DEBGET_START_PC : constant := 20; +-- CMA_C_DEBGET_NEXT_PC : constant := 22; +-- CMA_C_DEBGET_POLICY : constant := 23; +-- CMA_C_DEBGET_STACK_YELLOW : constant := 24; +-- CMA_C_DEBGET_STACK_DEFAULT : constant := 25; + + -- Miscellaneous counted ascii constants + + Star : constant AASCIC := new ASCIC'(2, ("* ")); + NoStar : constant AASCIC := new ASCIC'(2, (" ")); + Hold : constant AASCIC := new ASCIC'(4, ("HOLD")); + NoHold : constant AASCIC := new ASCIC'(4, (" ")); + Header : constant AASCIC := new ASCIC ' + (60, (" task id pri hold state substate task object")); + Empty_Text : constant AASCIC := new ASCIC (0); + + -- DEBUG Ada tasking states equated to their GNAT tasking equivalents + + Ada_State_Invalid_State : constant AASCIC := + new ASCIC'(17, "Invalid state "); +-- Ada_State_Abnormal : constant AASCIC := +-- new ASCIC'(17, "Abnormal "); + Ada_State_Aborting : constant AASCIC := + new ASCIC'(17, "Aborting "); -- Aborting (new) +-- Ada_State_Completed_Abn : constant AASCIC := +-- new ASCIC'(17, "Completed [abn] "); +-- Ada_State_Completed_Exc : constant AASCIC := +-- new ASCIC'(17, "Completed [exc] "); + Ada_State_Completed : constant AASCIC := + new ASCIC'(17, "Completed "); -- Master_Completion_Sleep + Ada_State_Runnable : constant AASCIC := + new ASCIC'(17, "Runnable "); -- Runnable + Ada_State_Activating : constant AASCIC := + new ASCIC'(17, "Activating "); + Ada_State_Accept : constant AASCIC := + new ASCIC'(17, "Accept "); -- Acceptor_Sleep + Ada_State_Select_or_Delay : constant AASCIC := + new ASCIC'(17, "Select or delay "); -- Acceptor_Delay_Sleep + Ada_State_Select_or_Term : constant AASCIC := + new ASCIC'(17, "Select or term. "); -- Terminate_Alternative + Ada_State_Select_or_Abort : constant AASCIC := + new ASCIC'(17, "Select or abort "); -- Async_Select_Sleep (new) +-- Ada_State_Select : constant AASCIC := +-- new ASCIC'(17, "Select "); + Ada_State_Activating_Tasks : constant AASCIC := + new ASCIC'(17, "Activating tasks "); -- Activator_Sleep + Ada_State_Delay : constant AASCIC := + new ASCIC'(17, "Delay "); -- AST_Pending +-- Ada_State_Dependents : constant AASCIC := +-- new ASCIC'(17, "Dependents "); + Ada_State_Entry_Call : constant AASCIC := + new ASCIC'(17, "Entry call "); -- Entry_Caller_Sleep + Ada_State_Cond_Entry_Call : constant AASCIC := + new ASCIC'(17, "Cond. entry call "); -- Call.Mode.Conditional_Call + Ada_State_Timed_Entry_Call : constant AASCIC := + new ASCIC'(17, "Timed entry call "); -- Call.Mode.Timed_Call + Ada_State_Async_Entry_Call : constant AASCIC := + new ASCIC'(17, "Async entry call "); -- Call.Mode.Asynchronous_Call (new) +-- Ada_State_Dependents_Exc : constant AASCIC := +-- new ASCIC'(17, "Dependents [exc] "); + Ada_State_IO_or_AST : constant AASCIC := + new ASCIC'(17, "I/O or AST "); -- AST_Server_Sleep +-- Ada_State_Shared_Resource : constant AASCIC := +-- new ASCIC'(17, "Shared resource "); + Ada_State_Not_Yet_Activated : constant AASCIC := + new ASCIC'(17, "Not yet activated"); -- Unactivated +-- Ada_State_Terminated_Abn : constant AASCIC := +-- new ASCIC'(17, "Terminated [abn] "); +-- Ada_State_Terminated_Exc : constant AASCIC := +-- new ASCIC'(17, "Terminated [exc] "); + Ada_State_Terminated : constant AASCIC := + new ASCIC'(17, "Terminated "); -- Terminated + Ada_State_Server : constant AASCIC := + new ASCIC'(17, "Server "); -- Servers + Ada_State_Async_Hold : constant AASCIC := + new ASCIC'(17, "Async_Hold "); -- Async_Hold + + -- Task state counted ascii constants + + Debug_State_Emp : constant AASCIC := new ASCIC'(5, " "); + Debug_State_Run : constant AASCIC := new ASCIC'(5, "RUN "); + Debug_State_Rea : constant AASCIC := new ASCIC'(5, "READY"); + Debug_State_Sus : constant AASCIC := new ASCIC'(5, "SUSP "); + Debug_State_Ter : constant AASCIC := new ASCIC'(5, "TERM "); + + -- Priority order of event display + + Global_Event_Display_Order : constant array (Event_Kind_Type) + of Event_Kind_Type := ( + Debug_Event_Abort_Terminated, + Debug_Event_Activating, + Debug_Event_Dependents_Exception, + Debug_Event_Exception_Terminated, + Debug_Event_Handled, + Debug_Event_Handled_Others, + Debug_Event_Preempted, + Debug_Event_Rendezvous_Exception, + Debug_Event_Run, + Debug_Event_Suspended, + Debug_Event_Terminated); + + -- Constant array defining all debug events + + Event_Directory : constant array (Event_Kind_Type) + of Debug_Event_Record := ( + (Debug_Event_Activating, + (False, False, False, False, False, False, False, True), + K_EVENT_SENT, + K_TS_TASK, + K_DTYPE_TASK, + 0, + 2, + (31, "ACTIVATING "), + new ASCIC'(41, "!_a task is about to begin its activation")), + + (Debug_Event_Run, + (False, False, False, False, False, False, False, True), + K_EVENT_SENT, + K_TS_TASK, + K_DTYPE_TASK, + 0, + 2, + (31, "RUN "), + new ASCIC'(24, "!_a task is about to run")), + + (Debug_Event_Suspended, + (False, False, False, False, False, False, False, True), + K_EVENT_SENT, + K_TS_TASK, + K_DTYPE_TASK, + 0, + 1, + (31, "SUSPENDED "), + new ASCIC'(33, "!_a task is about to be suspended")), + + (Debug_Event_Preempted, + (False, False, False, False, False, False, False, True), + K_EVENT_SENT, + K_TS_TASK, + K_DTYPE_TASK, + 0, + 1, + (31, "PREEMPTED "), + new ASCIC'(33, "!_a task is about to be preempted")), + + (Debug_Event_Terminated, + (False, False, False, False, False, False, False, True), + K_EVENT_SENT, + K_TS_TASK, + K_DTYPE_TASK, + 0, + 1, + (31, "TERMINATED "), + new ASCIC'(57, + "!_a task is terminating (including by abort or exception)")), + + (Debug_Event_Abort_Terminated, + (False, False, False, False, False, False, False, True), + K_EVENT_SENT, + K_TS_TASK, + K_DTYPE_TASK, + 0, + 2, + (31, "ABORT_TERMINATED "), + new ASCIC'(40, "!_a task is terminating because of abort")), + + (Debug_Event_Exception_Terminated, + (False, False, False, False, False, False, False, True), + K_EVENT_SENT, + K_TS_TASK, + K_DTYPE_TASK, + 0, + 1, + (31, "EXCEPTION_TERMINATED "), + new ASCIC'(47, "!_a task is terminating because of an exception")), + + (Debug_Event_Rendezvous_Exception, + (False, False, False, False, False, False, False, True), + K_EVENT_SENT, + K_TS_TASK, + K_DTYPE_TASK, + 0, + 3, + (31, "RENDEZVOUS_EXCEPTION "), + new ASCIC'(49, "!_an exception is propagating out of a rendezvous")), + + (Debug_Event_Handled, + (False, False, False, False, False, False, False, True), + K_EVENT_SENT, + K_TS_TASK, + K_DTYPE_TASK, + 0, + 1, + (31, "HANDLED "), + new ASCIC'(37, "!_an exception is about to be handled")), + + (Debug_Event_Dependents_Exception, + (False, False, False, False, False, False, False, True), + K_EVENT_SENT, + K_TS_TASK, + K_DTYPE_TASK, + 0, + 1, + (31, "DEPENDENTS_EXCEPTION "), + new ASCIC'(64, + "!_an exception is about to cause a task to await dependent tasks")), + + (Debug_Event_Handled_Others, + (False, False, False, False, False, False, False, True), + K_EVENT_SENT, + K_TS_TASK, + K_DTYPE_TASK, + 0, + 1, + (31, "HANDLED_OTHERS "), + new ASCIC'(58, + "!_an exception is about to be handled in an OTHERS handler"))); + + -- Help on events displayed in DEBUG + + Event_Def_Help : constant AASCIC_Array := ( + new ASCIC'(0, ""), + new ASCIC'(65, + " The general forms of commands to set a breakpoint or tracepoint"), + new ASCIC'(22, " on an Ada event are:"), + new ASCIC'(73, " SET BREAK/EVENT=event [task[, ... ]] " & + "[WHEN(expr)] [DO(comnd[; ... ])]"), + new ASCIC'(73, " SET TRACE/EVENT=event [task[, ... ]] " & + "[WHEN(expr)] [DO(comnd[; ... ])]"), + new ASCIC'(0, ""), + new ASCIC'(65, + " If tasks are specified, the breakpoint will trigger only if the"), + new ASCIC'(40, " event occurs for those specific tasks."), + new ASCIC'(0, ""), + new ASCIC'(39, " Ada event names and their definitions"), + new ASCIC'(0, "")); + + ----------------------- + -- Package Variables -- + ----------------------- + + AC_Buffer : ASCIC127; + + Events_Enabled_Count : Integer := 0; + + Print_Routine_Bufsiz : constant := 132; + Print_Routine_Bufcnt : Integer := 0; + Print_Routine_Linbuf : String (1 .. Print_Routine_Bufsiz); + + Global_Task_Debug_Events : Debug_Event_Array := + (False, False, False, False, False, False, False, False, + False, False, False, False, False, False, False, False); + -- Global table of task debug events set by the debugger + + -------------------------- + -- Exported Subprograms -- + -------------------------- + + procedure Default_Print_Routine + (Print_Function : Print_Functions; + Print_Subfunction : Print_Functions; + P1 : Unsigned_Longword := 0; + P2 : Unsigned_Longword := 0; + P3 : Unsigned_Longword := 0; + P4 : Unsigned_Longword := 0; + P5 : Unsigned_Longword := 0; + P6 : Unsigned_Longword := 0); + -- The default print routine if not overridden. + -- Print_Function determines option argument formatting. + -- Print_Subfunction buffers output if No_Print, calls Put_Output if + -- Print_Newline + + pragma Export_Procedure + (Default_Print_Routine, + Mechanism => (Value, Value, Reference, Reference, Reference)); + + -------------------------- + -- Imported Subprograms -- + -------------------------- + + procedure Debug_Get + (Thread_Id : OSI.Thread_Id; + Item_Req : Unsigned_Word; + Out_Buff : System.Address; + Buff_Siz : Unsigned_Word); + + procedure Debug_Get + (Thread_Id : OSI.Thread_Id; + Item_Req : Unsigned_Word; + Out_Buff : Unsigned_Longword; + Buff_Siz : Unsigned_Word); + pragma Import (External, Debug_Get); + + pragma Import_Procedure (Debug_Get, "CMA$DEBUG_GET", + (OSI.Thread_Id, Unsigned_Word, System.Address, Unsigned_Word), + (Reference, Value, Reference, Value)); + + pragma Import_Procedure (Debug_Get, "CMA$DEBUG_GET", + (OSI.Thread_Id, Unsigned_Word, Unsigned_Longword, Unsigned_Word), + (Reference, Value, Reference, Value)); + + procedure FAOL + (Status : out Cond_Value_Type; + Ctrstr : String; + Outlen : out Unsigned_Word; + Outbuf : out String; + Prmlst : Unsigned_Longword_Array); + pragma Import (External, FAOL); + + pragma Import_Valued_Procedure (FAOL, "SYS$FAOL", + (Cond_Value_Type, String, Unsigned_Word, String, Unsigned_Longword_Array), + (Value, Descriptor (S), Reference, Descriptor (S), Reference)); + + procedure Put_Output ( + Status : out Cond_Value_Type; + Message_String : String); + + procedure Put_Output (Message_String : String); + pragma Import (External, Put_Output); + + pragma Import_Valued_Procedure (Put_Output, "LIB$PUT_OUTPUT", + (Cond_Value_Type, String), + (Value, Short_Descriptor (S))); + + pragma Import_Procedure (Put_Output, "LIB$PUT_OUTPUT", + (String), + (Short_Descriptor (S))); + + procedure Signal + (Condition_Value : Cond_Value_Type; + Number_Of_Arguments : Integer := Integer'Null_Parameter; + FAO_Argument_1 : Unsigned_Longword := + Unsigned_Longword'Null_Parameter); + pragma Import (External, Signal); + + pragma Import_Procedure (Signal, "LIB$SIGNAL", + (Cond_Value_Type, Integer, Unsigned_Longword), + (Value, Value, Value), + Number_Of_Arguments); + + ---------------------------- + -- Generic Instantiations -- + ---------------------------- + + function Fetch is new Fetch_From_Address (Unsigned_Longword); + pragma Unreferenced (Fetch); + + procedure Free is new Ada.Unchecked_Deallocation + (Object => Ada_Event_Control_Block_Type, + Name => Ada_Event_Control_Block_Access); + + function To_AASCIC is new + Ada.Unchecked_Conversion (Unsigned_Longword, AASCIC); + + function To_Addr is new + Ada.Unchecked_Conversion (Task_Procedure_Access, Address); + pragma Unreferenced (To_Addr); + + function To_EVCB is new + Ada.Unchecked_Conversion + (Unsigned_Longword, Ada_Event_Control_Block_Access); + + function To_Integer is new + Ada.Unchecked_Conversion (Task_Id, System.Task_Primitives.Task_Address); + + function To_Print_Routine_Type is new + Ada.Unchecked_Conversion (Short_Address, Print_Routine_Type); + + -- Optional argumements passed to Print_Routine have to be + -- Unsigned_Longwords so define the required Unchecked_Conversions + + function To_UL is new + Ada.Unchecked_Conversion (AASCIC, Unsigned_Longword); + + function To_UL is new + Ada.Unchecked_Conversion (Integer, Unsigned_Longword); + + function To_UL is new + Ada.Unchecked_Conversion (Task_Id, Unsigned_Longword); + + pragma Warnings (Off); -- Different sizes + function To_UL is new + Ada.Unchecked_Conversion (Task_Entry_Index, Unsigned_Longword); + pragma Warnings (On); + + function To_UL is new + Ada.Unchecked_Conversion (Short_Address, Unsigned_Longword); + + function To_UL is new + Ada.Unchecked_Conversion + (Ada_Event_Control_Block_Access, Unsigned_Longword); + + ----------------------- + -- Local Subprograms -- + ----------------------- + + subtype Function_Codes is System.Aux_DEC.Unsigned_Word range 1 .. 31; + -- The 31 function codes sent by the debugger needed to implement + -- tasking support, enumerated below. + + type Register_Array is array (Natural range 0 .. 16) of + System.Aux_DEC.Unsigned_Longword; + -- The register array is a holdover from VAX and not used + -- on Alpha or I64 but is kept as a filler below. + + type DBGEXT_Control_Block (Function_Code : Function_Codes) is record + Facility_ID : System.Aux_DEC.Unsigned_Word; + -- For GNAT use the "Ada" facility ID + Status : System.Aux_DEC.Unsigned_Longword; + -- Successful or otherwise returned status + Flags : System.Aux_DEC.Bit_Array_32; + -- Used to flag event as global + Print_Routine : System.Aux_DEC.Short_Address; + -- The print subprogram the caller wants to use for output + Event_Code_or_EVCB : System.Aux_DEC.Unsigned_Longword; + -- Dual use Event Code or EVent Control Block + Event_Value_or_Name : System.Aux_DEC.Unsigned_Longword; + -- Dual use Event Value or Event Name string pointer + Event_Entry : System.Aux_DEC.Unsigned_Longword; + Task_Value : Task_Id; + Task_Number : Integer; + Ada_Flags : System.Aux_DEC.Bit_Array_32; + Priority : System.Aux_DEC.Bit_Array_32; + Active_Registers : System.Aux_DEC.Short_Address; + + case Function_Code is + when K_GET_STATE_1 => + Base_Priority : System.Aux_DEC.Bit_Array_32; + Task_Type_Name : System.Aux_DEC.Short_Address; + Creation_PC : System.Aux_DEC.Short_Address; + Parent_Task_ID : Task_Id; + + when others => + Ignored_Unused : Register_Array; + + end case; + end record; + + for DBGEXT_Control_Block use record + Function_Code at 0 range 0 .. 15; + Facility_ID at 2 range 0 .. 15; + Status at 4 range 0 .. 31; + Flags at 8 range 0 .. 31; + Print_Routine at 12 range 0 .. 31; + Event_Code_or_EVCB at 16 range 0 .. 31; + Event_Value_or_Name at 20 range 0 .. 31; + Event_Entry at 24 range 0 .. 31; + Task_Value at 28 range 0 .. 31; + Task_Number at 32 range 0 .. 31; + Ada_Flags at 36 range 0 .. 31; + Priority at 40 range 0 .. 31; + Active_Registers at 44 range 0 .. 31; + Ignored_Unused at 48 range 0 .. 17 * 32 - 1; + Base_Priority at 48 range 0 .. 31; + Task_Type_Name at 52 range 0 .. 31; + Creation_PC at 56 range 0 .. 31; + Parent_Task_ID at 60 range 0 .. 31; + end record; + + type DBGEXT_Control_Block_Access is access all DBGEXT_Control_Block; + + function DBGEXT (Control_Block : DBGEXT_Control_Block_Access) + return System.Aux_DEC.Unsigned_Word; + -- Exported to s-taprop.adb to avoid having a VMS specific s-tasdeb.ads + pragma Convention (C, DBGEXT); + pragma Export_Function (DBGEXT, "GNAT$DBGEXT"); + -- This routine is called by CMA when VMS DEBUG wants the Gnat RTL + -- to give it some assistance (primarily when tasks are debugged). + -- + -- The single parameter is an "external control block". On input to + -- the Gnat RTL this control block determines the debugging function + -- to be performed, and supplies parameters. This routine cases on + -- the function code, and calls the appropriate Gnat RTL routine, + -- which returns values by modifying the external control block. + + procedure Announce_Event + (Event_EVCB : Unsigned_Longword; + Print_Routine : Print_Routine_Type := Default_Print_Routine'Access); + -- Announce the occurence of a DEBUG tasking event + + procedure Cleanup_Event (Event_EVCB : Unsigned_Longword); + -- After DEBUG has processed an event that has signalled, the signaller + -- must cleanup. Cleanup consists of freeing the event control block. + + procedure Disable_Event + (Flags : Bit_Array_32; + Event_Value : Unsigned_Longword; + Event_Code : Unsigned_Longword; + Status : out Cond_Value_Type); + -- Disable a DEBUG tasking event + + function DoAC (S : String) return Address; + -- Convert a string to the address of an internal buffer containing + -- the counted ASCII. + + procedure Enable_Event + (Flags : Bit_Array_32; + Event_Value : Unsigned_Longword; + Event_Code : Unsigned_Longword; + Status : out Cond_Value_Type); + -- Enable a requested DEBUG tasking event + + procedure Find_Event_By_Code + (Event_Code : Unsigned_Longword; + Event_Entry : out Unsigned_Longword; + Status : out Cond_Value_Type); + -- Convert an event code to the address of the event entry + + procedure Find_Event_By_Name + (Event_Name : Unsigned_Longword; + Event_Entry : out Unsigned_Longword; + Status : out Cond_Value_Type); + -- Find an event entry given the event name + + procedure List_Entry_Waiters + (Task_Value : Task_Id; + Full_Display : Boolean := False; + Suppress_Header : Boolean := False; + Print_Routine : Print_Routine_Type := Default_Print_Routine'Access); + -- List information about tasks waiting on an entry + + procedure Put (S : String); + -- Display S on standard output + + procedure Put_Line (S : String := ""); + -- Display S on standard output with an additional line terminator + + procedure Show_Event + (Print_Routine : Print_Routine_Type := Default_Print_Routine'Access); + -- Show what events are available + + procedure Show_One_Task + (Task_Value : Task_Id; + Full_Display : Boolean := False; + Suppress_Header : Boolean := False; + Print_Routine : Print_Routine_Type := Default_Print_Routine'Access); + -- Display information about one task + + procedure Show_Rendezvous + (Task_Value : Task_Id; + Ada_State : AASCIC := Empty_Text; + Full_Display : Boolean := False; + Suppress_Header : Boolean := False; + Print_Routine : Print_Routine_Type := Default_Print_Routine'Access); + -- Display information about a task rendezvous + + procedure Trace_Output (Message_String : String); + -- Call Put_Output if Trace_on ("VMS") + + procedure Write (Fd : Integer; S : String; Count : Integer); + + -------------------- + -- Announce_Event -- + -------------------- + + procedure Announce_Event + (Event_EVCB : Unsigned_Longword; + Print_Routine : Print_Routine_Type := Default_Print_Routine'Access) + is + EVCB : constant Ada_Event_Control_Block_Access := To_EVCB (Event_EVCB); + + Event_Kind : constant Event_Kind_Type := + (if EVCB.Sub_Event /= 0 + then Event_Kind_Type (EVCB.Sub_Event) + else Event_Kind_Type (EVCB.Code)); + + TI : constant String := " Task %TASK !UI is "; + -- Announce prefix + + begin + Trace_Output ("Announce called"); + + case Event_Kind is + when Debug_Event_Activating => + Print_Routine (Print_FAO, Print_Newline, + To_UL (DoAC (TI & "about to begin its activation")), + EVCB.Value); + when Debug_Event_Exception_Terminated => + Print_Routine (Print_FAO, Print_Newline, + To_UL (DoAC (TI & "terminating because of an exception")), + EVCB.Value); + when Debug_Event_Run => + Print_Routine (Print_FAO, Print_Newline, + To_UL (DoAC (TI & "about to run")), + EVCB.Value); + when Debug_Event_Abort_Terminated => + Print_Routine (Print_FAO, Print_Newline, + To_UL (DoAC (TI & "terminating because of abort")), + EVCB.Value); + when Debug_Event_Terminated => + Print_Routine (Print_FAO, Print_Newline, + To_UL (DoAC (TI & "terminating normally")), + EVCB.Value); + when others => null; + end case; + end Announce_Event; + + ------------------- + -- Cleanup_Event -- + ------------------- + + procedure Cleanup_Event (Event_EVCB : Unsigned_Longword) is + EVCB : Ada_Event_Control_Block_Access := To_EVCB (Event_EVCB); + begin + Free (EVCB); + end Cleanup_Event; + + ------------------------ + -- Continue_All_Tasks -- + ------------------------ + + procedure Continue_All_Tasks is + begin + null; -- VxWorks + end Continue_All_Tasks; + + ------------ + -- DBGEXT -- + ------------ + + function DBGEXT + (Control_Block : DBGEXT_Control_Block_Access) + return System.Aux_DEC.Unsigned_Word + is + Print_Routine : Print_Routine_Type := Default_Print_Routine'Access; + begin + Trace_Output ("DBGEXT called"); + + if Control_Block.Print_Routine /= Address_Zero then + Print_Routine := To_Print_Routine_Type (Control_Block.Print_Routine); + end if; + + case Control_Block.Function_Code is + + -- Convert a task value to a task number. + -- The output results are stored in the CONTROL_BLOCK. + + when K_CVT_VALUE_NUM => + Trace_Output ("DBGEXT param 1 - CVT Value to NUM"); + Control_Block.Task_Number := + Control_Block.Task_Value.Known_Tasks_Index + 1; + Control_Block.Status := K_SUCCESS; + Trace_Output ("Task Number: "); + Trace_Output (Integer'Image (Control_Block.Task_Number)); + return SS_NORMAL; + + -- Convert a task number to a task value. + -- The output results are stored in the CONTROL_BLOCK. + + when K_CVT_NUM_VALUE => + Trace_Output ("DBGEXT param 2 - CVT NUM to Value"); + Trace_Output ("Task Number: "); + Trace_Output (Integer'Image (Control_Block.Task_Number)); + Control_Block.Task_Value := + Known_Tasks (Control_Block.Task_Number - 1); + Control_Block.Status := K_SUCCESS; + Trace_Output ("Task Value: "); + Trace_Output (Unsigned_Longword'Image + (To_UL (Control_Block.Task_Value))); + return SS_NORMAL; + + -- Obtain the "next" task after a specified task. + -- ??? To do: If specified check the PRIORITY, STATE, and HOLD + -- fields to restrict the selection of the next task. + -- The output results are stored in the CONTROL_BLOCK. + + when K_NEXT_TASK => + Trace_Output ("DBGEXT param 3 - Next Task"); + Trace_Output ("Task Value: "); + Trace_Output (Unsigned_Longword'Image + (To_UL (Control_Block.Task_Value))); + + if Control_Block.Task_Value = null then + Control_Block.Task_Value := Known_Tasks (Known_Tasks'First); + else + Control_Block.Task_Value := + Known_Tasks (Control_Block.Task_Value.Known_Tasks_Index + 1); + end if; + + if Control_Block.Task_Value = null then + Control_Block.Task_Value := Known_Tasks (Known_Tasks'First); + end if; + + Control_Block.Status := K_SUCCESS; + return SS_NORMAL; + + -- Display the state of a task. The FULL bit is checked to decide if + -- a full or brief task display is desired. The output results are + -- stored in the CONTROL_BLOCK. + + when K_SHOW_TASK => + Trace_Output ("DBGEXT param 4 - Show Task"); + + if Control_Block.Task_Value = null then + Control_Block.Status := K_TASK_NOT_EXIST; + else + Show_One_Task + (Control_Block.Task_Value, + Control_Block.Ada_Flags (V_Full_Display), + Control_Block.Ada_Flags (V_Suppress_Header), + Print_Routine); + + Control_Block.Status := K_SUCCESS; + end if; + + return SS_NORMAL; + + -- Enable a requested DEBUG tasking event + + when K_ENABLE_EVENT => + Trace_Output ("DBGEXT param 17 - Enable Event"); + Enable_Event + (Control_Block.Flags, + Control_Block.Event_Value_or_Name, + Control_Block.Event_Code_or_EVCB, + Control_Block.Status); + + return SS_NORMAL; + + -- Disable a DEBUG tasking event + + when K_DISABLE_EVENT => + Trace_Output ("DBGEXT param 18 - Disable Event"); + Disable_Event + (Control_Block.Flags, + Control_Block.Event_Value_or_Name, + Control_Block.Event_Code_or_EVCB, + Control_Block.Status); + + return SS_NORMAL; + + -- Announce the occurence of a DEBUG tasking event + + when K_ANNOUNCE_EVENT => + Trace_Output ("DBGEXT param 19 - Announce Event"); + Announce_Event + (Control_Block.Event_Code_or_EVCB, + Print_Routine); + + Control_Block.Status := K_SUCCESS; + return SS_NORMAL; + + -- After DEBUG has processed an event that has signalled, + -- the signaller must cleanup. + -- Cleanup consists of freeing the event control block. + + when K_CLEANUP_EVENT => + Trace_Output ("DBGEXT param 24 - Cleanup Event"); + Cleanup_Event (Control_Block.Event_Code_or_EVCB); + + Control_Block.Status := K_SUCCESS; + return SS_NORMAL; + + -- Show what events are available + + when K_SHOW_EVENT_DEF => + Trace_Output ("DBGEXT param 25 - Show Event Def"); + Show_Event (Print_Routine); + + Control_Block.Status := K_SUCCESS; + return SS_NORMAL; + + -- Convert an event code to the address of the event entry + + when K_FIND_EVENT_BY_CODE => + Trace_Output ("DBGEXT param 29 - Find Event by Code"); + Find_Event_By_Code + (Control_Block.Event_Code_or_EVCB, + Control_Block.Event_Entry, + Control_Block.Status); + + return SS_NORMAL; + + -- Find an event entry given the event name + + when K_FIND_EVENT_BY_NAME => + Trace_Output ("DBGEXT param 30 - Find Event by Name"); + Find_Event_By_Name + (Control_Block.Event_Value_or_Name, + Control_Block.Event_Entry, + Control_Block.Status); + return SS_NORMAL; + + -- ??? To do: Implement priority events + -- Get, set or restore a task's priority + + when K_GET_PRIORITY or K_SET_PRIORITY or K_RESTORE_PRIORITY => + Trace_Output ("DBGEXT priority param - Not yet implemented"); + Trace_Output (Function_Codes'Image + (Control_Block.Function_Code)); + return SS_BADPARAM; + + -- ??? To do: Implement show statistics event + -- Display task statistics + + when K_SHOW_STAT => + Trace_Output ("DBGEXT show stat param - Not yet implemented"); + Trace_Output (Function_Codes'Image + (Control_Block.Function_Code)); + return SS_BADPARAM; + + -- ??? To do: Implement get caller event + -- Obtain the caller of a task in a rendezvous. If no rendezvous, + -- null is returned + + when K_GET_CALLER => + Trace_Output ("DBGEXT get caller param - Not yet implemented"); + Trace_Output (Function_Codes'Image + (Control_Block.Function_Code)); + return SS_BADPARAM; + + -- ??? To do: Implement set terminate event + -- Terminate a task + + when K_SET_ABORT => + Trace_Output ("DBGEXT set terminate param - Not yet implemented"); + Trace_Output (Function_Codes'Image + (Control_Block.Function_Code)); + return SS_BADPARAM; + + -- ??? To do: Implement show deadlock event + -- Detect a deadlock + + when K_SHOW_DEADLOCK => + Trace_Output ("DBGEXT show deadlock param - Not yet implemented"); + Trace_Output (Function_Codes'Image + (Control_Block.Function_Code)); + return SS_BADPARAM; + + when others => + Trace_Output ("DBGEXT bad param: "); + Trace_Output (Function_Codes'Image + (Control_Block.Function_Code)); + return SS_BADPARAM; + + end case; + end DBGEXT; + + --------------------------- + -- Default_Print_Routine -- + --------------------------- + + procedure Default_Print_Routine + (Print_Function : Print_Functions; + Print_Subfunction : Print_Functions; + P1 : Unsigned_Longword := 0; + P2 : Unsigned_Longword := 0; + P3 : Unsigned_Longword := 0; + P4 : Unsigned_Longword := 0; + P5 : Unsigned_Longword := 0; + P6 : Unsigned_Longword := 0) + is + Status : Cond_Value_Type; + Linlen : Unsigned_Word; + Item_List : Unsigned_Longword_Array (1 .. 17) := + (1 .. 17 => 0); + begin + + case Print_Function is + when Print_Control | Print_String => + null; + + -- Formatted Ascii Output + + when Print_FAO => + Item_List (1) := P2; + Item_List (2) := P3; + Item_List (3) := P4; + Item_List (4) := P5; + Item_List (5) := P6; + FAOL + (Status, + To_AASCIC (P1).Text, + Linlen, + Print_Routine_Linbuf + (1 + Print_Routine_Bufcnt .. Print_Routine_Bufsiz), + Item_List); + + Print_Routine_Bufcnt := Print_Routine_Bufcnt + Integer (Linlen); + + -- Symbolic output + + when Print_Symbol => + Item_List (1) := P1; + FAOL + (Status, + "!XI", + Linlen, + Print_Routine_Linbuf + (1 + Print_Routine_Bufcnt .. Print_Routine_Bufsiz), + Item_List); + + Print_Routine_Bufcnt := Print_Routine_Bufcnt + Integer (Linlen); + + when others => + null; + end case; + + case Print_Subfunction is + + -- Output buffer with a terminating newline + + when Print_Newline => + Put_Output (Status, + Print_Routine_Linbuf (1 .. Print_Routine_Bufcnt)); + Print_Routine_Bufcnt := 0; + + -- Buffer the output + + when No_Print => + null; + + when others => + null; + end case; + + end Default_Print_Routine; + + ------------------- + -- Disable_Event -- + ------------------- + + procedure Disable_Event + (Flags : Bit_Array_32; + Event_Value : Unsigned_Longword; + Event_Code : Unsigned_Longword; + Status : out Cond_Value_Type) + is + Task_Value : Task_Id; + Task_Index : constant Integer := Integer (Event_Value) - 1; + begin + + Events_Enabled_Count := Events_Enabled_Count - 1; + + if Flags (V_EVNT_ALL) then + Global_Task_Debug_Events (Integer (Event_Code)) := False; + Status := K_SUCCESS; + else + if Task_Index in Known_Tasks'Range then + Task_Value := Known_Tasks (Task_Index); + if Task_Value /= null then + Task_Value.Common.Debug_Events (Integer (Event_Code)) := False; + Status := K_SUCCESS; + else + Status := K_TASK_NOT_EXIST; + end if; + else + Status := K_TASK_NOT_EXIST; + end if; + end if; + + -- Keep count of events for efficiency + + if Events_Enabled_Count <= 0 then + Events_Enabled_Count := 0; + Global_Task_Debug_Event_Set := False; + end if; + + end Disable_Event; + + ---------- + -- DoAC -- + ---------- + + function DoAC (S : String) return Address is + begin + AC_Buffer.Count := S'Length; + AC_Buffer.Text (1 .. AC_Buffer.Count) := S; + return AC_Buffer'Address; + end DoAC; + + ------------------ + -- Enable_Event -- + ------------------ + + procedure Enable_Event + (Flags : Bit_Array_32; + Event_Value : Unsigned_Longword; + Event_Code : Unsigned_Longword; + Status : out Cond_Value_Type) + is + Task_Value : Task_Id; + Task_Index : constant Integer := Integer (Event_Value) - 1; + begin + + -- At least one event enabled, any and all events will cause a + -- condition to be raised and checked. Major tasking slowdown! + + Global_Task_Debug_Event_Set := True; + Events_Enabled_Count := Events_Enabled_Count + 1; + + if Flags (V_EVNT_ALL) then + Global_Task_Debug_Events (Integer (Event_Code)) := True; + Status := K_SUCCESS; + else + if Task_Index in Known_Tasks'Range then + Task_Value := Known_Tasks (Task_Index); + if Task_Value /= null then + Task_Value.Common.Debug_Events (Integer (Event_Code)) := True; + Status := K_SUCCESS; + else + Status := K_TASK_NOT_EXIST; + end if; + else + Status := K_TASK_NOT_EXIST; + end if; + end if; + + end Enable_Event; + + ------------------------ + -- Find_Event_By_Code -- + ------------------------ + + procedure Find_Event_By_Code + (Event_Code : Unsigned_Longword; + Event_Entry : out Unsigned_Longword; + Status : out Cond_Value_Type) + is + K_SUCCESS : constant := 1; + K_NO_SUCH_EVENT : constant := 9; + + begin + Trace_Output ("Looking for Event: "); + Trace_Output (Unsigned_Longword'Image (Event_Code)); + + for I in Event_Kind_Type'Range loop + if Event_Code = Unsigned_Longword (Event_Directory (I).Code) then + Event_Entry := To_UL (Event_Directory (I)'Address); + Trace_Output ("Found Event # "); + Trace_Output (Integer'Image (I)); + Status := K_SUCCESS; + return; + end if; + end loop; + + Status := K_NO_SUCH_EVENT; + end Find_Event_By_Code; + + ------------------------ + -- Find_Event_By_Name -- + ------------------------ + + procedure Find_Event_By_Name + (Event_Name : Unsigned_Longword; + Event_Entry : out Unsigned_Longword; + Status : out Cond_Value_Type) + is + K_SUCCESS : constant := 1; + K_NO_SUCH_EVENT : constant := 9; + + Event_Name_Cstr : constant ASCIC := To_AASCIC (Event_Name).all; + begin + Trace_Output ("Looking for Event: "); + Trace_Output (Event_Name_Cstr.Text); + + for I in Event_Kind_Type'Range loop + if Event_Name_Cstr.Count >= Event_Directory (I).Minchr + and then Event_Name_Cstr.Count <= Event_Directory (I).Name.Count + and then Event_Name_Cstr.Text (1 .. Event_Directory (I).Minchr) = + Event_Directory (I).Name.Text (1 .. Event_Directory (I).Minchr) + then + Event_Entry := To_UL (Event_Directory (I)'Address); + Trace_Output ("Found Event # "); + Trace_Output (Integer'Image (I)); + Status := K_SUCCESS; + return; + end if; + end loop; + + Status := K_NO_SUCH_EVENT; + end Find_Event_By_Name; + + -------------------- + -- Get_User_State -- + -------------------- + + function Get_User_State return Long_Integer is + begin + return STPO.Self.User_State; + end Get_User_State; + + ------------------------ + -- List_Entry_Waiters -- + ------------------------ + + procedure List_Entry_Waiters + (Task_Value : Task_Id; + Full_Display : Boolean := False; + Suppress_Header : Boolean := False; + Print_Routine : Print_Routine_Type := Default_Print_Routine'Access) + is + pragma Unreferenced (Suppress_Header); + + Entry_Call : Entry_Call_Link; + Have_Some : Boolean := False; + begin + if not Full_Display then + return; + end if; + + if Task_Value.Entry_Queues'Length > 0 then + Print_Routine (Print_FAO, Print_Newline, + To_UL (DoAC (" Waiting entry callers:"))); + end if; + for I in Task_Value.Entry_Queues'Range loop + Entry_Call := Task_Value.Entry_Queues (I).Head; + if Entry_Call /= null then + Have_Some := True; + + Print_Routine (Print_FAO, Print_Newline, + To_UL (DoAC (" Waiters for entry !UI:")), + To_UL (I)); + + loop + declare + Task_Image : ASCIC := + (Entry_Call.Self.Common.Task_Image_Len, + Entry_Call.Self.Common.Task_Image + (1 .. Entry_Call.Self.Common.Task_Image_Len)); + begin + Print_Routine (Print_FAO, Print_Newline, + To_UL (DoAC (" %TASK !UI, type: !AC")), + To_UL (Entry_Call.Self.Known_Tasks_Index + 1), + To_UL (Task_Image'Address)); + if Entry_Call = Task_Value.Entry_Queues (I).Tail then + exit; + end if; + Entry_Call := Entry_Call.Next; + end; + end loop; + end if; + end loop; + if not Have_Some then + Print_Routine (Print_FAO, Print_Newline, + To_UL (DoAC (" none."))); + end if; + end List_Entry_Waiters; + + ---------------- + -- List_Tasks -- + ---------------- + + procedure List_Tasks is + C : Task_Id; + begin + C := All_Tasks_List; + + while C /= null loop + Print_Task_Info (C); + C := C.Common.All_Tasks_Link; + end loop; + end List_Tasks; + + ------------------------ + -- Print_Current_Task -- + ------------------------ + + procedure Print_Current_Task is + begin + Print_Task_Info (STPO.Self); + end Print_Current_Task; + + --------------------- + -- Print_Task_Info -- + --------------------- + + procedure Print_Task_Info (T : Task_Id) is + Entry_Call : Entry_Call_Link; + Parent : Task_Id; + + begin + if T = null then + Put_Line ("null task"); + return; + end if; + + Put (T.Common.Task_Image (1 .. T.Common.Task_Image_Len) & ": " & + Task_States'Image (T.Common.State)); + + Parent := T.Common.Parent; + + if Parent = null then + Put (", parent: <none>"); + else + Put (", parent: " & + Parent.Common.Task_Image (1 .. Parent.Common.Task_Image_Len)); + end if; + + Put (", prio:" & T.Common.Current_Priority'Img); + + if not T.Callable then + Put (", not callable"); + end if; + + if T.Aborting then + Put (", aborting"); + end if; + + if T.Deferral_Level /= 0 then + Put (", abort deferred"); + end if; + + if T.Common.Call /= null then + Entry_Call := T.Common.Call; + Put (", serving:"); + + while Entry_Call /= null loop + Put (To_Integer (Entry_Call.Self)'Img); + Entry_Call := Entry_Call.Acceptor_Prev_Call; + end loop; + end if; + + if T.Open_Accepts /= null then + Put (", accepting:"); + + for J in T.Open_Accepts'Range loop + Put (T.Open_Accepts (J).S'Img); + end loop; + + if T.Terminate_Alternative then + Put (" or terminate"); + end if; + end if; + + if T.User_State /= 0 then + Put (", state:" & T.User_State'Img); + end if; + + Put_Line; + end Print_Task_Info; + + --------- + -- Put -- + --------- + + procedure Put (S : String) is + begin + Write (2, S, S'Length); + end Put; + + -------------- + -- Put_Line -- + -------------- + + procedure Put_Line (S : String := "") is + begin + Write (2, S & ASCII.LF, S'Length + 1); + end Put_Line; + + ---------------------- + -- Resume_All_Tasks -- + ---------------------- + + procedure Resume_All_Tasks (Thread_Self : OS_Interface.Thread_Id) is + pragma Unreferenced (Thread_Self); + begin + null; -- VxWorks + end Resume_All_Tasks; + + --------------- + -- Set_Trace -- + --------------- + + procedure Set_Trace (Flag : Character; Value : Boolean := True) is + begin + Trace_On (Flag) := Value; + end Set_Trace; + + -------------------- + -- Set_User_State -- + -------------------- + + procedure Set_User_State (Value : Long_Integer) is + begin + STPO.Self.User_State := Value; + end Set_User_State; + + ---------------- + -- Show_Event -- + ---------------- + + procedure Show_Event + (Print_Routine : Print_Routine_Type := Default_Print_Routine'Access) + is + begin + for I in Event_Def_Help'Range loop + Print_Routine (Print_FAO, Print_Newline, To_UL (Event_Def_Help (I))); + end loop; + + for I in Event_Kind_Type'Range loop + Print_Routine (Print_FAO, Print_Newline, + To_UL (Event_Directory + (Global_Event_Display_Order (I)).Name'Address)); + Print_Routine (Print_FAO, Print_Newline, + To_UL (Event_Directory (Global_Event_Display_Order (I)).Help)); + end loop; + end Show_Event; + + -------------------- + -- Show_One_Task -- + -------------------- + + procedure Show_One_Task + (Task_Value : Task_Id; + Full_Display : Boolean := False; + Suppress_Header : Boolean := False; + Print_Routine : Print_Routine_Type := Default_Print_Routine'Access) + is + Task_SP : System.Address := Address_Zero; + Stack_Base : System.Address := Address_Zero; + Stack_Top : System.Address := Address_Zero; + TCB_Size : Unsigned_Longword := 0; + CMA_TCB_Size : Unsigned_Longword := 0; + Stack_Guard_Size : Unsigned_Longword := 0; + Total_Task_Storage : Unsigned_Longword := 0; + Stack_In_Use : Unsigned_Longword := 0; + Reserved_Size : Unsigned_Longword := 0; + Hold_Flag : Unsigned_Longword := 0; + Sched_State : Unsigned_Longword := 0; + User_Prio : Unsigned_Longword := 0; + Stack_Size : Unsigned_Longword := 0; + Run_State : Boolean := False; + Rea_State : Boolean := False; + Sus_State : Boolean := False; + Ter_State : Boolean := False; + + Current_Flag : AASCIC := NoStar; + Hold_String : AASCIC := NoHold; + Ada_State : AASCIC := Ada_State_Invalid_State; + Debug_State : AASCIC := Debug_State_Emp; + + Ada_State_Len : constant Unsigned_Longword := 17; + Debug_State_Len : constant Unsigned_Longword := 5; + + Entry_Call : Entry_Call_Record; + + begin + + -- Initialize local task info variables + + Task_SP := Address_Zero; + Stack_Base := Address_Zero; + Stack_Top := Address_Zero; + CMA_TCB_Size := 0; + Stack_Guard_Size := 0; + Reserved_Size := 0; + Hold_Flag := 0; + Sched_State := 0; + TCB_Size := Unsigned_Longword (Task_Id'Size); + + if not Suppress_Header or else Full_Display then + Print_Routine (Print_FAO, Print_Newline, To_UL (Empty_Text)); + Print_Routine (Print_FAO, Print_Newline, To_UL (Header)); + end if; + + Trace_Output ("Show_One_Task Task Value: "); + Trace_Output (Unsigned_Longword'Image (To_UL (Task_Value))); + + -- Callback to DEBUG to get some task info + + if Task_Value.Common.State /= Terminated then + Debug_Get + (STPO.Get_Thread_Id (Task_Value), + CMA_C_DEBGET_STACKPTR, + Task_SP, + 8); + + Debug_Get + (STPO.Get_Thread_Id (Task_Value), + CMA_C_DEBGET_TCB_SIZE, + CMA_TCB_Size, + 4); + + Debug_Get + (STPO.Get_Thread_Id (Task_Value), + CMA_C_DEBGET_GUARDSIZE, + Stack_Guard_Size, + 4); + + Debug_Get + (STPO.Get_Thread_Id (Task_Value), + CMA_C_DEBGET_YELLOWSIZE, + Reserved_Size, + 4); + + Debug_Get + (STPO.Get_Thread_Id (Task_Value), + CMA_C_DEBGET_STACK_BASE, + Stack_Base, + 8); + + Debug_Get + (STPO.Get_Thread_Id (Task_Value), + CMA_C_DEBGET_STACK_TOP, + Stack_Top, + 8); + + Stack_Size := Unsigned_Longword (Stack_Base - Stack_Top) + - Reserved_Size - Stack_Guard_Size; + Stack_In_Use := Unsigned_Longword (Stack_Base - Task_SP) + 4; + Total_Task_Storage := TCB_Size + Stack_Size + Stack_Guard_Size + + Reserved_Size + CMA_TCB_Size; + + Debug_Get + (STPO.Get_Thread_Id (Task_Value), + CMA_C_DEBGET_IS_HELD, + Hold_Flag, + 4); + + Hold_String := (if Hold_Flag /= 0 then Hold else NoHold); + + Debug_Get + (STPO.Get_Thread_Id (Task_Value), + CMA_C_DEBGET_SCHED_STATE, + Sched_State, + 4); + end if; + + Run_State := False; + Rea_State := False; + Sus_State := Task_Value.Common.State = Unactivated; + Ter_State := Task_Value.Common.State = Terminated; + + if not Ter_State then + Run_State := Sched_State = 0; + Rea_State := Sched_State = 1; + Sus_State := Sched_State /= 0 and Sched_State /= 1; + end if; + + -- Set the debug state + + if Run_State then + Debug_State := Debug_State_Run; + elsif Rea_State then + Debug_State := Debug_State_Rea; + elsif Sus_State then + Debug_State := Debug_State_Sus; + elsif Ter_State then + Debug_State := Debug_State_Ter; + end if; + + Trace_Output ("Before case State: "); + Trace_Output (Task_States'Image (Task_Value.Common.State)); + + -- Set the Ada state + + case Task_Value.Common.State is + when Unactivated => + Ada_State := Ada_State_Not_Yet_Activated; + + when Activating => + Ada_State := Ada_State_Activating; + + when Runnable => + Ada_State := Ada_State_Runnable; + + when Terminated => + Ada_State := Ada_State_Terminated; + + when Activator_Sleep => + Ada_State := Ada_State_Activating_Tasks; + + when Acceptor_Sleep => + Ada_State := Ada_State_Accept; + + when Acceptor_Delay_Sleep => + Ada_State := Ada_State_Select_or_Delay; + + when Entry_Caller_Sleep => + Entry_Call := + Task_Value.Entry_Calls (Task_Value.ATC_Nesting_Level); + + case Entry_Call.Mode is + when Simple_Call => + Ada_State := Ada_State_Entry_Call; + when Conditional_Call => + Ada_State := Ada_State_Cond_Entry_Call; + when Timed_Call => + Ada_State := Ada_State_Timed_Entry_Call; + when Asynchronous_Call => + Ada_State := Ada_State_Async_Entry_Call; + end case; + + when Async_Select_Sleep => + Ada_State := Ada_State_Select_or_Abort; + + when Delay_Sleep => + Ada_State := Ada_State_Delay; + + when Master_Completion_Sleep => + Ada_State := Ada_State_Completed; + + when Master_Phase_2_Sleep => + Ada_State := Ada_State_Completed; + + when Interrupt_Server_Idle_Sleep | + Interrupt_Server_Blocked_Interrupt_Sleep | + Timer_Server_Sleep | + Interrupt_Server_Blocked_On_Event_Flag => + Ada_State := Ada_State_Server; + + when AST_Server_Sleep => + Ada_State := Ada_State_IO_or_AST; + + when Asynchronous_Hold => + Ada_State := Ada_State_Async_Hold; + + end case; + + if Task_Value.Terminate_Alternative then + Ada_State := Ada_State_Select_or_Term; + end if; + + if Task_Value.Aborting then + Ada_State := Ada_State_Aborting; + end if; + + User_Prio := To_UL (Task_Value.Common.Current_Priority); + Trace_Output ("After user_prio"); + + -- Flag the current task + + Current_Flag := (if Task_Value = Self then Star else NoStar); + + -- Show task info + + Print_Routine (Print_FAO, No_Print, To_UL (DoAC ("!AC%TASK !5<!UI!>")), + To_UL (Current_Flag), To_UL (Task_Value.Known_Tasks_Index + 1)); + + Print_Routine (Print_FAO, No_Print, To_UL (DoAC ("!2UB")), User_Prio); + + Print_Routine (Print_FAO, No_Print, To_UL (DoAC (" !AC !5AD !17AD ")), + To_UL (Hold_String), Debug_State_Len, To_UL (Debug_State), + Ada_State_Len, To_UL (Ada_State)); + +-- Print_Routine (Print_Symbol, Print_Newline, +-- Fetch (To_Addr (Task_Value.Common.Task_Entry_Point))); + + Print_Routine (Print_FAO, Print_Newline, To_UL (Empty_Text)); + + -- If /full qualfier passed, show detailed info + + if Full_Display then + Show_Rendezvous (Task_Value, Ada_State, Full_Display, + Suppress_Header, Print_Routine); + + List_Entry_Waiters (Task_Value, Full_Display, + Suppress_Header, Print_Routine); + + Print_Routine (Print_FAO, Print_Newline, To_UL (Empty_Text)); + + declare + Task_Image : ASCIC := (Task_Value.Common.Task_Image_Len, + Task_Value.Common.Task_Image + (1 .. Task_Value.Common.Task_Image_Len)); + begin + Print_Routine (Print_FAO, Print_Newline, + To_UL (DoAC (" Task type: !AC")), + To_UL (Task_Image'Address)); + end; + + -- How to find Creation_PC ??? +-- Print_Routine (Print_FAO, No_Print, +-- To_UL (DoAC (" Created at PC: ")), +-- Print_Routine (Print_FAO, Print_Newline, Creation_PC); + + if Task_Value.Common.Parent /= null then + Print_Routine (Print_FAO, Print_Newline, + To_UL (DoAC (" Parent task: %TASK !UI")), + To_UL (Task_Value.Common.Parent.Known_Tasks_Index + 1)); + else + Print_Routine (Print_FAO, Print_Newline, + To_UL (DoAC (" Parent task: none"))); + end if; + +-- Print_Routine (Print_FAO, No_Print, +-- To_UL (DoAC (" Start PC: "))); +-- Print_Routine (Print_Symbol, Print_Newline, +-- Fetch (To_Addr (Task_Value.Common.Task_Entry_Point))); + + Print_Routine (Print_FAO, Print_Newline, + To_UL (DoAC ( + " Task control block: Stack storage (bytes):"))); + + Print_Routine (Print_FAO, Print_Newline, + To_UL (DoAC ( + " Task value: !10<!UI!> RESERVED_BYTES: !10UI")), + To_UL (Task_Value), Reserved_Size); + + Print_Routine (Print_FAO, Print_Newline, + To_UL (DoAC ( + " Entries: !10<!UI!> TOP_GUARD_SIZE: !10UI")), + To_UL (Task_Value.Entry_Num), Stack_Guard_Size); + + Print_Routine (Print_FAO, Print_Newline, + To_UL (DoAC ( + " Size: !10<!UI!> STORAGE_SIZE: !10UI")), + TCB_Size + CMA_TCB_Size, Stack_Size); + + Print_Routine (Print_FAO, Print_Newline, + To_UL (DoAC ( + " Stack addresses: Bytes in use: !10UI")), + Stack_In_Use); + + Print_Routine (Print_FAO, Print_Newline, + To_UL (DoAC (" Top address: !10<!XI!>")), + To_UL (Stack_Top)); + + Print_Routine (Print_FAO, Print_Newline, + To_UL (DoAC ( + " Base address: !10<!XI!> Total storage: !10UI")), + To_UL (Stack_Base), Total_Task_Storage); + end if; + + end Show_One_Task; + + --------------------- + -- Show_Rendezvous -- + --------------------- + + procedure Show_Rendezvous + (Task_Value : Task_Id; + Ada_State : AASCIC := Empty_Text; + Full_Display : Boolean := False; + Suppress_Header : Boolean := False; + Print_Routine : Print_Routine_Type := Default_Print_Routine'Access) + is + pragma Unreferenced (Ada_State); + pragma Unreferenced (Suppress_Header); + + Temp_Entry : Entry_Index; + Entry_Call : Entry_Call_Record; + Called_Task : Task_Id; + AWR : constant String := " Awaiting rendezvous at: "; + -- Common prefix + + procedure Print_Accepts; + -- Display information about task rendezvous accepts + + procedure Print_Accepts is + begin + if Task_Value.Open_Accepts /= null then + for I in Task_Value.Open_Accepts'Range loop + Temp_Entry := Entry_Index (Task_Value.Open_Accepts (I).S); + declare + Entry_Name_Image : ASCIC := + (Task_Value.Entry_Names (Temp_Entry).all'Length, + Task_Value.Entry_Names (Temp_Entry).all); + begin + Trace_Output ("Accept at: " & Entry_Name_Image.Text); + Print_Routine (Print_FAO, Print_Newline, + To_UL (DoAC (" accept at: !AC")), + To_UL (Entry_Name_Image'Address)); + end; + end loop; + end if; + end Print_Accepts; + begin + if not Full_Display then + return; + end if; + + Trace_Output ("Show_Rendezvous Task Value: "); + Trace_Output (Unsigned_Longword'Image (To_UL (Task_Value))); + + if Task_Value.Common.State = Acceptor_Sleep and then + not Task_Value.Terminate_Alternative + then + if Task_Value.Open_Accepts /= null then + Temp_Entry := Entry_Index (Task_Value.Open_Accepts + (Task_Value.Open_Accepts'First).S); + declare + Entry_Name_Image : ASCIC := + (Task_Value.Entry_Names (Temp_Entry).all'Length, + Task_Value.Entry_Names (Temp_Entry).all); + begin + Trace_Output (AWR & "accept " & Entry_Name_Image.Text); + Print_Routine (Print_FAO, Print_Newline, + To_UL (DoAC (AWR & "accept !AC")), + To_UL (Entry_Name_Image'Address)); + end; + + else + Print_Routine (Print_FAO, Print_Newline, + To_UL (DoAC (" entry name unavailable"))); + end if; + else + case Task_Value.Common.State is + when Acceptor_Sleep => + Print_Routine (Print_FAO, Print_Newline, + To_UL (DoAC (AWR & "select with terminate."))); + Print_Accepts; + + when Async_Select_Sleep => + Print_Routine (Print_FAO, Print_Newline, + To_UL (DoAC (AWR & "select."))); + Print_Accepts; + + when Acceptor_Delay_Sleep => + Print_Routine (Print_FAO, Print_Newline, + To_UL (DoAC (AWR & "select with delay."))); + Print_Accepts; + + when Entry_Caller_Sleep => + Entry_Call := + Task_Value.Entry_Calls (Task_Value.ATC_Nesting_Level); + + case Entry_Call.Mode is + when Simple_Call => + Print_Routine (Print_FAO, Print_Newline, + To_UL (DoAC (AWR & "entry call"))); + when Conditional_Call => + Print_Routine (Print_FAO, Print_Newline, + To_UL (DoAC (AWR & "entry call with else"))); + when Timed_Call => + Print_Routine (Print_FAO, Print_Newline, + To_UL (DoAC (AWR & "entry call with delay"))); + when Asynchronous_Call => + Print_Routine (Print_FAO, Print_Newline, + To_UL (DoAC (AWR & "entry call with abort"))); + end case; + Called_Task := Entry_Call.Called_Task; + declare + Task_Image : ASCIC := (Called_Task.Common.Task_Image_Len, + Called_Task.Common.Task_Image + (1 .. Called_Task.Common.Task_Image_Len)); + Entry_Name_Image : ASCIC := + (Called_Task.Entry_Names (Entry_Call.E).all'Length, + Called_Task.Entry_Names (Entry_Call.E).all); + begin + Print_Routine (Print_FAO, Print_Newline, + To_UL (DoAC + (" for entry !AC in %TASK !UI type !AC")), + To_UL (Entry_Name_Image'Address), + To_UL (Called_Task.Known_Tasks_Index), + To_UL (Task_Image'Address)); + end; + + when others => + return; + end case; + end if; + + end Show_Rendezvous; + + ------------------------ + -- Signal_Debug_Event -- + ------------------------ + + procedure Signal_Debug_Event + (Event_Kind : Event_Kind_Type; Task_Value : Task_Id) + is + Do_Signal : Boolean; + EVCB : Ada_Event_Control_Block_Access; + + EVCB_Sent : constant := 16#9B#; + Ada_Facility : constant := 49; + SS_DBGEVENT : constant := 1729; + begin + Do_Signal := Global_Task_Debug_Events (Event_Kind); + + if not Do_Signal then + if Task_Value /= null then + Do_Signal := Do_Signal + or else Task_Value.Common.Debug_Events (Event_Kind); + end if; + end if; + + if Do_Signal then + -- Build an a tasking event control block and signal DEBUG + + EVCB := new Ada_Event_Control_Block_Type; + EVCB.Code := Unsigned_Word (Event_Kind); + EVCB.Sentinal := EVCB_Sent; + EVCB.Facility := Ada_Facility; + + if Task_Value /= null then + EVCB.Value := Unsigned_Longword (Task_Value.Known_Tasks_Index + 1); + else + EVCB.Value := 0; + end if; + + EVCB.Sub_Event := 0; + EVCB.P1 := 0; + EVCB.Sigargs := 0; + EVCB.Flags := 0; + EVCB.Unused1 := 0; + EVCB.Unused2 := 0; + + Signal (SS_DBGEVENT, 1, To_UL (EVCB)); + end if; + end Signal_Debug_Event; + + -------------------- + -- Stop_All_Tasks -- + -------------------- + + procedure Stop_All_Tasks is + begin + null; -- VxWorks + end Stop_All_Tasks; + + ---------------------------- + -- Stop_All_Tasks_Handler -- + ---------------------------- + + procedure Stop_All_Tasks_Handler is + begin + null; -- VxWorks + end Stop_All_Tasks_Handler; + + ----------------------- + -- Suspend_All_Tasks -- + ----------------------- + + procedure Suspend_All_Tasks (Thread_Self : OS_Interface.Thread_Id) is + pragma Unreferenced (Thread_Self); + begin + null; -- VxWorks + end Suspend_All_Tasks; + + ------------------------ + -- Task_Creation_Hook -- + ------------------------ + + procedure Task_Creation_Hook (Thread : OS_Interface.Thread_Id) is + pragma Unreferenced (Thread); + begin + null; -- VxWorks + end Task_Creation_Hook; + + --------------------------- + -- Task_Termination_Hook -- + --------------------------- + + procedure Task_Termination_Hook is + begin + null; -- VxWorks + end Task_Termination_Hook; + + ----------- + -- Trace -- + ----------- + + procedure Trace + (Self_Id : Task_Id; + Msg : String; + Flag : Character; + Other_Id : Task_Id := null) + is + begin + if Trace_On (Flag) then + Put (To_Integer (Self_Id)'Img & + ':' & Flag & ':' & + Self_Id.Common.Task_Image (1 .. Self_Id.Common.Task_Image_Len) & + ':'); + + if Other_Id /= null then + Put (To_Integer (Other_Id)'Img & ':'); + end if; + + Put_Line (Msg); + end if; + end Trace; + + ------------------ + -- Trace_Output -- + ------------------ + + procedure Trace_Output (Message_String : String) is + begin + if Trace_On ('V') and Trace_On ('M') and Trace_On ('S') then + Put_Output (Message_String); + end if; + end Trace_Output; + + ----------- + -- Write -- + ----------- + + procedure Write (Fd : Integer; S : String; Count : Integer) is + Discard : System.CRTL.ssize_t; + pragma Unreferenced (Discard); + begin + Discard := System.CRTL.write (Fd, S (S'First)'Address, + System.CRTL.size_t (Count)); + -- Is it really right to ignore write errors here ??? + end Write; + +end System.Tasking.Debug; |