include/ChangeLog:
[official-gcc.git] / gcc / ada / 5asystem.ads
blobee49d71763254bd56ff031bf329c2c3b3349e794
1 ------------------------------------------------------------------------------
2 -- --
3 -- GNAT RUN-TIME COMPONENTS --
4 -- --
5 -- S Y S T E M --
6 -- --
7 -- S p e c --
8 -- (DEC Unix Version) --
9 -- --
10 -- Copyright (C) 1992-2003 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 2, 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. See the GNU General Public License --
22 -- for more details. You should have received a copy of the GNU General --
23 -- Public License distributed with GNAT; see file COPYING. If not, write --
24 -- to the Free Software Foundation, 59 Temple Place - Suite 330, Boston, --
25 -- MA 02111-1307, USA. --
26 -- --
27 -- As a special exception, if other files instantiate generics from this --
28 -- unit, or you link this unit with other files to produce an executable, --
29 -- this unit does not by itself cause the resulting executable to be --
30 -- covered by the GNU General Public License. This exception does not --
31 -- however invalidate any other reasons why the executable file might be --
32 -- covered by the GNU Public License. --
33 -- --
34 -- GNAT was originally developed by the GNAT team at New York University. --
35 -- Extensive contributions were provided by Ada Core Technologies Inc. --
36 -- --
37 ------------------------------------------------------------------------------
39 package System is
40 pragma Pure (System);
41 -- Note that we take advantage of the implementation permission to
42 -- make this unit Pure instead of Preelaborable, see RM 13.7(36)
44 type Name is (SYSTEM_NAME_GNAT);
45 System_Name : constant Name := SYSTEM_NAME_GNAT;
47 -- System-Dependent Named Numbers
49 Min_Int : constant := Long_Long_Integer'First;
50 Max_Int : constant := Long_Long_Integer'Last;
52 Max_Binary_Modulus : constant := 2 ** Long_Long_Integer'Size;
53 Max_Nonbinary_Modulus : constant := Integer'Last;
55 Max_Base_Digits : constant := Long_Long_Float'Digits;
56 Max_Digits : constant := Long_Long_Float'Digits;
58 Max_Mantissa : constant := 63;
59 Fine_Delta : constant := 2.0 ** (-Max_Mantissa);
61 Tick : constant := 1.0 / 1024.0;
63 -- Storage-related Declarations
65 type Address is private;
66 Null_Address : constant Address;
68 Storage_Unit : constant := 8;
69 Word_Size : constant := 64;
70 Memory_Size : constant := 2 ** 64;
72 -- Address comparison
74 function "<" (Left, Right : Address) return Boolean;
75 function "<=" (Left, Right : Address) return Boolean;
76 function ">" (Left, Right : Address) return Boolean;
77 function ">=" (Left, Right : Address) return Boolean;
78 function "=" (Left, Right : Address) return Boolean;
80 pragma Import (Intrinsic, "<");
81 pragma Import (Intrinsic, "<=");
82 pragma Import (Intrinsic, ">");
83 pragma Import (Intrinsic, ">=");
84 pragma Import (Intrinsic, "=");
86 -- Other System-Dependent Declarations
88 type Bit_Order is (High_Order_First, Low_Order_First);
89 Default_Bit_Order : constant Bit_Order := Low_Order_First;
91 -- Priority-related Declarations (RM D.1)
93 Max_Priority : constant Positive := 60;
94 Max_Interrupt_Priority : constant Positive := 63;
96 subtype Any_Priority is Integer range 0 .. 63;
97 subtype Priority is Any_Priority range 0 .. 60;
98 subtype Interrupt_Priority is Any_Priority range 61 .. 63;
100 Default_Priority : constant Priority := 30;
102 private
104 type Address is mod Memory_Size;
105 Null_Address : constant Address := 0;
107 --------------------------------------
108 -- System Implementation Parameters --
109 --------------------------------------
111 -- These parameters provide information about the target that is used
112 -- by the compiler. They are in the private part of System, where they
113 -- can be accessed using the special circuitry in the Targparm unit
114 -- whose source should be consulted for more detailed descriptions
115 -- of the individual switch values.
117 AAMP : constant Boolean := False;
118 Backend_Divide_Checks : constant Boolean := False;
119 Backend_Overflow_Checks : constant Boolean := False;
120 Command_Line_Args : constant Boolean := True;
121 Denorm : constant Boolean := False;
122 Exit_Status_Supported : constant Boolean := True;
123 Fractional_Fixed_Ops : constant Boolean := False;
124 Frontend_Layout : constant Boolean := False;
125 Functions_Return_By_DSP : constant Boolean := False;
126 Long_Shifts_Inlined : constant Boolean := True;
127 High_Integrity_Mode : constant Boolean := False;
128 Machine_Overflows : constant Boolean := False;
129 Machine_Rounds : constant Boolean := True;
130 OpenVMS : constant Boolean := False;
131 Signed_Zeros : constant Boolean := True;
132 Stack_Check_Default : constant Boolean := True;
133 Stack_Check_Probes : constant Boolean := True;
134 Use_Ada_Main_Program_Name : constant Boolean := False;
135 ZCX_By_Default : constant Boolean := False;
136 GCC_ZCX_Support : constant Boolean := False;
137 Front_End_ZCX_Support : constant Boolean := False;
139 -- Note: Denorm is False because denormals are only handled properly
140 -- if the -mieee switch is set, and we do not require this usage.
142 ---------------------------
143 -- Underlying Priorities --
144 ---------------------------
146 -- Important note: this section of the file must come AFTER the
147 -- definition of the system implementation parameters to ensure
148 -- that the value of these parameters is available for analysis
149 -- of the declarations here (using Rtsfind at compile time).
151 -- The underlying priorities table provides a generalized mechanism
152 -- for mapping from Ada priorities to system priorities. In some
153 -- cases a 1-1 mapping is not the convenient or optimal choice.
155 -- For Dec Unix 4.0d, we use a default 1-to-1 mapping that provides
156 -- the full range of 64 priorities available from the operating system.
158 -- On DU prior to 4.0d, less than 64 priorities are available so there
159 -- are two possibilities:
161 -- Limit your range of priorities to the range provided by the
162 -- OS (e.g 16 .. 32 on 4.0b)
164 -- Replace the standard table as described below
166 -- To replace the default values of the Underlying_Priorities mapping,
167 -- copy this source file into your build directory, edit the file to
168 -- reflect your desired behavior, and recompile with the command:
170 -- $ gcc -c -O3 -gnatpgn system.ads
172 -- then recompile the run-time parts that depend on this package:
174 -- $ gnatmake -a -gnatn -O3 <your application>
176 -- then force rebuilding your application if you need different options:
178 -- $ gnatmake -f <your options> <your application>
180 type Priorities_Mapping is array (Any_Priority) of Integer;
181 pragma Suppress_Initialization (Priorities_Mapping);
182 -- Suppress initialization in case gnat.adc specifies Normalize_Scalars
184 Underlying_Priorities : constant Priorities_Mapping :=
186 (Priority'First => 0,
188 1 => 1, 2 => 2, 3 => 3, 4 => 4, 5 => 5,
189 6 => 6, 7 => 7, 8 => 8, 9 => 9, 10 => 10,
190 11 => 11, 12 => 12, 13 => 13, 14 => 14, 15 => 15,
191 16 => 16, 17 => 17, 18 => 18, 19 => 19, 20 => 20,
192 21 => 21, 22 => 22, 23 => 23, 24 => 24, 25 => 25,
193 26 => 26, 27 => 27, 28 => 28, 29 => 29,
195 Default_Priority => 30,
197 31 => 31, 32 => 32, 33 => 33, 34 => 34, 35 => 35,
198 36 => 36, 37 => 37, 38 => 38, 39 => 39, 40 => 40,
199 41 => 41, 42 => 42, 43 => 43, 44 => 44, 45 => 45,
200 46 => 46, 47 => 47, 48 => 48, 49 => 49, 50 => 50,
201 51 => 51, 52 => 52, 53 => 53, 54 => 54, 55 => 55,
202 56 => 56, 57 => 57, 58 => 58, 59 => 59,
204 Priority'Last => 60,
206 61 => 61, 62 => 62,
208 Interrupt_Priority'Last => 63);
210 end System;