OSDN Git Service

2008-04-08 Ed Schonberg <schonberg@adacore.com>
[pf3gnuchains/gcc-fork.git] / gcc / ada / s-inmaop.ads
index 2bb8ef0..1bd660e 100644 (file)
@@ -1,13 +1,12 @@
 ------------------------------------------------------------------------------
 --                                                                          --
---                GNU ADA RUN-TIME LIBRARY (GNARL) COMPONENTS               --
+--                 GNAT RUN-TIME LIBRARY (GNARL) COMPONENTS                 --
 --                                                                          --
---            S Y S T E M . I N T E R R U P T _ M A N A G E M E N T .       --
---                             O P E R A T I O N S                          --
+--                  SYSTEM.INTERRUPT_MANAGEMENT.OPERATIONS                  --
 --                                                                          --
 --                                  S p e c                                 --
 --                                                                          --
---          Copyright (C) 1992-2004, Free Software Foundation, Inc.         --
+--          Copyright (C) 1992-2007, Free Software Foundation, Inc.         --
 --                                                                          --
 -- 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- --
@@ -17,8 +16,8 @@
 -- 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.                                                      --
+-- to  the  Free Software Foundation,  51  Franklin  Street,  Fifth  Floor, --
+-- Boston, MA 02110-1301, 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, --
@@ -63,11 +62,11 @@ package System.Interrupt_Management.Operations is
 
    procedure Install_Default_Action (Interrupt : Interrupt_ID);
    pragma Inline (Install_Default_Action);
-   --  Set the sigaction of the Interrupt to default (SIG_DFL).
+   --  Set the sigaction of the Interrupt to default (SIG_DFL)
 
    procedure Install_Ignore_Action (Interrupt : Interrupt_ID);
    pragma Inline (Install_Ignore_Action);
-   --  Set the sigaction of the Interrupt to ignore (SIG_IGN).
+   --  Set the sigaction of the Interrupt to ignore (SIG_IGN)
 
    procedure Fill_Interrupt_Mask (Mask : access Interrupt_Mask);
    pragma Inline (Fill_Interrupt_Mask);
@@ -97,24 +96,29 @@ package System.Interrupt_Management.Operations is
 
    procedure Copy_Interrupt_Mask (X : out Interrupt_Mask; Y : Interrupt_Mask);
    pragma Inline (Copy_Interrupt_Mask);
-   --  Assigment needed for limited private type Interrupt_Mask.
+   --  Assigment needed for limited private type Interrupt_Mask
 
    procedure Interrupt_Self_Process (Interrupt : Interrupt_ID);
    pragma Inline (Interrupt_Self_Process);
    --  Raise an Interrupt process-level
 
-   --  The following objects serve as constants, but are initialized
-   --  in the body to aid portability.  These actually belong to the
-   --  System.Interrupt_Management but since Interrupt_Mask is a
-   --  private type we can not have them declared there.
+   procedure Setup_Interrupt_Mask;
+   --  Mask Environment task for all signals
+   --  This function should be called by the elaboration of System.Interrupt
+   --  to set up proper signal masking in all tasks.
+
+   --  The following objects serve as constants, but are initialized in the
+   --  body to aid portability. These should be in System.Interrupt_Management
+   --  but since Interrupt_Mask is private type we cannot have them declared
+   --  there.
 
    --  Why not make these deferred constants that are initialized using
    --  function calls in the private part???
 
    Environment_Mask : aliased Interrupt_Mask;
-   --  This mask represents the mask of Environment task when this package
-   --  is being elaborated, except the signals being
-   --  forced to be unmasked by RTS (items in Keep_Unmasked)
+   --  This mask represents the mask of Environment task when this package is
+   --  being elaborated, except the signals being forced to be unmasked by RTS
+   --  (items in Keep_Unmasked)
 
    All_Tasks_Mask : aliased Interrupt_Mask;
    --  This is the mask of all tasks created in RTS. Only one task in RTS