1 ------------------------------------------------------------------------------
3 -- GNAT COMPILER COMPONENTS --
9 -- Copyright (C) 2003 Free Software Foundation, Inc. --
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, 59 Temple Place - Suite 330, Boston, --
20 -- MA 02111-1307, 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 allows the creation of symbol files to be used for linking
28 -- libraries. The format of symbol files depends on the platform, so there is
29 -- several implementations of the body.
31 with GNAT
.Dynamic_Tables
;
32 with GNAT
.OS_Lib
; use GNAT
.OS_Lib
;
40 -- Create a symbol file without considering any reference
43 -- Either create a symbol file with the same major and minor IDs if
44 -- all symbols are already found in the reference file or with an
45 -- incremented minor ID, if not.
48 -- Fail if symbols are not the same as those in the reference file
50 type Symbol_Kind
is (Data
, Proc
);
51 -- To distinguish between the different kinds of symbols
53 type Symbol_Data
is record
55 Kind
: Symbol_Kind
:= Data
;
56 Present
: Boolean := True;
58 -- Data (name and kind) for each of the symbols
60 package Symbol_Table
is new GNAT
.Dynamic_Tables
61 (Table_Component_Type
=> Symbol_Data
,
62 Table_Index_Type
=> Natural,
65 Table_Increment
=> 100);
68 Original_Symbols
: Symbol_Table
.Instance
;
69 -- The symbols, if any, found in the reference symbol table
71 Complete_Symbols
: Symbol_Table
.Instance
;
72 -- The symbols, if any, found in the objects files
75 (Symbol_File
: String;
77 Symbol_Policy
: Policy
;
80 Success
: out Boolean);
81 -- Initialize a symbol file. This procedure must be called before
82 -- Processing any object file. Depending on the platforms and the
83 -- circumstances, additional messages may be issued if Quiet is False.
86 (Object_File
: String;
87 Success
: out Boolean);
88 -- Get the symbols from an object file. Success is set to True if the
89 -- object file exists and has the expected format.
93 Success
: out Boolean);
94 -- Finalize the symbol file. This procedure should be called after
95 -- Initialize (once) and Process (one or more times). If Success is
96 -- True, the symbol file is written and closed, ready to be used for
97 -- linking the library. Depending on the platforms and the circumstances,
98 -- additional messages may be issued if Quiet is False.