File : posix-generic_shared_memory.ads


------------------------------------------------------------------------------
--                                                                          --
--            FLORIST (FSU Implementation of POSIX.5) COMPONENTS            --
--                                                                          --
--           P O S I X . G E N E R I C _ S H A R E D _ M E M O R Y          --
--                                                                          --
--                                  S p e c                                 --
--                                                                          --
--                                                                          --
--  This  file is a component  of FLORIST,  an implementation of the POSIX  --
--  Ada  bindings  for  use with the GNAT Ada compiler and the FSU Gnu Ada  --
--  Runtime Library (GNARL).                                                --
--                                                                          --
--  This package specification contains some text extracted from  IEEE STD  --
--  1003.5: 1990, Information Technology -- POSIX Ada Language  Interfaces  --
--  Part 1: Binding  for  System Application Program Interface, as amended  --
--  by IEEE STD 1003.5b: 1996, Amendment 1: Realtime Extensions, copyright  --
--  1996 by the Institute of Electrical and Electronics Engineers, Inc.     --
--                                                                          --
--  The package specifications in the IEEE standards cited above represent  --
--  only a  portion  of  the  documents  and  are  not to be interpreteted  --
--  outside the context  of  the documents.  The standards must be used in  --
--  conjunction  with  the  package   specifications  in  order  to  claim  --
--  conformance.   The IEEE takes no responsibility for and will assume no  --
--  liability for damages resulting from the reader's misinterpretation of  --
--  said  information resulting from its out-of-context nature.   To order  --
--  copies of the IEEE standards,  please contact the  IEEE Service Center  --
--  at 445 Hoes Lane, PO Box 1331, Piscataway, NJ 08855-1331; via phone at  --
--  1-800-678-IEEE, 908-981-1393; or via fax at 908-981-9667.               --
--                                                                          --
--  These  package  specifications are  distributed in  the hope that they  --
--  will  be useful, but  WITHOUT  ANY  WARRANTY; without even the implied  --
--  warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.        --
--                                                                          --
------------------------------------------------------------------------------
--  [$Revision: 1.1.1.1 $]

--  .... Change POSIX.5b????

   --  ==========  --
   --   WARNINGS   --
   --  ==========  --

   --  1) DO NOT instantiate this package for a controlled type.  If you
   --  do, at best finalization will not work correctly. At worst, you
   --  will crash the entire process.

   --  2) DO NOT instantiate and use Unchecked_Deallocation for the type
   --  Shared_Access belonging to an instantiation of this package.  If
   --  you do, you are likely to end up corrupting the heap, and possibly
   --  crashing the entire process.

with POSIX.IO,
     POSIX.Permissions,
     POSIX.Memory_Mapping,
     System;
generic
   type Object_Type is private;
   --  Do not instantiate with a controlled type!
   --  See note below for reasons.
package POSIX.Generic_Shared_Memory is

   type Shared_Access is access Object_Type;

   function Open_And_Map_Shared_Memory
     (Name           : POSIX.POSIX_String;
      Protection     : POSIX.Memory_Mapping.Protection_Options;
      Masked_Signals : POSIX.Signal_Masking := POSIX.RTS_Signals)
     return POSIX.IO.File_Descriptor;
   function Open_Or_Create_And_Map_Shared_Memory
     (Name           : POSIX.POSIX_String;
      Protection     : POSIX.Memory_Mapping.Protection_Options;
      Permissions    : POSIX.Permissions.Permission_Set;
      Options        : POSIX.IO.Open_Option_Set :=
         POSIX.IO.Open_Option_Set (POSIX.IO.Empty_Set);
         --  Conversion is only to work around a GNAT3.09 problem.
      Masked_Signals : POSIX.Signal_Masking := POSIX.RTS_Signals)
     return POSIX.IO.File_Descriptor;
   function Access_Shared_Memory
     (File : POSIX.IO.File_Descriptor) return Shared_Access;
   procedure Unmap_And_Close_Shared_Memory
     (File : in POSIX.IO.File_Descriptor);
   procedure Lock_Shared_Memory (File : in POSIX.IO.File_Descriptor);
   procedure Unlock_Shared_Memory (File : in POSIX.IO.File_Descriptor);

end POSIX.Generic_Shared_Memory;