xref: /aosp_15_r20/external/coreboot/src/lib/gnat/system.ads (revision b9411a12aaaa7e1e6a6fb7c5e057f44ee179a49c)
1------------------------------------------------------------------------------
2--                                                                          --
3--                        GNAT RUN-TIME COMPONENTS                          --
4--                                                                          --
5--                               S Y S T E M                                --
6--                                                                          --
7--                                 S p e c                                  --
8--                              (LSH Version)                               --
9--                                                                          --
10--          Copyright (C) 1992-2014, Free Software Foundation, Inc.         --
11--                                                                          --
12-- This specification is derived from the Ada Reference Manual for use with --
13-- GNAT. The copyright notice above, and the license provisions that follow --
14-- apply solely to the  contents of the part following the private keyword. --
15--                                                                          --
16-- GNAT is free software;  you can  redistribute it  and/or modify it under --
17-- terms of the  GNU General Public License as published  by the Free Soft- --
18-- ware  Foundation;  either version 3,  or (at your option) any later ver- --
19-- sion.  GNAT is distributed in the hope that it will be useful, but WITH- --
20-- OUT ANY WARRANTY;  without even the  implied warranty of MERCHANTABILITY --
21-- or FITNESS FOR A PARTICULAR PURPOSE.                                     --
22--                                                                          --
23-- As a special exception under Section 7 of GPL version 3, you are granted --
24-- additional permissions described in the GCC Runtime Library Exception,   --
25-- version 3.1, as published by the Free Software Foundation.               --
26--                                                                          --
27-- You should have received a copy of the GNU General Public License and    --
28-- a copy of the GCC Runtime Library Exception along with this program;     --
29-- see the files COPYING3 and COPYING.RUNTIME respectively.  If not, see    --
30-- <http://www.gnu.org/licenses/>.                                          --
31--                                                                          --
32-- GNAT was originally developed  by the GNAT team at  New York University. --
33-- Extensive contributions were provided by Ada Core Technologies Inc.      --
34--                                                                          --
35------------------------------------------------------------------------------
36
37pragma Restrictions (No_Exception_Registration);
38
39pragma Restrictions (No_Implicit_Dynamic_Code);
40pragma Restrictions (No_Finalization);
41pragma Restrictions (No_Tasking);
42
43package System is
44   pragma Pure;
45   --  Note that we take advantage of the implementation permission to make
46   --  this unit Pure instead of Preelaborable; see RM 13.7.1(15). In Ada
47   --  2005, this is Pure in any case (AI-362).
48
49   pragma No_Elaboration_Code_All;
50   --  Allow the use of that restriction in units that WITH this unit
51
52   type Name is (SYSTEM_NAME_GNAT);
53   System_Name : constant Name := SYSTEM_NAME_GNAT;
54
55   --  System-Dependent Named Numbers
56
57   Min_Int               : constant := Long_Long_Integer'First;
58   Max_Int               : constant := Long_Long_Integer'Last;
59
60   Max_Binary_Modulus    : constant := 2 ** Long_Long_Integer'Size;
61   Max_Nonbinary_Modulus : constant := 2 ** Integer'Size - 1;
62
63   Max_Base_Digits       : constant := Long_Long_Float'Digits;
64   Max_Digits            : constant := Long_Long_Float'Digits;
65
66   Max_Mantissa          : constant := 63;
67   Fine_Delta            : constant := 2.0 ** (-Max_Mantissa);
68
69   Tick                  : constant := 0.01;
70
71   --  Storage-related Declarations
72
73   type Address is private;
74   --  Note that we do NOT add pragma Preelaborable_Initialization in this
75   --  version of System, since it is used for the compiler only, and typical
76   --  earlier bootstrap compilers don't support this pragma. We don't need
77   --  it in this context, so there is no problem in omitting it.
78   Null_Address : constant Address;
79
80   Storage_Unit : constant := Standard'Storage_Unit;
81   Word_Size    : constant := Standard'Word_Size;
82   Memory_Size  : constant := 2 ** Standard'Address_Size;
83
84   --  Address comparison
85
86   function "<"  (Left, Right : Address) return Boolean;
87   function "<=" (Left, Right : Address) return Boolean;
88   function ">"  (Left, Right : Address) return Boolean;
89   function ">=" (Left, Right : Address) return Boolean;
90   function "="  (Left, Right : Address) return Boolean;
91
92   pragma Import (Intrinsic, "<");
93   pragma Import (Intrinsic, "<=");
94   pragma Import (Intrinsic, ">");
95   pragma Import (Intrinsic, ">=");
96   pragma Import (Intrinsic, "=");
97
98   --  Other System-Dependent Declarations
99
100   type Bit_Order is (High_Order_First, Low_Order_First);
101   Default_Bit_Order : constant Bit_Order :=
102                         Bit_Order'Val (Standard'Default_Bit_Order);
103   pragma Warnings (Off, Default_Bit_Order); -- kill constant condition warning
104
105   --  Priority-related Declarations (RM D.1)
106
107   Max_Priority           : constant Positive := 30;
108   Max_Interrupt_Priority : constant Positive := 31;
109
110   subtype Any_Priority       is Integer      range  0 .. 31;
111   subtype Priority           is Any_Priority range  0 .. 30;
112   subtype Interrupt_Priority is Any_Priority range 31 .. 31;
113
114   Default_Priority : constant Priority := 15;
115
116private
117
118   Run_Time_Name : constant String := "coreboot Zero Footprint Run Time";
119
120   type Address is mod Memory_Size;
121   Null_Address : constant Address := 0;
122
123   --------------------------------------
124   -- System Implementation Parameters --
125   --------------------------------------
126
127   --  These parameters provide information about the target that is used by
128   --  the compiler. They are in the private part of System, where they can be
129   --  accessed using the special circuitry in the Targparm unit whose source
130   --  should be consulted for more detailed descriptions of the individual
131   --  switch values.
132
133   --  This version of system.ads is used only for building the compiler.
134   --  We really ought to use the proper target system (i.e. the one that
135   --  corresponds to the host for the compiler), but that causes as yet
136   --  unsolved makefile problems. For the most part the setting of these
137   --  parameters is not too critical for the compiler version (e.g. we
138   --  do not use floating-point anyway in the compiler).
139
140   AAMP                      : constant Boolean := False;
141   Backend_Divide_Checks     : constant Boolean := False;
142   Backend_Overflow_Checks   : constant Boolean := True;
143   Command_Line_Args         : constant Boolean := False;
144   Configurable_Run_Time     : constant Boolean := True;
145   Denorm                    : constant Boolean := True;
146   Duration_32_Bits          : constant Boolean := False;
147   Exit_Status_Supported     : constant Boolean := False;
148   Fractional_Fixed_Ops      : constant Boolean := False;
149   Frontend_Layout           : constant Boolean := False;
150   Machine_Overflows         : constant Boolean := False;
151   Machine_Rounds            : constant Boolean := True;
152   Preallocated_Stacks       : constant Boolean := False;
153   Signed_Zeros              : constant Boolean := True;
154   Stack_Check_Default       : constant Boolean := False;
155   Stack_Check_Probes        : constant Boolean := False;
156   Stack_Check_Limits        : constant Boolean := False;
157   Support_Aggregates        : constant Boolean := True;
158   Support_Composite_Assign  : constant Boolean := True;
159   Support_Composite_Compare : constant Boolean := True;
160   Support_Long_Shifts       : constant Boolean := True;
161   Always_Compatible_Rep     : constant Boolean := True;
162   Suppress_Standard_Library : constant Boolean := True;
163   Use_Ada_Main_Program_Name : constant Boolean := False;
164   ZCX_By_Default            : constant Boolean := False;
165
166   --  Obsolete entries, to be removed eventually (bootstrap issues)
167
168   Front_End_ZCX_Support     : constant Boolean := False;
169   High_Integrity_Mode       : constant Boolean := False;
170   Long_Shifts_Inlined       : constant Boolean := True;
171   Functions_Return_By_DSP   : constant Boolean := False;
172   Support_64_Bit_Divides    : constant Boolean := True;
173   GCC_ZCX_Support           : constant Boolean := False;
174
175end System;
176