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 2, 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 COPYING. If not, write --
19 -- to the Free Software Foundation, 51 Franklin Street, Fifth Floor, --
20 -- Boston, MA 02110-1301, USA. --
22 -- GNAT was originally developed by the GNAT team at New York University. --
23 -- Extensive contributions were provided by Ada Core Technologies Inc. --
25 ------------------------------------------------------------------------------
27 -- This package provides the core high level routines used by GNATMLIB
28 -- and GNATMAKE to build libraries
30 with Namet; use Namet;
31 with Osint; use Osint;
33 with GNAT.OS_Lib; use GNAT.OS_Lib;
37 Max_Characters_In_Library_Name : constant := 20;
38 -- Maximum number of characters in a library name.
39 -- Used by Check_Library_Name below.
41 type Fail_Proc is access procedure
42 (S1 : String; S2 : String := ""; S3 : String := "");
44 Fail : Fail_Proc := Osint.Fail'Access;
45 -- This procedure is used in the MLib hierarchy, instead of
46 -- directly calling Osint.Fail.
47 -- It is redirected to Make.Make_Failed by gnatmake.
49 procedure Check_Library_Name (Name : String);
50 -- Verify that the name of a library has the following characteristics
51 -- - starts with a letter
52 -- - includes only letters and digits
53 -- - contains not more than Max_Characters_In_Library_Name characters
55 procedure Build_Library
56 (Ofiles : Argument_List;
57 Afiles : Argument_List;
60 -- Build a static library from a set of object files
62 procedure Copy_ALI_Files
63 (Files : Argument_List;
65 Interfaces : String_List);
66 -- Copy all ALI files Files to directory To.
67 -- Mark Interfaces ALI files as interfaces, if any.
69 function Linker_Library_Path_Option return String_Access;
70 -- Linker option to specify to the linker the library directory path.
71 -- If non null, the library directory path is to be appended.
72 -- Should be deallocated by the caller, when no longer needed.
76 Preserve : Attribute := Time_Stamps;
77 -- Used by Copy_ALI_Files. Changed to None for OpenVMS, because
78 -- Copy_Attributes always fails on VMS.