1 ------------------------------------------------------------------------------
3 -- GNAT COMPILER COMPONENTS --
9 -- Copyright (C) 2019-2021, 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 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 -- The following unit contains the main entry point into the elaboration order
27 -- mechanism. See the body for details.
30 with Namet
; use Namet
;
34 -- The following type represents the various phases of the elaboration
37 type Elaboration_Phase
is
42 Elaboration_Order_Validation
,
43 Invocation_Graph_Construction
,
44 Invocation_Graph_Validation
,
45 Library_Graph_Augmentation
,
46 Library_Graph_Construction
,
47 Library_Graph_Elaboration
,
48 Library_Graph_Validation
,
52 -- The following type represents the various kinds of precedence between
55 type Precedence_Kind
is
60 procedure Find_Elaboration_Order
61 (Order
: out Unit_Id_Table
;
62 Main_Lib_File
: File_Name_Type
);
63 -- Find an order of all units in the bind that need to be elaborated
64 -- such that elaboration code flow, pragmas Elaborate, Elaborate_All,
65 -- and Elaborate_Body, and with clause dependencies are all honoured.
66 -- Main_Lib_File is the argument of the bind. If a satisfactory order
67 -- exists, it is returned in Order, otherwise Unrecoverable_Error is