xref: /aosp_15_r20/external/coreboot/src/lib/gnat/interfac.ads (revision b9411a12aaaa7e1e6a6fb7c5e057f44ee179a49c)
1------------------------------------------------------------------------------
2--                                                                          --
3--                         GNAT COMPILER COMPONENTS                         --
4--                                                                          --
5--                           I N T E R F A C E S                            --
6--                                                                          --
7--                                 S p e c                                  --
8--                                                                          --
9--          Copyright (C) 2002-2014, Free Software Foundation, Inc.         --
10--                                                                          --
11-- This specification is derived from the Ada Reference Manual for use with --
12-- GNAT. The copyright notice above, and the license provisions that follow --
13-- apply solely to the implementation dependent sections of this file.      --
14--                                                                          --
15-- GNAT is free software;  you can  redistribute it  and/or modify it under --
16-- terms of the  GNU General Public License as published  by the Free Soft- --
17-- ware  Foundation;  either version 3,  or (at your option) any later ver- --
18-- sion.  GNAT is distributed in the hope that it will be useful, but WITH- --
19-- OUT ANY WARRANTY;  without even the  implied warranty of MERCHANTABILITY --
20-- or FITNESS FOR A PARTICULAR PURPOSE.                                     --
21--                                                                          --
22-- As a special exception under Section 7 of GPL version 3, you are granted --
23-- additional permissions described in the GCC Runtime Library Exception,   --
24-- version 3.1, as published by the Free Software Foundation.               --
25--                                                                          --
26-- You should have received a copy of the GNU General Public License and    --
27-- a copy of the GCC Runtime Library Exception along with this program;     --
28-- see the files COPYING3 and COPYING.RUNTIME respectively.  If not, see    --
29-- <http://www.gnu.org/licenses/>.                                          --
30--                                                                          --
31-- GNAT was originally developed  by the GNAT team at  New York University. --
32-- Extensive contributions were provided by Ada Core Technologies Inc.      --
33--                                                                          --
34------------------------------------------------------------------------------
35
36package Interfaces is
37   pragma Pure;
38
39   --  All identifiers in this unit are implementation defined
40
41   pragma Implementation_Defined;
42
43   type Integer_8  is range -2 **  7 .. 2 **  7 - 1;
44   for Integer_8'Size use  8;
45
46   type Integer_16 is range -2 ** 15 .. 2 ** 15 - 1;
47   for Integer_16'Size use 16;
48
49   type Integer_32 is range -2 ** 31 .. 2 ** 31 - 1;
50   for Integer_32'Size use 32;
51
52   type Integer_64 is new Long_Long_Integer;
53   for Integer_64'Size use 64;
54   --  Note: we use Long_Long_Integer'First instead of -2 ** 63 to allow this
55   --  unit to compile when using custom target configuration files where the
56   --  maximum integer is 32 bits. This is useful for static analysis tools
57   --  such as SPARK or CodePeer. In the normal case Long_Long_Integer is
58   --  always 64-bits so we get the desired 64-bit type.
59
60   type Unsigned_8  is mod 2 ** 8;
61   for Unsigned_8'Size use  8;
62
63   type Unsigned_16 is mod 2 ** 16;
64   for Unsigned_16'Size use 16;
65
66   type Unsigned_32 is mod 2 ** 32;
67   for Unsigned_32'Size use 32;
68
69   type Unsigned_64 is mod 2 ** Long_Long_Integer'Size;
70   for Unsigned_64'Size use 64;
71   --  See comment on Integer_64 above
72
73   function Shift_Left
74     (Value  : Unsigned_8;
75      Amount : Natural) return Unsigned_8;
76
77   function Shift_Right
78     (Value  : Unsigned_8;
79      Amount : Natural) return Unsigned_8;
80
81   function Shift_Right_Arithmetic
82     (Value  : Unsigned_8;
83      Amount : Natural) return Unsigned_8;
84
85   function Rotate_Left
86     (Value  : Unsigned_8;
87      Amount : Natural) return Unsigned_8;
88
89   function Rotate_Right
90     (Value  : Unsigned_8;
91      Amount : Natural) return Unsigned_8;
92
93   function Shift_Left
94     (Value  : Unsigned_16;
95      Amount : Natural) return Unsigned_16;
96
97   function Shift_Right
98     (Value  : Unsigned_16;
99      Amount : Natural) return Unsigned_16;
100
101   function Shift_Right_Arithmetic
102     (Value  : Unsigned_16;
103      Amount : Natural) return Unsigned_16;
104
105   function Rotate_Left
106     (Value  : Unsigned_16;
107      Amount : Natural) return Unsigned_16;
108
109   function Rotate_Right
110     (Value  : Unsigned_16;
111      Amount : Natural) return Unsigned_16;
112
113   function Shift_Left
114     (Value  : Unsigned_32;
115      Amount : Natural) return Unsigned_32;
116
117   function Shift_Right
118     (Value  : Unsigned_32;
119      Amount : Natural) return Unsigned_32;
120
121   function Shift_Right_Arithmetic
122     (Value  : Unsigned_32;
123      Amount : Natural) return Unsigned_32;
124
125   function Rotate_Left
126     (Value  : Unsigned_32;
127      Amount : Natural) return Unsigned_32;
128
129   function Rotate_Right
130     (Value  : Unsigned_32;
131      Amount : Natural) return Unsigned_32;
132
133   function Shift_Left
134     (Value  : Unsigned_64;
135      Amount : Natural) return Unsigned_64;
136
137   function Shift_Right
138     (Value  : Unsigned_64;
139      Amount : Natural) return Unsigned_64;
140
141   function Shift_Right_Arithmetic
142     (Value  : Unsigned_64;
143      Amount : Natural) return Unsigned_64;
144
145   function Rotate_Left
146     (Value  : Unsigned_64;
147      Amount : Natural) return Unsigned_64;
148
149   function Rotate_Right
150     (Value  : Unsigned_64;
151      Amount : Natural) return Unsigned_64;
152
153   pragma Import (Intrinsic, Shift_Left);
154   pragma Import (Intrinsic, Shift_Right);
155   pragma Import (Intrinsic, Shift_Right_Arithmetic);
156   pragma Import (Intrinsic, Rotate_Left);
157   pragma Import (Intrinsic, Rotate_Right);
158
159end Interfaces;
160