gcc/ada/5asystem.ads

   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 --                                                                          --
  11 --          Copyright (C) 1992-2002 Free Software Foundation, Inc.          --
  12 --                                                                          --
  13 -- This specification is derived from the Ada Reference Manual for use with --
  14 -- GNAT. The copyright notice above, and the license provisions that follow --
  15 -- apply solely to the  contents of the part following the private keyword. --
  16 --                                                                          --
  17 -- GNAT is free software;  you can  redistribute it  and/or modify it under --
  18 -- terms of the  GNU General Public License as published  by the Free Soft- --
  19 -- ware  Foundation;  either version 2,  or (at your option) any later ver- --
  20 -- sion.  GNAT is distributed in the hope that it will be useful, but WITH- --
  21 -- OUT ANY WARRANTY;  without even the  implied warranty of MERCHANTABILITY --
  22 -- or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License --
  23 -- for  more details.  You should have  received  a copy of the GNU General --
  24 -- Public License  distributed with GNAT;  see file COPYING.  If not, write --
  25 -- to  the Free Software Foundation,  59 Temple Place - Suite 330,  Boston, --
  26 -- MA 02111-1307, USA.                                                      --
  27 --                                                                          --
  28 -- As a special exception,  if other files  instantiate  generics from this --
  29 -- unit, or you link  this unit with other files  to produce an executable, --
  30 -- this  unit  does not  by itself cause  the resulting  executable  to  be --
  31 -- covered  by the  GNU  General  Public  License.  This exception does not --
  32 -- however invalidate  any other reasons why  the executable file  might be --
  33 -- covered by the  GNU Public License.                                      --
  34 --                                                                          --
  35 -- GNAT was originally developed  by the GNAT team at  New York University. --
  36 -- It is now maintained by Ada Core Technologies Inc (http://www.gnat.com). --
  37 --                                                                          --
  38 ------------------------------------------------------------------------------
  39
  40 package System is
  41 pragma Pure (System);
  42 --  Note that we take advantage of the implementation permission to
  43 --  make this unit Pure instead of Preelaborable, see RM 13.7(36)
  44
  45    type Name is (SYSTEM_NAME_GNAT);
  46    System_Name : constant Name := SYSTEM_NAME_GNAT;
  47
  48    --  System-Dependent Named Numbers
  49
  50    Min_Int               : constant := Long_Long_Integer'First;
  51    Max_Int               : constant := Long_Long_Integer'Last;
  52
  53    Max_Binary_Modulus    : constant := 2 ** Long_Long_Integer'Size;
  54    Max_Nonbinary_Modulus : constant := Integer'Last;
  55
  56    Max_Base_Digits       : constant := Long_Long_Float'Digits;
  57    Max_Digits            : constant := Long_Long_Float'Digits;
  58
  59    Max_Mantissa          : constant := 63;
  60    Fine_Delta            : constant := 2.0 ** (-Max_Mantissa);
  61
  62    Tick                  : constant := 1.0;
  63
  64    --  Storage-related Declarations
  65
  66    type Address is private;
  67    Null_Address : constant Address;
  68
  69    Storage_Unit : constant := 8;
  70    Word_Size    : constant := 64;
  71    Memory_Size  : constant := 2 ** 64;
  72
  73    --  Address comparison
  74
  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;
  79    function "="  (Left, Right : Address) return Boolean;
  80
  81    pragma Import (Intrinsic, "<");
  82    pragma Import (Intrinsic, "<=");
  83    pragma Import (Intrinsic, ">");
  84    pragma Import (Intrinsic, ">=");
  85    pragma Import (Intrinsic, "=");
  86
  87    --  Other System-Dependent Declarations
  88
  89    type Bit_Order is (High_Order_First, Low_Order_First);
  90    Default_Bit_Order : constant Bit_Order := Low_Order_First;
  91
  92    --  Priority-related Declarations (RM D.1)
  93
  94    Max_Priority           : constant Positive := 60;
  95    Max_Interrupt_Priority : constant Positive := 63;
  96
  97    subtype Any_Priority       is Integer      range  0 .. 63;
  98    subtype Priority           is Any_Priority range  0 .. 60;
  99    subtype Interrupt_Priority is Any_Priority range 61 .. 63;
 100
 101    Default_Priority : constant Priority := 30;
 102
 103 private
 104
 105    type Address is mod Memory_Size;
 106    Null_Address : constant Address := 0;
 107
 108    --------------------------------------
 109    -- System Implementation Parameters --
 110    --------------------------------------
 111
 112    --  These parameters provide information about the target that is used
 113    --  by the compiler. They are in the private part of System, where they
 114    --  can be accessed using the special circuitry in the Targparm unit
 115    --  whose source should be consulted for more detailed descriptions
 116    --  of the individual switch values.
 117
 118    AAMP                      : constant Boolean := False;
 119    Backend_Divide_Checks     : constant Boolean := False;
 120    Backend_Overflow_Checks   : constant Boolean := False;
 121    Command_Line_Args         : constant Boolean := True;
 122    Denorm                    : constant Boolean := False;
 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;
 138
 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.
 141
 142    ---------------------------
 143    -- Underlying Priorities --
 144    ---------------------------
 145
 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).
 150
 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.
 154
 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.
 157
 158    --  On DU prior to 4.0d, less than 64 priorities are available so there
 159    --  are two possibilities:
 160
 161    --    Limit your range of priorities to the range provided by the
 162    --    OS (e.g 16 .. 32 on 4.0b)
 163
 164    --    Replace the standard table as described below
 165
 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:
 169
 170    --     $ gcc -c -O3 -gnatpgn system.ads
 171
 172    --  then recompile the run-time parts that depend on this package:
 173
 174    --     $ gnatmake -a -gnatn -O3 <your application>
 175
 176    --  then force rebuilding your application if you need different options:
 177
 178    --     $ gnatmake -f <your options> <your application>
 179
 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
 183
 184    Underlying_Priorities : constant Priorities_Mapping :=
 185
 186      (Priority'First => 0,
 187
 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,
 194
 195       Default_Priority => 30,
 196
 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,
 203
 204       Priority'Last => 60,
 205
 206       61 => 61, 62 => 62,
 207
 208       Interrupt_Priority'Last => 63);
 209
 210 end System;