OSDN Git Service

2009-04-08 Thomas Quinot <quinot@adacore.com>
[pf3gnuchains/gcc-fork.git] / gcc / ada / mlib.ads
index 396c0fb..684e6e7 100644 (file)
@@ -6,36 +6,46 @@
 --                                                                          --
 --                                 S p e c                                  --
 --                                                                          --
---           Copyright (C) 1999-2001, Ada Core Technologies, Inc.           --
+--                     Copyright (C) 1999-2008, AdaCore                     --
 --                                                                          --
 -- 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 2,  or (at your option) any later ver- --
+-- 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.  See the GNU General Public License --
 -- for  more details.  You should have  received  a copy of the GNU General --
--- Public License  distributed with GNAT;  see file COPYING.  If not, write --
--- to  the Free Software Foundation,  59 Temple Place - Suite 330,  Boston, --
--- MA 02111-1307, USA.                                                      --
+-- Public License  distributed with GNAT; see file COPYING3.  If not, go to --
+-- http://www.gnu.org/licenses for a complete copy of the license.          --
 --                                                                          --
 -- GNAT was originally developed  by the GNAT team at  New York University. --
--- It is now maintained by Ada Core Technologies Inc (http://www.gnat.com). --
+-- Extensive contributions were provided by Ada Core Technologies Inc.      --
 --                                                                          --
 ------------------------------------------------------------------------------
 
 --  This package provides the core high level routines used by GNATMLIB
 --  and GNATMAKE to build libraries
 
+with Namet; use Namet;
+with Osint; use Osint;
+
 with GNAT.OS_Lib; use GNAT.OS_Lib;
 
 package MLib is
 
-   Tools_Error : exception;
-   --  ??? needs comment
+   No_Argument_List : aliased String_List := (1 .. 0 => null);
+   No_Argument      : constant String_List_Access := No_Argument_List'Access;
 
    Max_Characters_In_Library_Name : constant := 20;
-   --  ??? needs comment
+   --  Maximum number of characters in a library name.
+   --  Used by Check_Library_Name below.
+
+   type Fail_Proc is access procedure (S1 : String);
+
+   Fail : Fail_Proc := Osint.Fail'Access;
+   --  This procedure is used in the MLib hierarchy, instead of
+   --  directly calling Osint.Fail.
+   --  It is redirected to Make.Make_Failed by gnatmake.
 
    procedure Check_Library_Name (Name : String);
    --  Verify that the name of a library has the following characteristics
@@ -45,9 +55,39 @@ package MLib is
 
    procedure Build_Library
      (Ofiles      : Argument_List;
-      Afiles      : Argument_List;
       Output_File : String;
       Output_Dir  : String);
    --  Build a static library from a set of object files
 
+   procedure Copy_ALI_Files
+     (Files      : Argument_List;
+      To         : Path_Name_Type;
+      Interfaces : String_List);
+   --  Copy all ALI files Files to directory To.
+   --  Mark Interfaces ALI files as interfaces, if any.
+
+   procedure Create_Sym_Links
+     (Lib_Path    : String;
+      Lib_Version : String;
+      Lib_Dir     : String;
+      Maj_Version : String);
+
+   function Linker_Library_Path_Option return String_Access;
+   --  Linker option to specify to the linker the library directory path.
+   --  If non null, the library directory path is to be appended.
+   --  Should be deallocated by the caller, when no longer needed.
+
+   function Major_Id_Name
+     (Lib_Filename : String;
+      Lib_Version  : String) return String;
+   --  Returns the major id library file name, if it exists.
+   --  For example, if Lib_Filename is "libtoto.so" and Lib_Version is
+   --  "libtoto.so.1.2", then "libtoto.so.1" is returned.
+
+private
+
+   Preserve : Attribute := Time_Stamps;
+   --  Used by Copy_ALI_Files. Changed to None for OpenVMS, because
+   --  Copy_Attributes always fails on VMS.
+
 end MLib;