File : s-elaall.ads
1 ------------------------------------------------------------------------------
2 -- --
3 -- GNAT RUN-TIME COMPONENTS --
4 -- --
5 -- S Y S T E M . E L A B O R A T I O N _ A L L O C A T O R S --
6 -- --
7 -- S p e c --
8 -- --
9 -- Copyright (C) 2014, Free Software Foundation, Inc. --
10 -- --
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. --
17 -- --
18 -- --
19 -- --
20 -- --
21 -- --
22 -- You should have received a copy of the GNU General Public License and --
23 -- a copy of the GCC Runtime Library Exception along with this program; --
24 -- see the files COPYING3 and COPYING.RUNTIME respectively. If not, see --
25 -- <http://www.gnu.org/licenses/>. --
26 -- --
27 -- GNAT was originally developed by the GNAT team at New York University. --
28 -- Extensive contributions were provided by Ada Core Technologies Inc. --
29 -- --
30 ------------------------------------------------------------------------------
31
32 -- This package provides the interfaces for proper handling of restriction
33 -- No_Standard_Allocators_After_Elaboration. It is used only by programs
34 -- which use this restriction.
35
36 package System.Elaboration_Allocators is
37 pragma Preelaborate;
38
39 procedure Mark_Start_Of_Elaboration;
40 -- Called right at the start of main elaboration if the program activates
41 -- restriction No_Standard_Allocators_After_Elaboration. We don't want to
42 -- rely on the normal elaboration mechanism for marking this event, since
43 -- that would require us to be sure to elaborate this first, which would
44 -- be awkward, and it is convenient to have this package be Preelaborate.
45
46 procedure Mark_End_Of_Elaboration;
47 -- Called when main elaboration is complete if the program has activated
48 -- restriction No_Standard_Allocators_After_Elaboration. This is the point
49 -- beyond which any standard allocator use will violate the restriction.
50
51 procedure Check_Standard_Allocator;
52 -- Called as part of every allocator in a program for which the restriction
53 -- No_Standard_Allocators_After_Elaboration is active. This will raise an
54 -- exception (Program_Error with an appropriate message) if it is called
55 -- after the call to Mark_End_Of_Elaboration.
56
57 end System.Elaboration_Allocators;