1 ------------------------------------------------------------------------------
3 -- GNAT COMPILER COMPONENTS --
9 -- Copyright (C) 1999-2007, AdaCore --
11 -- GNAT is free software; you can redistribute it and/or modify it under --
12 -- terms of the GNU General Public License as published by the Free Soft- --
13 -- ware Foundation; either version 3, or (at your option) any later ver- --
14 -- sion. GNAT is distributed in the hope that it will be useful, but WITH- --
15 -- OUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY --
16 -- or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License --
17 -- for more details. You should have received a copy of the GNU General --
18 -- Public License distributed with GNAT; see file COPYING3. If not, go to --
19 -- http://www.gnu.org/licenses for a complete copy of the license. --
21 -- GNAT was originally developed by the GNAT team at New York University. --
22 -- Extensive contributions were provided by Ada Core Technologies Inc. --
24 ------------------------------------------------------------------------------
26 -- This package provides the core high level routines used by GNATMLIB
27 -- and GNATMAKE to build libraries
29 with Namet; use Namet;
30 with Osint; use Osint;
32 with GNAT.OS_Lib; use GNAT.OS_Lib;
36 No_Argument_List : aliased String_List := (1 .. 0 => null);
37 No_Argument : constant String_List_Access := No_Argument_List'Access;
39 Max_Characters_In_Library_Name : constant := 20;
40 -- Maximum number of characters in a library name.
41 -- Used by Check_Library_Name below.
43 type Fail_Proc is access procedure
44 (S1 : String; S2 : String := ""; S3 : String := "");
46 Fail : Fail_Proc := Osint.Fail'Access;
47 -- This procedure is used in the MLib hierarchy, instead of
48 -- directly calling Osint.Fail.
49 -- It is redirected to Make.Make_Failed by gnatmake.
51 procedure Check_Library_Name (Name : String);
52 -- Verify that the name of a library has the following characteristics
53 -- - starts with a letter
54 -- - includes only letters and digits
55 -- - contains not more than Max_Characters_In_Library_Name characters
57 procedure Build_Library
58 (Ofiles : Argument_List;
61 -- Build a static library from a set of object files
63 procedure Copy_ALI_Files
64 (Files : Argument_List;
66 Interfaces : String_List);
67 -- Copy all ALI files Files to directory To.
68 -- Mark Interfaces ALI files as interfaces, if any.
70 procedure Create_Sym_Links
74 Maj_Version : String);
76 function Linker_Library_Path_Option return String_Access;
77 -- Linker option to specify to the linker the library directory path.
78 -- If non null, the library directory path is to be appended.
79 -- Should be deallocated by the caller, when no longer needed.
81 function Major_Id_Name
82 (Lib_Filename : String;
83 Lib_Version : String) return String;
84 -- Returns the major id library file name, if it exists.
85 -- For example, if Lib_Filename is "libtoto.so" and Lib_Version is
86 -- "libtoto.so.1.2", then "libtoto.so.1" is returned.
90 Preserve : Attribute := Time_Stamps;
91 -- Used by Copy_ALI_Files. Changed to None for OpenVMS, because
92 -- Copy_Attributes always fails on VMS.