gcc/ada/system-vms_64.ads

   1 ------------------------------------------------------------------------------
   2 --                                                                          --
   3 --                        GNAT RUN-TIME COMPONENTS                          --
   4 --                                                                          --
   5 --                               S Y S T E M                                --
   6 --                                                                          --
   7 --                                 S p e c                                  --
   8 --                (OpenVMS 64bit GCC_ZCX DEC Threads Version)               --
   9 --                                                                          --
  10 --          Copyright (C) 1992-2007, 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,  51  Franklin  Street,  Fifth  Floor, --
  25 -- Boston, MA 02110-1301, 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 ------------------------------------------------------------------------------
  38
  39 package System is
  40    pragma Pure;
  41    --  Note that we take advantage of the implementation permission to make
  42    --  this unit Pure instead of Preelaborable; see RM 13.7.1(15). In Ada
  43    --  2005, this is Pure in any case (AI-362).
  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 := 2 ** Integer'Size - 1;
  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 := 0.01;
  63
  64    --  Storage-related Declarations
  65
  66    type Address is new Long_Integer;
  67    Null_Address : constant Address;
  68    --  Although this is declared as an integer type, no arithmetic operations
  69    --  are available (see abstract declarations below), and furthermore there
  70    --  is special processing in the compiler that prevents the use of integer
  71    --  literals with this type (use To_Address to convert integer literals).
  72    --
  73    --  Conversion to and from Short_Address is however freely permitted, and
  74    --  is indeed the reason that Address is declared as an integer type.
  75
  76    Storage_Unit : constant := 8;
  77    Word_Size    : constant := 64;
  78    Memory_Size  : constant := 2 ** 64;
  79
  80    --  Address comparison
  81
  82    function "<"  (Left, Right : Address) return Boolean;
  83    function "<=" (Left, Right : Address) return Boolean;
  84    function ">"  (Left, Right : Address) return Boolean;
  85    function ">=" (Left, Right : Address) return Boolean;
  86    function "="  (Left, Right : Address) return Boolean;
  87
  88    pragma Import (Intrinsic, "<");
  89    pragma Import (Intrinsic, "<=");
  90    pragma Import (Intrinsic, ">");
  91    pragma Import (Intrinsic, ">=");
  92    pragma Import (Intrinsic, "=");
  93
  94    --  Abstract declarations for arithmetic operations on type address.
  95    --  These declarations are needed when Address is non-private. They
  96    --  avoid excessive visibility of arithmetic operations on address
  97    --  which are typically available elsewhere (e.g. Storage_Elements)
  98    --  and which would cause excessive ambiguities in application code.
  99
 100    function "+"   (Left, Right : Address) return Address is abstract;
 101    function "-"   (Left, Right : Address) return Address is abstract;
 102    function "/"   (Left, Right : Address) return Address is abstract;
 103    function "*"   (Left, Right : Address) return Address is abstract;
 104    function "mod" (Left, Right : Address) return Address is abstract;
 105
 106    --  Other System-Dependent Declarations
 107
 108    type Bit_Order is (High_Order_First, Low_Order_First);
 109    Default_Bit_Order : constant Bit_Order := Low_Order_First;
 110    pragma Warnings (Off, Default_Bit_Order); -- kill constant condition warning
 111
 112    --  Priority-related Declarations (RM D.1)
 113
 114    Max_Priority           : constant Positive := 30;
 115    Max_Interrupt_Priority : constant Positive := 31;
 116
 117    subtype Any_Priority       is Integer      range  0 .. 31;
 118    subtype Priority           is Any_Priority range  0 .. 30;
 119    subtype Interrupt_Priority is Any_Priority range 31 .. 31;
 120
 121    Default_Priority : constant Priority := 15;
 122
 123 private
 124
 125    Null_Address : constant Address := 0;
 126
 127    --------------------------------------
 128    -- System Implementation Parameters --
 129    --------------------------------------
 130
 131    --  These parameters provide information about the target that is used
 132    --  by the compiler. They are in the private part of System, where they
 133    --  can be accessed using the special circuitry in the Targparm unit
 134    --  whose source should be consulted for more detailed descriptions
 135    --  of the individual switch values.
 136
 137    Backend_Divide_Checks     : constant Boolean := False;
 138    Backend_Overflow_Checks   : constant Boolean := False;
 139    Command_Line_Args         : constant Boolean := True;
 140    Configurable_Run_Time     : constant Boolean := False;
 141    Denorm                    : constant Boolean := False;
 142    Duration_32_Bits          : constant Boolean := False;
 143    Exit_Status_Supported     : constant Boolean := True;
 144    Fractional_Fixed_Ops      : constant Boolean := False;
 145    Frontend_Layout           : constant Boolean := False;
 146    Machine_Overflows         : constant Boolean := False;
 147    Machine_Rounds            : constant Boolean := True;
 148    OpenVMS                   : constant Boolean := True;
 149    Preallocated_Stacks       : constant Boolean := False;
 150    Signed_Zeros              : constant Boolean := True;
 151    Stack_Check_Default       : constant Boolean := True;
 152    Stack_Check_Probes        : constant Boolean := True;
 153    Stack_Check_Limits        : constant Boolean := False;
 154    Support_64_Bit_Divides    : constant Boolean := True;
 155    Support_Aggregates        : constant Boolean := True;
 156    Support_Composite_Assign  : constant Boolean := True;
 157    Support_Composite_Compare : constant Boolean := True;
 158    Support_Long_Shifts       : constant Boolean := True;
 159    Always_Compatible_Rep     : constant Boolean := True;
 160    Suppress_Standard_Library : constant Boolean := False;
 161    Use_Ada_Main_Program_Name : constant Boolean := False;
 162    ZCX_By_Default            : constant Boolean := True;
 163    GCC_ZCX_Support           : constant Boolean := True;
 164
 165    --------------------------
 166    -- Underlying Priorities --
 167    ---------------------------
 168
 169    --  Important note: this section of the file must come AFTER the
 170    --  definition of the system implementation parameters to ensure
 171    --  that the value of these parameters is available for analysis
 172    --  of the declarations here (using Rtsfind at compile time).
 173
 174    --  The underlying priorities table provides a generalized mechanism
 175    --  for mapping from Ada priorities to system priorities. In some
 176    --  cases a 1-1 mapping is not the convenient or optimal choice.
 177
 178    --  For DEC Threads OpenVMS, we use the full range of 31 priorities
 179    --  in the Ada model, but map them by compression onto the more limited
 180    --  range of priorities available in OpenVMS.
 181
 182    --  To replace the default values of the Underlying_Priorities mapping,
 183    --  copy this source file into your build directory, edit the file to
 184    --  reflect your desired behavior, and recompile with the command:
 185
 186    --     $ gcc -c -O3 -gnatpgn system.ads
 187
 188    --  then recompile the run-time parts that depend on this package:
 189
 190    --     $ gnatmake -a -gnatn -O3 <your application>
 191
 192    --  then force rebuilding your application if you need different options:
 193
 194    --     $ gnatmake -f <your options> <your application>
 195
 196    type Priorities_Mapping is array (Any_Priority) of Integer;
 197    pragma Suppress_Initialization (Priorities_Mapping);
 198    --  Suppress initialization in case gnat.adc specifies Normalize_Scalars
 199
 200    Underlying_Priorities : constant Priorities_Mapping :=
 201
 202      (Priority'First => 16,
 203
 204       1  => 17,
 205       2  => 18,
 206       3  => 18,
 207       4  => 18,
 208       5  => 18,
 209       6  => 19,
 210       7  => 19,
 211       8  => 19,
 212       9  => 20,
 213       10 => 20,
 214       11 => 21,
 215       12 => 21,
 216       13 => 22,
 217       14 => 23,
 218
 219       Default_Priority   => 24,
 220
 221       16 => 25,
 222       17 => 25,
 223       18 => 25,
 224       19 => 26,
 225       20 => 26,
 226       21 => 26,
 227       22 => 27,
 228       23 => 27,
 229       24 => 27,
 230       25 => 28,
 231       26 => 28,
 232       27 => 29,
 233       28 => 29,
 234       29 => 30,
 235
 236       Priority'Last      => 30,
 237
 238       Interrupt_Priority => 31);
 239
 240    ----------------------------
 241    -- Special VMS Interfaces --
 242    ----------------------------
 243
 244    procedure Lib_Stop (I : Integer);
 245    pragma Interface (C, Lib_Stop);
 246    pragma Import_Procedure (Lib_Stop, "LIB$STOP", Mechanism => (Value));
 247    --  Interface to VMS condition handling. Used by RTSfind and pragma
 248    --  {Import,Export}_Exception. Put here because this is the only
 249    --  VMS specific package that doesn't drag in tasking.
 250
 251    ADA_GNAT : constant Boolean := True;
 252    pragma Export_Object (ADA_GNAT, "ADA$GNAT");
 253    --  Ubiquitous global symbol identifying a GNAT compiled image to VMS Debug.
 254    --  Do not remove!
 255
 256 end System;