+++ /dev/null
-------------------------------------------------------------------------------
--- --
--- GNU ADA RUN-TIME LIBRARY (GNARL) COMPONENTS --
--- --
--- S Y S T E M . T A S K _ P R I M I T I V E S . O P E R A T I O N S --
--- --
--- B o d y --
--- --
--- $Revision: 1.2 $
--- --
--- Copyright (C) 1991-2001, Florida State University --
--- --
--- GNARL 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 2, or (at your option) any later ver- --
--- sion. GNARL 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. See the GNU General Public License --
--- for more details. You should have received a copy of the GNU General --
--- Public License distributed with GNARL; see file COPYING. If not, write --
--- to the Free Software Foundation, 59 Temple Place - Suite 330, Boston, --
--- MA 02111-1307, USA. --
--- --
--- As a special exception, if other files instantiate generics from this --
--- unit, or you link this unit with other files to produce an executable, --
--- this unit does not by itself cause the resulting executable to be --
--- covered by the GNU General Public License. This exception does not --
--- however invalidate any other reasons why the executable file might be --
--- covered by the GNU Public License. --
--- --
--- GNARL was developed by the GNARL team at Florida State University. It is --
--- now maintained by Ada Core Technologies Inc. in cooperation with Florida --
--- State University (http://www.gnat.com). --
--- --
-------------------------------------------------------------------------------
-
--- This is a Solaris (native) version of this package
-
--- This package contains all the GNULL primitives that interface directly
--- with the underlying OS.
-
-pragma Polling (Off);
--- Turn off polling, we do not want ATC polling to take place during
--- tasking operations. It causes infinite loops and other problems.
-
-with System.Tasking.Debug;
--- used for Known_Tasks
-
-with Ada.Exceptions;
--- used for Raise_Exception
-
-with GNAT.OS_Lib;
--- used for String_Access, Getenv
-
-with Interfaces.C;
--- used for int
--- size_t
-
-with System.Interrupt_Management;
--- used for Keep_Unmasked
--- Abort_Task_Interrupt
--- Interrupt_ID
-
-with System.Interrupt_Management.Operations;
--- used for Set_Interrupt_Mask
--- All_Tasks_Mask
-pragma Elaborate_All (System.Interrupt_Management.Operations);
-
-with System.Parameters;
--- used for Size_Type
-
-with System.Tasking;
--- used for Ada_Task_Control_Block
--- Task_ID
--- ATCB components and types
-
-with System.Task_Info;
--- to initialize Task_Info for a C thread, in function Self
-
-with System.Soft_Links;
--- used for Defer/Undefer_Abort
--- to initialize TSD for a C thread, in function Self
-
--- Note that we do not use System.Tasking.Initialization directly since
--- this is a higher level package that we shouldn't depend on. For example
--- when using the restricted run time, it is replaced by
--- System.Tasking.Restricted.Initialization
-
-with System.OS_Primitives;
--- used for Delay_Modes
-
-with Unchecked_Conversion;
-with Unchecked_Deallocation;
-
-package body System.Task_Primitives.Operations is
-
- use System.Tasking.Debug;
- use System.Tasking;
- use Interfaces.C;
- use System.OS_Interface;
- use System.Parameters;
- use Ada.Exceptions;
- use System.OS_Primitives;
-
- package SSL renames System.Soft_Links;
-
- ------------------
- -- Local Data --
- ------------------
-
- ATCB_Magic_Code : constant := 16#ADAADAAD#;
- -- This is used to allow us to catch attempts to call Self
- -- from outside an Ada task, with high probability.
- -- For an Ada task, Task_Wrapper.Magic_Number = ATCB_Magic_Code.
-
- -- The following are logically constants, but need to be initialized
- -- at run time.
-
- Environment_Task_ID : Task_ID;
- -- A variable to hold Task_ID for the environment task.
- -- If we use this variable to get the Task_ID, we need the following
- -- ATCB_Key only for non-Ada threads.
-
- Unblocked_Signal_Mask : aliased sigset_t;
- -- The set of signals that should unblocked in all tasks
-
- ATCB_Key : aliased thread_key_t;
- -- Key used to find the Ada Task_ID associated with a thread,
- -- at least for C threads unknown to the Ada run-time system.
-
- All_Tasks_L : aliased System.Task_Primitives.RTS_Lock;
- -- See comments on locking rules in System.Tasking (spec).
-
- Next_Serial_Number : Task_Serial_Number := 100;
- -- We start at 100, to reserve some special values for
- -- using in error checking.
- -- The following are internal configuration constants needed.
-
- ------------------------
- -- Priority Support --
- ------------------------
-
- Dynamic_Priority_Support : constant Boolean := True;
- -- controls whether we poll for pending priority changes during sleeps
-
- Priority_Ceiling_Emulation : constant Boolean := True;
- -- controls whether we emulate priority ceiling locking
-
- -- To get a scheduling close to annex D requirements, we use the real-time
- -- class provided for LWP's and map each task/thread to a specific and
- -- unique LWP (there is 1 thread per LWP, and 1 LWP per thread).
-
- -- The real time class can only be set when the process has root
- -- priviledges, so in the other cases, we use the normal thread scheduling
- -- and priority handling.
-
- Using_Real_Time_Class : Boolean := False;
- -- indicates wether the real time class is being used (i.e the process
- -- has root priviledges).
-
- Prio_Param : aliased struct_pcparms;
- -- Hold priority info (Real_Time) initialized during the package
- -- elaboration.
-
- -------------------------------------
- -- External Configuration Values --
- -------------------------------------
-
- Time_Slice_Val : Interfaces.C.long;
- pragma Import (C, Time_Slice_Val, "__gl_time_slice_val");
-
- Locking_Policy : Character;
- pragma Import (C, Locking_Policy, "__gl_locking_policy");
-
- Dispatching_Policy : Character;
- pragma Import (C, Dispatching_Policy, "__gl_task_dispatching_policy");
-
- --------------------------------
- -- Foreign Threads Detection --
- --------------------------------
-
- -- The following are used to allow the Self function to
- -- automatically generate ATCB's for C threads that happen to call
- -- Ada procedure, which in turn happen to call the Ada run-time system.
-
- type Fake_ATCB;
- type Fake_ATCB_Ptr is access Fake_ATCB;
- type Fake_ATCB is record
- Stack_Base : Interfaces.C.unsigned := 0;
- -- A value of zero indicates the node is not in use.
- Next : Fake_ATCB_Ptr;
- Real_ATCB : aliased Ada_Task_Control_Block (0);
- end record;
-
- Fake_ATCB_List : Fake_ATCB_Ptr;
- -- A linear linked list.
- -- The list is protected by All_Tasks_L;
- -- Nodes are added to this list from the front.
- -- Once a node is added to this list, it is never removed.
-
- Fake_Task_Elaborated : aliased Boolean := True;
- -- Used to identified fake tasks (i.e., non-Ada Threads).
-
- Next_Fake_ATCB : Fake_ATCB_Ptr;
- -- Used to allocate one Fake_ATCB in advance. See comment in New_Fake_ATCB
-
- ------------
- -- Checks --
- ------------
-
- Check_Count : Integer := 0;
- Old_Owner : Task_ID;
- Lock_Count : Integer := 0;
- Unlock_Count : Integer := 0;
-
- function To_Lock_Ptr is
- new Unchecked_Conversion (RTS_Lock_Ptr, Lock_Ptr);
- function To_Task_ID is
- new Unchecked_Conversion (Owner_ID, Task_ID);
- function To_Owner_ID is
- new Unchecked_Conversion (Task_ID, Owner_ID);
-
- -----------------------
- -- Local Subprograms --
- -----------------------
-
- function sysconf (name : System.OS_Interface.int)
- return processorid_t;
- pragma Import (C, sysconf, "sysconf");
-
- SC_NPROCESSORS_CONF : constant System.OS_Interface.int := 14;
-
- function Num_Procs (name : System.OS_Interface.int := SC_NPROCESSORS_CONF)
- return processorid_t renames sysconf;
-
- procedure Abort_Handler
- (Sig : Signal;
- Code : access siginfo_t;
- Context : access ucontext_t);
-
- function To_thread_t is new Unchecked_Conversion
- (Integer, System.OS_Interface.thread_t);
-
- function To_Task_ID is new Unchecked_Conversion (System.Address, Task_ID);
-
- function To_Address is new Unchecked_Conversion (Task_ID, System.Address);
-
- type Ptr is access Task_ID;
- function To_Ptr is new Unchecked_Conversion (Interfaces.C.unsigned, Ptr);
- function To_Ptr is new Unchecked_Conversion (System.Address, Ptr);
-
- type Iptr is access Interfaces.C.unsigned;
- function To_Iptr is new Unchecked_Conversion (Interfaces.C.unsigned, Iptr);
-
- function Thread_Body_Access is
- new Unchecked_Conversion (System.Address, Thread_Body);
-
- function New_Fake_ATCB (Stack_Base : Interfaces.C.unsigned) return Task_ID;
- -- Allocate and Initialize a new ATCB. This code can safely be called from
- -- a foreign thread, as it doesn't access implicitly or explicitly
- -- "self" before having initialized the new ATCB.
-
- ------------
- -- Checks --
- ------------
-
- function Check_Initialize_Lock (L : Lock_Ptr; Level : Lock_Level)
- return Boolean;
- pragma Inline (Check_Initialize_Lock);
-
- function Check_Lock (L : Lock_Ptr) return Boolean;
- pragma Inline (Check_Lock);
-
- function Record_Lock (L : Lock_Ptr) return Boolean;
- pragma Inline (Record_Lock);
-
- function Check_Sleep (Reason : Task_States) return Boolean;
- pragma Inline (Check_Sleep);
-
- function Record_Wakeup
- (L : Lock_Ptr;
- Reason : Task_States) return Boolean;
- pragma Inline (Record_Wakeup);
-
- function Check_Wakeup
- (T : Task_ID;
- Reason : Task_States) return Boolean;
- pragma Inline (Check_Wakeup);
-
- function Check_Unlock (L : Lock_Ptr) return Boolean;
- pragma Inline (Check_Lock);
-
- function Check_Finalize_Lock (L : Lock_Ptr) return Boolean;
- pragma Inline (Check_Finalize_Lock);
-
- -------------------
- -- New_Fake_ATCB --
- -------------------
-
- function New_Fake_ATCB (Stack_Base : Interfaces.C.unsigned)
- return Task_ID
- is
- Self_ID : Task_ID;
- P, Q : Fake_ATCB_Ptr;
- Succeeded : Boolean;
- Result : Interfaces.C.int;
-
- begin
- -- This section is ticklish.
- -- We dare not call anything that might require an ATCB, until
- -- we have the new ATCB in place.
- -- Note: we don't use "Write_Lock (All_Tasks_L'Access);" because
- -- we don't yet have an ATCB, and so can't pass the safety check.
-
- Result := mutex_lock (All_Tasks_L.L'Access);
- Q := null;
- P := Fake_ATCB_List;
-
- while P /= null loop
- if P.Stack_Base = 0 then
- Q := P;
- elsif thr_kill (P.Real_ATCB.Common.LL.Thread, 0) /= 0 then
- -- ????
- -- If a C thread that has dependent Ada tasks terminates
- -- abruptly, e.g. as a result of cancellation, any dependent
- -- tasks are likely to hang up in termination.
- P.Stack_Base := 0;
- Q := P;
- end if;
-
- P := P.Next;
- end loop;
-
- if Q = null then
-
- -- Create a new ATCB with zero entries.
-
- Self_ID := Next_Fake_ATCB.Real_ATCB'Access;
- Next_Fake_ATCB.Stack_Base := Stack_Base;
- Next_Fake_ATCB.Next := Fake_ATCB_List;
- Fake_ATCB_List := Next_Fake_ATCB;
- Next_Fake_ATCB := null;
-
- else
-
- -- Reuse an existing fake ATCB.
-
- Self_ID := Q.Real_ATCB'Access;
- Q.Stack_Base := Stack_Base;
- end if;
-
- -- Do the standard initializations
-
- System.Tasking.Initialize_ATCB
- (Self_ID, null, Null_Address, Null_Task, Fake_Task_Elaborated'Access,
- System.Priority'First, Task_Info.Unspecified_Task_Info, 0, Self_ID,
- Succeeded);
- pragma Assert (Succeeded);
-
- -- Record this as the Task_ID for the current thread.
-
- Self_ID.Common.LL.Thread := thr_self;
- Result := thr_setspecific (ATCB_Key, To_Address (Self_ID));
- pragma Assert (Result = 0);
-
- -- Finally, it is safe to use an allocator in this thread.
-
- if Next_Fake_ATCB = null then
- Next_Fake_ATCB := new Fake_ATCB;
- end if;
-
- Self_ID.Master_of_Task := 0;
- Self_ID.Master_Within := Self_ID.Master_of_Task + 1;
-
- for L in Self_ID.Entry_Calls'Range loop
- Self_ID.Entry_Calls (L).Self := Self_ID;
- Self_ID.Entry_Calls (L).Level := L;
- end loop;
-
- Self_ID.Common.State := Runnable;
- Self_ID.Awake_Count := 1;
-
- -- Since this is not an ordinary Ada task, we will start out undeferred
-
- Self_ID.Deferral_Level := 0;
-
- -- Give the task a unique serial number.
-
- Self_ID.Serial_Number := Next_Serial_Number;
- Next_Serial_Number := Next_Serial_Number + 1;
- pragma Assert (Next_Serial_Number /= 0);
-
- System.Soft_Links.Create_TSD (Self_ID.Common.Compiler_Data);
-
- -- ????
- -- The following call is commented out to avoid dependence on
- -- the System.Tasking.Initialization package.
-
- -- It seems that if we want Ada.Task_Attributes to work correctly
- -- for C threads we will need to raise the visibility of this soft
- -- link to System.Soft_Links.
-
- -- We are putting that off until this new functionality is otherwise
- -- stable.
-
- -- System.Tasking.Initialization.Initialize_Attributes_Link.all (T);
-
- -- Must not unlock until Next_ATCB is again allocated.
-
- for J in Known_Tasks'Range loop
- if Known_Tasks (J) = null then
- Known_Tasks (J) := Self_ID;
- Self_ID.Known_Tasks_Index := J;
- exit;
- end if;
- end loop;
-
- Result := mutex_unlock (All_Tasks_L.L'Access);
-
- -- We cannot use "Unlock (All_Tasks_L'Access);" because
- -- we did not use Write_Lock, and so would not pass the checks.
-
- return Self_ID;
- end New_Fake_ATCB;
-
- -------------------
- -- Abort_Handler --
- -------------------
-
- -- Target-dependent binding of inter-thread Abort signal to
- -- the raising of the Abort_Signal exception.
-
- -- The technical issues and alternatives here are essentially
- -- the same as for raising exceptions in response to other
- -- signals (e.g. Storage_Error). See code and comments in
- -- the package body System.Interrupt_Management.
-
- -- Some implementations may not allow an exception to be propagated
- -- out of a handler, and others might leave the signal or
- -- interrupt that invoked this handler masked after the exceptional
- -- return to the application code.
-
- -- GNAT exceptions are originally implemented using setjmp()/longjmp().
- -- On most UNIX systems, this will allow transfer out of a signal handler,
- -- which is usually the only mechanism available for implementing
- -- asynchronous handlers of this kind. However, some
- -- systems do not restore the signal mask on longjmp(), leaving the
- -- abort signal masked.
-
- -- Alternative solutions include:
-
- -- 1. Change the PC saved in the system-dependent Context
- -- parameter to point to code that raises the exception.
- -- Normal return from this handler will then raise
- -- the exception after the mask and other system state has
- -- been restored (see example below).
- -- 2. Use siglongjmp()/sigsetjmp() to implement exceptions.
- -- 3. Unmask the signal in the Abortion_Signal exception handler
- -- (in the RTS).
-
- -- The following procedure would be needed if we can't longjmp out of
- -- a signal handler. (See below.)
-
- -- procedure Raise_Abort_Signal is
- -- begin
- -- raise Standard'Abort_Signal;
- -- end if;
-
- -- ???
- -- The comments above need revising. They are partly obsolete.
-
- procedure Abort_Handler
- (Sig : Signal;
- Code : access siginfo_t;
- Context : access ucontext_t)
- is
- Self_ID : Task_ID := Self;
- Result : Interfaces.C.int;
- Old_Set : aliased sigset_t;
-
- begin
- -- Assuming it is safe to longjmp out of a signal handler, the
- -- following code can be used:
-
- if Self_ID.Deferral_Level = 0
- and then Self_ID.Pending_ATC_Level < Self_ID.ATC_Nesting_Level
- and then not Self_ID.Aborting
- then
- -- You can comment the following out,
- -- to make all aborts synchronous, for debugging.
-
- Self_ID.Aborting := True;
-
- -- Make sure signals used for RTS internal purpose are unmasked
-
- Result := thr_sigsetmask (SIG_UNBLOCK,
- Unblocked_Signal_Mask'Unchecked_Access, Old_Set'Unchecked_Access);
- pragma Assert (Result = 0);
-
- raise Standard'Abort_Signal;
-
- -- ?????
- -- Must be certain that the implementation of "raise"
- -- does not make any OS/thread calls, or at least that
- -- if it makes any, they are safe for interruption by
- -- async. signals.
- end if;
-
- -- Otherwise, something like this is required:
- -- if not Abort_Is_Deferred.all then
- -- -- Overwrite the return PC address with the address of the
- -- -- special raise routine, and "return" to that routine's
- -- -- starting address.
- -- Context.PC := Raise_Abort_Signal'Address;
- -- return;
- -- end if;
-
- end Abort_Handler;
-
- -------------------
- -- Stack_Guard --
- -------------------
-
- -- The underlying thread system sets a guard page at the
- -- bottom of a thread stack, so nothing is needed.
-
- procedure Stack_Guard (T : ST.Task_ID; On : Boolean) is
- begin
- null;
- end Stack_Guard;
-
- --------------------
- -- Get_Thread_Id --
- --------------------
-
- function Get_Thread_Id (T : ST.Task_ID) return OSI.Thread_Id is
- begin
- return T.Common.LL.Thread;
- end Get_Thread_Id;
-
- -----------
- -- Self --
- -----------
-
- function Self return Task_ID is separate;
-
- ---------------------
- -- Initialize_Lock --
- ---------------------
-
- -- Note: mutexes and cond_variables needed per-task basis are
- -- initialized in Initialize_TCB and the Storage_Error is
- -- handled. Other mutexes (such as All_Tasks_L, Memory_Lock...)
- -- used in RTS is initialized before any status change of RTS.
- -- Therefore rasing Storage_Error in the following routines
- -- should be able to be handled safely.
-
- procedure Initialize_Lock
- (Prio : System.Any_Priority;
- L : access Lock)
- is
- Result : Interfaces.C.int;
-
- begin
- pragma Assert (Check_Initialize_Lock (Lock_Ptr (L), PO_Level));
-
- if Priority_Ceiling_Emulation then
- L.Ceiling := Prio;
- end if;
-
- Result := mutex_init (L.L'Access, USYNC_THREAD, System.Null_Address);
- pragma Assert (Result = 0 or else Result = ENOMEM);
-
- if Result = ENOMEM then
- Raise_Exception (Storage_Error'Identity, "Failed to allocate a lock");
- end if;
- end Initialize_Lock;
-
- procedure Initialize_Lock
- (L : access RTS_Lock;
- Level : Lock_Level)
- is
- Result : Interfaces.C.int;
-
- begin
- pragma Assert (Check_Initialize_Lock
- (To_Lock_Ptr (RTS_Lock_Ptr (L)), Level));
- Result := mutex_init (L.L'Access, USYNC_THREAD, System.Null_Address);
- pragma Assert (Result = 0 or else Result = ENOMEM);
-
- if Result = ENOMEM then
- Raise_Exception (Storage_Error'Identity, "Failed to allocate a lock");
- end if;
- end Initialize_Lock;
-
- -------------------
- -- Finalize_Lock --
- -------------------
-
- procedure Finalize_Lock (L : access Lock) is
- Result : Interfaces.C.int;
-
- begin
- pragma Assert (Check_Finalize_Lock (Lock_Ptr (L)));
- Result := mutex_destroy (L.L'Access);
- pragma Assert (Result = 0);
- end Finalize_Lock;
-
- procedure Finalize_Lock (L : access RTS_Lock) is
- Result : Interfaces.C.int;
-
- begin
- pragma Assert (Check_Finalize_Lock (To_Lock_Ptr (RTS_Lock_Ptr (L))));
- Result := mutex_destroy (L.L'Access);
- pragma Assert (Result = 0);
- end Finalize_Lock;
-
- ----------------
- -- Write_Lock --
- ----------------
-
- procedure Write_Lock (L : access Lock; Ceiling_Violation : out Boolean) is
- Result : Interfaces.C.int;
-
- begin
- pragma Assert (Check_Lock (Lock_Ptr (L)));
-
- if Priority_Ceiling_Emulation and then Locking_Policy = 'C' then
- declare
- Self_Id : constant Task_ID := Self;
- Saved_Priority : System.Any_Priority;
-
- begin
- if Self_Id.Common.LL.Active_Priority > L.Ceiling then
- Ceiling_Violation := True;
- return;
- end if;
-
- Saved_Priority := Self_Id.Common.LL.Active_Priority;
-
- if Self_Id.Common.LL.Active_Priority < L.Ceiling then
- Set_Priority (Self_Id, L.Ceiling);
- end if;
-
- Result := mutex_lock (L.L'Access);
- pragma Assert (Result = 0);
- Ceiling_Violation := False;
-
- L.Saved_Priority := Saved_Priority;
- end;
-
- else
- Result := mutex_lock (L.L'Access);
- pragma Assert (Result = 0);
- Ceiling_Violation := False;
- end if;
-
- pragma Assert (Record_Lock (Lock_Ptr (L)));
- end Write_Lock;
-
- procedure Write_Lock (L : access RTS_Lock) is
- Result : Interfaces.C.int;
-
- begin
- pragma Assert (Check_Lock (To_Lock_Ptr (RTS_Lock_Ptr (L))));
- Result := mutex_lock (L.L'Access);
- pragma Assert (Result = 0);
- pragma Assert (Record_Lock (To_Lock_Ptr (RTS_Lock_Ptr (L))));
- end Write_Lock;
-
- procedure Write_Lock (T : Task_ID) is
- Result : Interfaces.C.int;
-
- begin
- pragma Assert (Check_Lock (To_Lock_Ptr (T.Common.LL.L'Access)));
- Result := mutex_lock (T.Common.LL.L.L'Access);
- pragma Assert (Result = 0);
- pragma Assert (Record_Lock (To_Lock_Ptr (T.Common.LL.L'Access)));
- end Write_Lock;
-
- ---------------
- -- Read_Lock --
- ---------------
-
- procedure Read_Lock (L : access Lock; Ceiling_Violation : out Boolean) is
- begin
- Write_Lock (L, Ceiling_Violation);
- end Read_Lock;
-
- ------------
- -- Unlock --
- ------------
-
- procedure Unlock (L : access Lock) is
- Result : Interfaces.C.int;
-
- begin
- pragma Assert (Check_Unlock (Lock_Ptr (L)));
-
- if Priority_Ceiling_Emulation and then Locking_Policy = 'C' then
- declare
- Self_Id : constant Task_ID := Self;
-
- begin
- Result := mutex_unlock (L.L'Access);
- pragma Assert (Result = 0);
-
- if Self_Id.Common.LL.Active_Priority > L.Saved_Priority then
- Set_Priority (Self_Id, L.Saved_Priority);
- end if;
- end;
- else
- Result := mutex_unlock (L.L'Access);
- pragma Assert (Result = 0);
- end if;
- end Unlock;
-
- procedure Unlock (L : access RTS_Lock) is
- Result : Interfaces.C.int;
-
- begin
- pragma Assert (Check_Unlock (To_Lock_Ptr (RTS_Lock_Ptr (L))));
- Result := mutex_unlock (L.L'Access);
- pragma Assert (Result = 0);
- end Unlock;
-
- procedure Unlock (T : Task_ID) is
- Result : Interfaces.C.int;
-
- begin
- pragma Assert (Check_Unlock (To_Lock_Ptr (T.Common.LL.L'Access)));
- Result := mutex_unlock (T.Common.LL.L.L'Access);
- pragma Assert (Result = 0);
- end Unlock;
-
- -- For the time delay implementation, we need to make sure we
- -- achieve following criteria:
-
- -- 1) We have to delay at least for the amount requested.
- -- 2) We have to give up CPU even though the actual delay does not
- -- result in blocking.
- -- 3) Except for restricted run-time systems that do not support
- -- ATC or task abort, the delay must be interrupted by the
- -- abort_task operation.
- -- 4) The implementation has to be efficient so that the delay overhead
- -- is relatively cheap.
- -- (1)-(3) are Ada requirements. Even though (2) is an Annex-D
- -- requirement we still want to provide the effect in all cases.
- -- The reason is that users may want to use short delays to implement
- -- their own scheduling effect in the absence of language provided
- -- scheduling policies.
-
- ---------------------
- -- Monotonic_Clock --
- ---------------------
-
- function Monotonic_Clock return Duration is
- TS : aliased timespec;
- Result : Interfaces.C.int;
-
- begin
- Result := clock_gettime (CLOCK_REALTIME, TS'Unchecked_Access);
- pragma Assert (Result = 0);
- return To_Duration (TS);
- end Monotonic_Clock;
-
- -------------------
- -- RT_Resolution --
- -------------------
-
- function RT_Resolution return Duration is
- begin
- return 10#1.0#E-6;
- end RT_Resolution;
-
- -----------
- -- Yield --
- -----------
-
- procedure Yield (Do_Yield : Boolean := True) is
- begin
- if Do_Yield then
- System.OS_Interface.thr_yield;
- end if;
- end Yield;
-
- ------------------
- -- Set_Priority --
- ------------------
-
- procedure Set_Priority
- (T : Task_ID;
- Prio : System.Any_Priority;
- Loss_Of_Inheritance : Boolean := False)
- is
- Result : Interfaces.C.int;
- Param : aliased struct_pcparms;
-
- use Task_Info;
-
- begin
- T.Common.Current_Priority := Prio;
-
- if Priority_Ceiling_Emulation then
- T.Common.LL.Active_Priority := Prio;
- end if;
-
- if Using_Real_Time_Class then
- Param.pc_cid := Prio_Param.pc_cid;
- Param.rt_pri := pri_t (Prio);
- Param.rt_tqsecs := Prio_Param.rt_tqsecs;
- Param.rt_tqnsecs := Prio_Param.rt_tqnsecs;
-
- Result := Interfaces.C.int (
- priocntl (PC_VERSION, P_LWPID, T.Common.LL.LWP, PC_SETPARMS,
- Param'Address));
-
- else
- if T.Common.Task_Info /= null
- and then not T.Common.Task_Info.Bound_To_LWP
- then
- -- The task is not bound to a LWP, so use thr_setprio
-
- Result :=
- thr_setprio (T.Common.LL.Thread, Interfaces.C.int (Prio));
-
- else
-
- -- The task is bound to a LWP, use priocntl
- -- ??? TBD
-
- null;
- end if;
- end if;
- end Set_Priority;
-
- ------------------
- -- Get_Priority --
- ------------------
-
- function Get_Priority (T : Task_ID) return System.Any_Priority is
- begin
- return T.Common.Current_Priority;
- end Get_Priority;
-
- ----------------
- -- Enter_Task --
- ----------------
-
- procedure Enter_Task (Self_ID : Task_ID) is
- Result : Interfaces.C.int;
- Proc : processorid_t; -- User processor #
- Last_Proc : processorid_t; -- Last processor #
-
- use System.Task_Info;
- begin
- Self_ID.Common.LL.Thread := thr_self;
-
- Self_ID.Common.LL.LWP := lwp_self;
-
- if Self_ID.Common.Task_Info /= null then
- if Self_ID.Common.Task_Info.New_LWP
- and then Self_ID.Common.Task_Info.CPU /= CPU_UNCHANGED
- then
- Last_Proc := Num_Procs - 1;
-
- if Self_ID.Common.Task_Info.CPU = ANY_CPU then
- Result := 0;
- Proc := 0;
-
- while Proc < Last_Proc loop
- Result := p_online (Proc, PR_STATUS);
- exit when Result = PR_ONLINE;
- Proc := Proc + 1;
- end loop;
-
- Result := processor_bind (P_LWPID, P_MYID, Proc, null);
- pragma Assert (Result = 0);
-
- else
- -- Use specified processor
-
- if Self_ID.Common.Task_Info.CPU < 0
- or else Self_ID.Common.Task_Info.CPU > Last_Proc
- then
- raise Invalid_CPU_Number;
- end if;
-
- Result := processor_bind
- (P_LWPID, P_MYID, Self_ID.Common.Task_Info.CPU, null);
- pragma Assert (Result = 0);
- end if;
- end if;
- end if;
-
- Result := thr_setspecific (ATCB_Key, To_Address (Self_ID));
- pragma Assert (Result = 0);
-
- -- We need the above code even if we do direct fetch of Task_ID in Self
- -- for the main task on Sun, x86 Solaris and for gcc 2.7.2.
-
- Lock_All_Tasks_List;
-
- for I in Known_Tasks'Range loop
- if Known_Tasks (I) = null then
- Known_Tasks (I) := Self_ID;
- Self_ID.Known_Tasks_Index := I;
- exit;
- end if;
- end loop;
- Unlock_All_Tasks_List;
- end Enter_Task;
-
- --------------
- -- New_ATCB --
- --------------
-
- function New_ATCB (Entry_Num : Task_Entry_Index) return Task_ID is
- begin
- return new Ada_Task_Control_Block (Entry_Num);
- end New_ATCB;
-
- ----------------------
- -- Initialize_TCB --
- ----------------------
-
- procedure Initialize_TCB (Self_ID : Task_ID; Succeeded : out Boolean) is
- Result : Interfaces.C.int;
-
- begin
- -- Give the task a unique serial number.
-
- Self_ID.Serial_Number := Next_Serial_Number;
- Next_Serial_Number := Next_Serial_Number + 1;
- pragma Assert (Next_Serial_Number /= 0);
-
- Self_ID.Common.LL.Thread := To_thread_t (-1);
- Result := mutex_init
- (Self_ID.Common.LL.L.L'Access, USYNC_THREAD, System.Null_Address);
- Self_ID.Common.LL.L.Level :=
- Private_Task_Serial_Number (Self_ID.Serial_Number);
- pragma Assert (Result = 0 or else Result = ENOMEM);
-
- if Result = 0 then
- Result := cond_init (Self_ID.Common.LL.CV'Access, USYNC_THREAD, 0);
- pragma Assert (Result = 0 or else Result = ENOMEM);
-
- if Result /= 0 then
- Result := mutex_destroy (Self_ID.Common.LL.L.L'Access);
- pragma Assert (Result = 0);
- Succeeded := False;
- else
- Succeeded := True;
- end if;
-
- else
- Succeeded := False;
- end if;
- end Initialize_TCB;
-
- -----------------
- -- Create_Task --
- -----------------
-
- procedure Create_Task
- (T : Task_ID;
- Wrapper : System.Address;
- Stack_Size : System.Parameters.Size_Type;
- Priority : System.Any_Priority;
- Succeeded : out Boolean)
- is
- Result : Interfaces.C.int;
- Adjusted_Stack_Size : Interfaces.C.size_t;
- Opts : Interfaces.C.int := THR_DETACHED;
-
- Page_Size : constant System.Parameters.Size_Type := 4096;
- -- This constant is for reserving extra space at the
- -- end of the stack, which can be used by the stack
- -- checking as guard page. The idea is that we need
- -- to have at least Stack_Size bytes available for
- -- actual use.
-
- use System.Task_Info;
- begin
- if Stack_Size = System.Parameters.Unspecified_Size then
- Adjusted_Stack_Size :=
- Interfaces.C.size_t (Default_Stack_Size + Page_Size);
-
- elsif Stack_Size < Minimum_Stack_Size then
- Adjusted_Stack_Size :=
- Interfaces.C.size_t (Minimum_Stack_Size + Page_Size);
-
- else
- Adjusted_Stack_Size :=
- Interfaces.C.size_t (Stack_Size + Page_Size);
- end if;
-
- -- Since the initial signal mask of a thread is inherited from the
- -- creator, and the Environment task has all its signals masked, we
- -- do not need to manipulate caller's signal mask at this point.
- -- All tasks in RTS will have All_Tasks_Mask initially.
-
- if T.Common.Task_Info /= null then
-
- if T.Common.Task_Info.New_LWP then
- Opts := Opts + THR_NEW_LWP;
- end if;
-
- if T.Common.Task_Info.Bound_To_LWP then
- Opts := Opts + THR_BOUND;
- end if;
-
- else
- Opts := THR_DETACHED + THR_BOUND;
- end if;
-
- Result := thr_create
- (System.Null_Address,
- Adjusted_Stack_Size,
- Thread_Body_Access (Wrapper),
- To_Address (T),
- Opts,
- T.Common.LL.Thread'Access);
-
- Succeeded := Result = 0;
- pragma Assert
- (Result = 0
- or else Result = ENOMEM
- or else Result = EAGAIN);
- end Create_Task;
-
- ------------------
- -- Finalize_TCB --
- ------------------
-
- procedure Finalize_TCB (T : Task_ID) is
- Result : Interfaces.C.int;
- Tmp : Task_ID := T;
-
- procedure Free is new
- Unchecked_Deallocation (Ada_Task_Control_Block, Task_ID);
-
- begin
- T.Common.LL.Thread := To_thread_t (0);
- Result := mutex_destroy (T.Common.LL.L.L'Access);
- pragma Assert (Result = 0);
- Result := cond_destroy (T.Common.LL.CV'Access);
- pragma Assert (Result = 0);
-
- if T.Known_Tasks_Index /= -1 then
- Known_Tasks (T.Known_Tasks_Index) := null;
- end if;
-
- Free (Tmp);
- end Finalize_TCB;
-
- ---------------
- -- Exit_Task --
- ---------------
-
- -- This procedure must be called with abort deferred.
- -- It can no longer call Self or access
- -- the current task's ATCB, since the ATCB has been deallocated.
-
- procedure Exit_Task is
- begin
- thr_exit (System.Null_Address);
- end Exit_Task;
-
- ----------------
- -- Abort_Task --
- ----------------
-
- procedure Abort_Task (T : Task_ID) is
- Result : Interfaces.C.int;
- begin
- pragma Assert (T /= Self);
-
- Result := thr_kill (T.Common.LL.Thread,
- Signal (System.Interrupt_Management.Abort_Task_Interrupt));
- null;
-
- pragma Assert (Result = 0);
- end Abort_Task;
-
- -------------
- -- Sleep --
- -------------
-
- procedure Sleep
- (Self_ID : Task_ID;
- Reason : Task_States)
- is
- Result : Interfaces.C.int;
-
- begin
- pragma Assert (Check_Sleep (Reason));
-
- if Dynamic_Priority_Support
- and then Self_ID.Pending_Priority_Change
- then
- Self_ID.Pending_Priority_Change := False;
- Self_ID.Common.Base_Priority := Self_ID.New_Base_Priority;
- Set_Priority (Self_ID, Self_ID.Common.Base_Priority);
- end if;
-
- Result := cond_wait
- (Self_ID.Common.LL.CV'Access, Self_ID.Common.LL.L.L'Access);
- pragma Assert (Result = 0 or else Result = EINTR);
- pragma Assert (Record_Wakeup
- (To_Lock_Ptr (Self_ID.Common.LL.L'Access), Reason));
- end Sleep;
-
- -- Note that we are relying heaviliy here on the GNAT feature
- -- that Calendar.Time, System.Real_Time.Time, Duration, and
- -- System.Real_Time.Time_Span are all represented in the same
- -- way, i.e., as a 64-bit count of nanoseconds.
-
- -- This allows us to always pass the timeout value as a Duration.
-
- -- ???
- -- We are taking liberties here with the semantics of the delays.
- -- That is, we make no distinction between delays on the Calendar clock
- -- and delays on the Real_Time clock. That is technically incorrect, if
- -- the Calendar clock happens to be reset or adjusted.
- -- To solve this defect will require modification to the compiler
- -- interface, so that it can pass through more information, to tell
- -- us here which clock to use!
-
- -- cond_timedwait will return if any of the following happens:
- -- 1) some other task did cond_signal on this condition variable
- -- In this case, the return value is 0
- -- 2) the call just returned, for no good reason
- -- This is called a "spurious wakeup".
- -- In this case, the return value may also be 0.
- -- 3) the time delay expires
- -- In this case, the return value is ETIME
- -- 4) this task received a signal, which was handled by some
- -- handler procedure, and now the thread is resuming execution
- -- UNIX calls this an "interrupted" system call.
- -- In this case, the return value is EINTR
-
- -- If the cond_timedwait returns 0 or EINTR, it is still
- -- possible that the time has actually expired, and by chance
- -- a signal or cond_signal occurred at around the same time.
-
- -- We have also observed that on some OS's the value ETIME
- -- will be returned, but the clock will show that the full delay
- -- has not yet expired.
-
- -- For these reasons, we need to check the clock after return
- -- from cond_timedwait. If the time has expired, we will set
- -- Timedout = True.
-
- -- This check might be omitted for systems on which the
- -- cond_timedwait() never returns early or wakes up spuriously.
-
- -- Annex D requires that completion of a delay cause the task
- -- to go to the end of its priority queue, regardless of whether
- -- the task actually was suspended by the delay. Since
- -- cond_timedwait does not do this on Solaris, we add a call
- -- to thr_yield at the end. We might do this at the beginning,
- -- instead, but then the round-robin effect would not be the
- -- same; the delayed task would be ahead of other tasks of the
- -- same priority that awoke while it was sleeping.
-
- -- For Timed_Sleep, we are expecting possible cond_signals
- -- to indicate other events (e.g., completion of a RV or
- -- completion of the abortable part of an async. select),
- -- we want to always return if interrupted. The caller will
- -- be responsible for checking the task state to see whether
- -- the wakeup was spurious, and to go back to sleep again
- -- in that case. We don't need to check for pending abort
- -- or priority change on the way in our out; that is the
- -- caller's responsibility.
-
- -- For Timed_Delay, we are not expecting any cond_signals or
- -- other interruptions, except for priority changes and aborts.
- -- Therefore, we don't want to return unless the delay has
- -- actually expired, or the call has been aborted. In this
- -- case, since we want to implement the entire delay statement
- -- semantics, we do need to check for pending abort and priority
- -- changes. We can quietly handle priority changes inside the
- -- procedure, since there is no entry-queue reordering involved.
-
- -----------------
- -- Timed_Sleep --
- -----------------
-
- -- This is for use within the run-time system, so abort is
- -- assumed to be already deferred, and the caller should be
- -- holding its own ATCB lock.
-
- -- Yielded should be False unles we know for certain that the
- -- operation resulted in the calling task going to the end of
- -- the dispatching queue for its priority.
-
- -- ???
- -- This version presumes the worst, so Yielded is always False.
- -- On some targets, if cond_timedwait always yields, we could
- -- set Yielded to True just before the cond_timedwait call.
-
- procedure Timed_Sleep
- (Self_ID : Task_ID;
- Time : Duration;
- Mode : ST.Delay_Modes;
- Reason : System.Tasking.Task_States;
- Timedout : out Boolean;
- Yielded : out Boolean)
- is
- Check_Time : constant Duration := Monotonic_Clock;
- Abs_Time : Duration;
- Request : aliased timespec;
- Result : Interfaces.C.int;
-
- begin
- pragma Assert (Check_Sleep (Reason));
- Timedout := True;
- Yielded := False;
-
- if Mode = Relative then
- Abs_Time := Duration'Min (Time, Max_Sensible_Delay) + Check_Time;
- else
- Abs_Time := Duration'Min (Check_Time + Max_Sensible_Delay, Time);
- end if;
-
- if Abs_Time > Check_Time then
- Request := To_Timespec (Abs_Time);
-
- loop
- exit when Self_ID.Pending_ATC_Level < Self_ID.ATC_Nesting_Level
- or else (Dynamic_Priority_Support and then
- Self_ID.Pending_Priority_Change);
-
- Result := cond_timedwait (Self_ID.Common.LL.CV'Access,
- Self_ID.Common.LL.L.L'Access, Request'Access);
-
- exit when Abs_Time <= Monotonic_Clock;
-
- if Result = 0 or Result = EINTR then
- -- somebody may have called Wakeup for us
- Timedout := False;
- exit;
- end if;
-
- pragma Assert (Result = ETIME);
- end loop;
- end if;
-
- pragma Assert (Record_Wakeup
- (To_Lock_Ptr (Self_ID.Common.LL.L'Access), Reason));
- end Timed_Sleep;
-
- -----------------
- -- Timed_Delay --
- -----------------
-
- -- This is for use in implementing delay statements, so
- -- we assume the caller is abort-deferred but is holding
- -- no locks.
-
- procedure Timed_Delay
- (Self_ID : Task_ID;
- Time : Duration;
- Mode : ST.Delay_Modes)
- is
- Check_Time : constant Duration := Monotonic_Clock;
- Abs_Time : Duration;
- Request : aliased timespec;
- Result : Interfaces.C.int;
-
- begin
- -- Only the little window between deferring abort and
- -- locking Self_ID is the reason we need to
- -- check for pending abort and priority change below!
-
- SSL.Abort_Defer.all;
- Write_Lock (Self_ID);
-
- if Mode = Relative then
- Abs_Time := Time + Check_Time;
- else
- Abs_Time := Duration'Min (Check_Time + Max_Sensible_Delay, Time);
- end if;
-
- if Abs_Time > Check_Time then
- Request := To_Timespec (Abs_Time);
- Self_ID.Common.State := Delay_Sleep;
-
- pragma Assert (Check_Sleep (Delay_Sleep));
-
- loop
- if Dynamic_Priority_Support and then
- Self_ID.Pending_Priority_Change then
- Self_ID.Pending_Priority_Change := False;
- Self_ID.Common.Base_Priority := Self_ID.New_Base_Priority;
- Set_Priority (Self_ID, Self_ID.Common.Base_Priority);
- end if;
-
- exit when Self_ID.Pending_ATC_Level < Self_ID.ATC_Nesting_Level;
-
- Result := cond_timedwait (Self_ID.Common.LL.CV'Access,
- Self_ID.Common.LL.L.L'Access, Request'Access);
-
- exit when Abs_Time <= Monotonic_Clock;
-
- pragma Assert (Result = 0 or else
- Result = ETIME or else
- Result = EINTR);
- end loop;
-
- pragma Assert (Record_Wakeup
- (To_Lock_Ptr (Self_ID.Common.LL.L'Access), Delay_Sleep));
-
- Self_ID.Common.State := Runnable;
- end if;
-
- Unlock (Self_ID);
- thr_yield;
- SSL.Abort_Undefer.all;
- end Timed_Delay;
-
- ------------
- -- Wakeup --
- ------------
-
- procedure Wakeup
- (T : Task_ID;
- Reason : Task_States)
- is
- Result : Interfaces.C.int;
-
- begin
- pragma Assert (Check_Wakeup (T, Reason));
- Result := cond_signal (T.Common.LL.CV'Access);
- pragma Assert (Result = 0);
- end Wakeup;
-
- ---------------------------
- -- Check_Initialize_Lock --
- ---------------------------
-
- -- The following code is intended to check some of the invariant
- -- assertions related to lock usage, on which we depend.
-
- function Check_Initialize_Lock
- (L : Lock_Ptr;
- Level : Lock_Level)
- return Boolean
- is
- Self_ID : constant Task_ID := Self;
-
- begin
- -- Check that caller is abort-deferred
-
- if Self_ID.Deferral_Level <= 0 then
- return False;
- end if;
-
- -- Check that the lock is not yet initialized
-
- if L.Level /= 0 then
- return False;
- end if;
-
- L.Level := Lock_Level'Pos (Level) + 1;
- return True;
- end Check_Initialize_Lock;
-
- ----------------
- -- Check_Lock --
- ----------------
-
- function Check_Lock (L : Lock_Ptr) return Boolean is
- Self_ID : Task_ID := Self;
- P : Lock_Ptr;
-
- begin
- -- Check that the argument is not null
-
- if L = null then
- return False;
- end if;
-
- -- Check that L is not frozen
-
- if L.Frozen then
- return False;
- end if;
-
- -- Check that caller is abort-deferred
-
- if Self_ID.Deferral_Level <= 0 then
- return False;
- end if;
-
- -- Check that caller is not holding this lock already
-
- if L.Owner = To_Owner_ID (Self_ID) then
- return False;
- end if;
-
- -- Check that TCB lock order rules are satisfied
-
- P := Self_ID.Common.LL.Locks;
- if P /= null then
- if P.Level >= L.Level
- and then (P.Level > 2 or else L.Level > 2)
- then
- return False;
- end if;
- end if;
-
- return True;
- end Check_Lock;
-
- -----------------
- -- Record_Lock --
- -----------------
-
- function Record_Lock (L : Lock_Ptr) return Boolean is
- Self_ID : Task_ID := Self;
- P : Lock_Ptr;
-
- begin
- Lock_Count := Lock_Count + 1;
-
- -- There should be no owner for this lock at this point
-
- if L.Owner /= null then
- return False;
- end if;
-
- -- Record new owner
-
- L.Owner := To_Owner_ID (Self_ID);
-
- -- Check that TCB lock order rules are satisfied
-
- P := Self_ID.Common.LL.Locks;
-
- if P /= null then
- L.Next := P;
- end if;
-
- Self_ID.Common.LL.Locking := null;
- Self_ID.Common.LL.Locks := L;
- return True;
- end Record_Lock;
-
- -----------------
- -- Check_Sleep --
- -----------------
-
- function Check_Sleep (Reason : Task_States) return Boolean is
- Self_ID : Task_ID := Self;
- P : Lock_Ptr;
-
- begin
- -- Check that caller is abort-deferred
-
- if Self_ID.Deferral_Level <= 0 then
- return False;
- end if;
-
- -- Check that caller is holding own lock, on top of list
-
- if Self_ID.Common.LL.Locks /=
- To_Lock_Ptr (Self_ID.Common.LL.L'Access)
- then
- return False;
- end if;
-
- -- Check that TCB lock order rules are satisfied
-
- if Self_ID.Common.LL.Locks.Next /= null then
- return False;
- end if;
-
- Self_ID.Common.LL.L.Owner := null;
- P := Self_ID.Common.LL.Locks;
- Self_ID.Common.LL.Locks := Self_ID.Common.LL.Locks.Next;
- P.Next := null;
- return True;
- end Check_Sleep;
-
- -------------------
- -- Record_Wakeup --
- -------------------
-
- function Record_Wakeup
- (L : Lock_Ptr;
- Reason : Task_States)
- return Boolean
- is
- Self_ID : Task_ID := Self;
- P : Lock_Ptr;
-
- begin
- -- Record new owner
-
- L.Owner := To_Owner_ID (Self_ID);
-
- -- Check that TCB lock order rules are satisfied
-
- P := Self_ID.Common.LL.Locks;
-
- if P /= null then
- L.Next := P;
- end if;
-
- Self_ID.Common.LL.Locking := null;
- Self_ID.Common.LL.Locks := L;
- return True;
- end Record_Wakeup;
-
- ------------------
- -- Check_Wakeup --
- ------------------
-
- function Check_Wakeup
- (T : Task_ID;
- Reason : Task_States)
- return Boolean
- is
- Self_ID : Task_ID := Self;
-
- begin
- -- Is caller holding T's lock?
-
- if T.Common.LL.L.Owner /= To_Owner_ID (Self_ID) then
- return False;
- end if;
-
- -- Are reasons for wakeup and sleep consistent?
-
- if T.Common.State /= Reason then
- return False;
- end if;
-
- return True;
- end Check_Wakeup;
-
- ------------------
- -- Check_Unlock --
- ------------------
-
- function Check_Unlock (L : Lock_Ptr) return Boolean is
- Self_ID : Task_ID := Self;
- P : Lock_Ptr;
-
- begin
- Unlock_Count := Unlock_Count + 1;
-
- if L = null then
- return False;
- end if;
-
- if L.Buddy /= null then
- return False;
- end if;
-
- if L.Level = 4 then
- Check_Count := Unlock_Count;
- end if;
-
- if Unlock_Count - Check_Count > 1000 then
- Check_Count := Unlock_Count;
- Old_Owner := To_Task_ID (All_Tasks_L.Owner);
- end if;
-
- -- Check that caller is abort-deferred
-
- if Self_ID.Deferral_Level <= 0 then
- return False;
- end if;
-
- -- Check that caller is holding this lock, on top of list
-
- if Self_ID.Common.LL.Locks /= L then
- return False;
- end if;
-
- -- Record there is no owner now
-
- L.Owner := null;
- P := Self_ID.Common.LL.Locks;
- Self_ID.Common.LL.Locks := Self_ID.Common.LL.Locks.Next;
- P.Next := null;
- return True;
- end Check_Unlock;
-
- --------------------
- -- Check_Finalize --
- --------------------
-
- function Check_Finalize_Lock (L : Lock_Ptr) return Boolean is
- Self_ID : Task_ID := Self;
-
- begin
- -- Check that caller is abort-deferred
-
- if Self_ID.Deferral_Level <= 0 then
- return False;
- end if;
-
- -- Check that no one is holding this lock
-
- if L.Owner /= null then
- return False;
- end if;
-
- L.Frozen := True;
- return True;
- end Check_Finalize_Lock;
-
- ----------------
- -- Check_Exit --
- ----------------
-
- function Check_Exit (Self_ID : Task_ID) return Boolean is
- begin
- -- Check that caller is just holding Global_Task_Lock
- -- and no other locks
-
- if Self_ID.Common.LL.Locks = null then
- return False;
- end if;
-
- -- 2 = Global_Task_Level
-
- if Self_ID.Common.LL.Locks.Level /= 2 then
- return False;
- end if;
-
- if Self_ID.Common.LL.Locks.Next /= null then
- return False;
- end if;
-
- -- Check that caller is abort-deferred
-
- if Self_ID.Deferral_Level <= 0 then
- return False;
- end if;
-
- return True;
- end Check_Exit;
-
- --------------------
- -- Check_No_Locks --
- --------------------
-
- function Check_No_Locks (Self_ID : Task_ID) return Boolean is
- begin
- return Self_ID.Common.LL.Locks = null;
- end Check_No_Locks;
-
- ----------------------
- -- Environment_Task --
- ----------------------
-
- function Environment_Task return Task_ID is
- begin
- return Environment_Task_ID;
- end Environment_Task;
-
- -------------------------
- -- Lock_All_Tasks_List --
- -------------------------
-
- procedure Lock_All_Tasks_List is
- begin
- Write_Lock (All_Tasks_L'Access);
- end Lock_All_Tasks_List;
-
- ---------------------------
- -- Unlock_All_Tasks_List --
- ---------------------------
-
- procedure Unlock_All_Tasks_List is
- begin
- Unlock (All_Tasks_L'Access);
- end Unlock_All_Tasks_List;
-
- ------------------
- -- Suspend_Task --
- ------------------
-
- function Suspend_Task
- (T : ST.Task_ID;
- Thread_Self : Thread_Id) return Boolean is
- begin
- if T.Common.LL.Thread /= Thread_Self then
- return thr_suspend (T.Common.LL.Thread) = 0;
- else
- return True;
- end if;
- end Suspend_Task;
-
- -----------------
- -- Resume_Task --
- -----------------
-
- function Resume_Task
- (T : ST.Task_ID;
- Thread_Self : Thread_Id) return Boolean is
- begin
- if T.Common.LL.Thread /= Thread_Self then
- return thr_continue (T.Common.LL.Thread) = 0;
- else
- return True;
- end if;
- end Resume_Task;
-
- ----------------
- -- Initialize --
- ----------------
-
- procedure Initialize (Environment_Task : ST.Task_ID) is
- act : aliased struct_sigaction;
- old_act : aliased struct_sigaction;
- Tmp_Set : aliased sigset_t;
- Result : Interfaces.C.int;
-
- procedure Configure_Processors;
- -- Processors configuration
- -- The user can specify a processor which the program should run
- -- on to emulate a single-processor system. This can be easily
- -- done by setting environment variable GNAT_PROCESSOR to one of
- -- the following :
- --
- -- -2 : use the default configuration (run the program on all
- -- available processors) - this is the same as having
- -- GNAT_PROCESSOR unset
- -- -1 : let the RTS choose one processor and run the program on
- -- that processor
- -- 0 .. Last_Proc : run the program on the specified processor
- --
- -- Last_Proc is equal to the value of the system variable
- -- _SC_NPROCESSORS_CONF, minus one.
-
- procedure Configure_Processors is
-
- Proc_Acc : constant GNAT.OS_Lib.String_Access :=
- GNAT.OS_Lib.Getenv ("GNAT_PROCESSOR");
- begin
- if Proc_Acc.all'Length /= 0 then
-
- -- Environment variable is defined
-
- declare
- Proc : aliased processorid_t; -- User processor #
- Last_Proc : processorid_t; -- Last processor #
-
- begin
- Last_Proc := Num_Procs - 1;
-
- if Last_Proc = -1 then
-
- -- Unable to read system variable _SC_NPROCESSORS_CONF
- -- Ignore environment variable GNAT_PROCESSOR
-
- null;
-
- else
- Proc := processorid_t'Value (Proc_Acc.all);
-
- if Proc < -2 or Proc > Last_Proc then
- raise Constraint_Error;
-
- elsif Proc = -2 then
-
- -- Use the default configuration
-
- null;
-
- elsif Proc = -1 then
-
- -- Choose a processor
-
- Result := 0;
- while Proc < Last_Proc loop
- Proc := Proc + 1;
- Result := p_online (Proc, PR_STATUS);
- exit when Result = PR_ONLINE;
- end loop;
-
- pragma Assert (Result = PR_ONLINE);
- Result := processor_bind (P_PID, P_MYID, Proc, null);
- pragma Assert (Result = 0);
-
- else
- -- Use user processor
-
- Result := processor_bind (P_PID, P_MYID, Proc, null);
- pragma Assert (Result = 0);
- end if;
- end if;
-
- exception
- when Constraint_Error =>
-
- -- Illegal environment variable GNAT_PROCESSOR - ignored
-
- null;
- end;
- end if;
- end Configure_Processors;
-
- -- Start of processing for Initialize
-
- begin
- Environment_Task_ID := Environment_Task;
-
- -- This is done in Enter_Task, but this is too late for the
- -- Environment Task, since we need to call Self in Check_Locks when
- -- the run time is compiled with assertions on.
-
- Result := thr_setspecific (ATCB_Key, To_Address (Environment_Task));
- pragma Assert (Result = 0);
-
- -- Initialize the lock used to synchronize chain of all ATCBs.
-
- Initialize_Lock (All_Tasks_L'Access, All_Tasks_Level);
-
- Enter_Task (Environment_Task);
-
- -- Install the abort-signal handler
-
- -- Set sa_flags to SA_NODEFER so that during the handler execution
- -- we do not change the Signal_Mask to be masked for the Abort_Signal.
- -- This is a temporary fix to the problem that the Signal_Mask is
- -- not restored after the exception (longjmp) from the handler.
- -- The right fix should be made in sigsetjmp so that we save
- -- the Signal_Set and restore it after a longjmp.
- -- In that case, this field should be changed back to 0. ???
-
- act.sa_flags := 16;
-
- act.sa_handler := Abort_Handler'Address;
- Result := sigemptyset (Tmp_Set'Access);
- pragma Assert (Result = 0);
- act.sa_mask := Tmp_Set;
-
- Result :=
- sigaction (
- Signal (System.Interrupt_Management.Abort_Task_Interrupt),
- act'Unchecked_Access,
- old_act'Unchecked_Access);
- pragma Assert (Result = 0);
-
- Configure_Processors;
-
- -- Create a free ATCB for use on the Fake_ATCB_List.
-
- Next_Fake_ATCB := new Fake_ATCB;
- end Initialize;
-
--- Package elaboration
-
-begin
- declare
- Result : Interfaces.C.int;
-
- begin
- -- Mask Environment task for all signals. The original mask of the
- -- Environment task will be recovered by Interrupt_Server task
- -- during the elaboration of s-interr.adb.
-
- System.Interrupt_Management.Operations.Set_Interrupt_Mask
- (System.Interrupt_Management.Operations.All_Tasks_Mask'Access);
-
- -- Prepare the set of signals that should unblocked in all tasks
-
- Result := sigemptyset (Unblocked_Signal_Mask'Access);
- pragma Assert (Result = 0);
-
- for J in Interrupt_Management.Interrupt_ID loop
- if System.Interrupt_Management.Keep_Unmasked (J) then
- Result := sigaddset (Unblocked_Signal_Mask'Access, Signal (J));
- pragma Assert (Result = 0);
- end if;
- end loop;
-
- -- We need the following code to support automatic creation of fake
- -- ATCB's for C threads that call the Ada run-time system, even if
- -- we use a faster way of getting Self for real Ada tasks.
-
- Result := thr_keycreate (ATCB_Key'Access, System.Null_Address);
- pragma Assert (Result = 0);
- end;
-
- if Dispatching_Policy = 'F' then
- declare
- Result : Interfaces.C.long;
- Class_Info : aliased struct_pcinfo;
- Secs, Nsecs : Interfaces.C.long;
-
- begin
-
- -- If a pragma Time_Slice is specified, takes the value in account.
-
- if Time_Slice_Val > 0 then
- -- Convert Time_Slice_Val (microseconds) into seconds and
- -- nanoseconds
-
- Secs := Time_Slice_Val / 1_000_000;
- Nsecs := (Time_Slice_Val rem 1_000_000) * 1_000;
-
- -- Otherwise, default to no time slicing (i.e run until blocked)
-
- else
- Secs := RT_TQINF;
- Nsecs := RT_TQINF;
- end if;
-
- -- Get the real time class id.
-
- Class_Info.pc_clname (1) := 'R';
- Class_Info.pc_clname (2) := 'T';
- Class_Info.pc_clname (3) := ASCII.Nul;
-
- Result := priocntl (PC_VERSION, P_LWPID, P_MYID, PC_GETCID,
- Class_Info'Address);
-
- -- Request the real time class
-
- Prio_Param.pc_cid := Class_Info.pc_cid;
- Prio_Param.rt_pri := pri_t (Class_Info.rt_maxpri);
- Prio_Param.rt_tqsecs := Secs;
- Prio_Param.rt_tqnsecs := Nsecs;
-
- Result := priocntl (PC_VERSION, P_LWPID, P_MYID, PC_SETPARMS,
- Prio_Param'Address);
-
- Using_Real_Time_Class := Result /= -1;
- end;
- end if;
-end System.Task_Primitives.Operations;