home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / adav313.zip / gnat-3_13p-os2-bin-20010916.zip / emx / gnatlib / s-taspri.ads < prev    next >
Text File  |  2000-07-19  |  5KB  |  111 lines
  1. ------------------------------------------------------------------------------
  2. --                                                                          --
  3. --                 GNU ADA RUN-TIME LIBRARY (GNARL) COMPONENTS              --
  4. --                                                                          --
  5. --                S Y S T E M . T A S K _ P R I M I T I V E S               --
  6. --                                                                          --
  7. --                                  S p e c                                 --
  8. --                                                                          --
  9. --                             $Revision: 1.5 $
  10. --                                                                          --
  11. --            Copyright (C) 1991-1999 Florida State University              --
  12. --                                                                          --
  13. -- GNARL is free software; you can  redistribute it  and/or modify it under --
  14. -- terms of the  GNU General Public License as published  by the Free Soft- --
  15. -- ware  Foundation;  either version 2,  or (at your option) any later ver- --
  16. -- sion. GNARL is distributed in the hope that it will be useful, but WITH- --
  17. -- OUT ANY WARRANTY;  without even the  implied warranty of MERCHANTABILITY --
  18. -- or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License --
  19. -- for  more details.  You should have  received  a copy of the GNU General --
  20. -- Public License  distributed with GNARL; see file COPYING.  If not, write --
  21. -- to  the Free Software Foundation,  59 Temple Place - Suite 330,  Boston, --
  22. -- MA 02111-1307, USA.                                                      --
  23. --                                                                          --
  24. -- As a special exception,  if other files  instantiate  generics from this --
  25. -- unit, or you link  this unit with other files  to produce an executable, --
  26. -- this  unit  does not  by itself cause  the resulting  executable  to  be --
  27. -- covered  by the  GNU  General  Public  License.  This exception does not --
  28. -- however invalidate  any other reasons why  the executable file  might be --
  29. -- covered by the  GNU Public License.                                      --
  30. --                                                                          --
  31. -- GNARL was developed by the GNARL team at Florida State University. It is --
  32. -- now maintained by Ada Core Technologies Inc. in cooperation with Florida --
  33. -- State University (http://www.gnat.com).                                  --
  34. --                                                                          --
  35. ------------------------------------------------------------------------------
  36.  
  37. --  This is an OS/2 version of this package.
  38.  
  39. --  This package provides low-level support for most tasking features.
  40.  
  41. pragma Polling (Off);
  42. --  Turn off polling, we do not want ATC polling to take place during
  43. --  tasking operations. It causes infinite loops and other problems.
  44.  
  45. with Interfaces.OS2Lib.Threads;
  46. with Interfaces.OS2Lib.Synchronization;
  47.  
  48. package System.Task_Primitives is
  49.  
  50.    pragma Preelaborate;
  51.  
  52. --   type Lock is limited private;
  53.    --  Should be used for implementation of protected objects.
  54.  
  55. --   type RTS_Lock is limited private;
  56.    --  Should be used inside the runtime system.
  57.    --  The difference between Lock and the RTS_Lock is that the later
  58.    --  one serves only as a semaphore so that do not check for
  59.    --  ceiling violations.
  60.  
  61.    type Task_Body_Access is access procedure;
  62.    --  Pointer to the task body's entry point (or possibly a wrapper
  63.    --  declared local to the GNARL).
  64.  
  65. --   type Private_Data is limited private;
  66.    --  Any information that the GNULLI needs maintained on a per-task
  67.    --  basis.  A component of this type is guaranteed to be included
  68.    --  in the Ada_Task_Control_Block.
  69.  
  70. --  private
  71.  
  72.    type Lock is
  73.       record
  74.          Mutex          : aliased Interfaces.OS2Lib.Synchronization.HMTX;
  75.          Priority       : Integer;
  76.          Owner_Priority : Integer;
  77.          Owner_ID       : Address;
  78.       end record;
  79.  
  80.    type RTS_Lock is new Lock;
  81.  
  82.    type Private_Data is record
  83.       Thread          : aliased Interfaces.OS2Lib.Threads.TID;
  84.       pragma Atomic (Thread);
  85.       --  Thread field may be updated by two different threads of control.
  86.       --  (See, Enter_Task and Create_Task in s-taprop.adb).
  87.       --  They put the same value (thr_self value). We do not want to
  88.       --  use lock on those operations and the only thing we have to
  89.       --  make sure is that they are updated in atomic fashion.
  90.  
  91.       CV : aliased Interfaces.OS2Lib.Synchronization.HEV;
  92.  
  93.       L  : aliased RTS_Lock;
  94.       --  Protection for all components is lock L
  95.  
  96.       Current_Priority : Integer := -1;
  97.       --  The Current_Priority is the actual priority of a thread.
  98.       --  This field is needed because it is only possible to set a
  99.       --  delta priority in OS/2. The only places where this field should
  100.       --  be set are Set_Priority, Create_Task and Initialize (Environment).
  101.  
  102.       Wrapper : Interfaces.OS2Lib.Threads.PFNTHREAD;
  103.       --  This is the original wrapper passed by Operations.Create_Task.
  104.       --  When installing an exception handler in a thread, the thread
  105.       --  starts executing the Exception_Wrapper which calls Wrapper
  106.       --  when the handler has been installed. The handler is removed when
  107.       --  wrapper returns.
  108.    end record;
  109.  
  110. end System.Task_Primitives;
  111.