1------------------------------------------------------------------------------ 2-- -- 3-- GNAT COMPILER COMPONENTS -- 4-- -- 5-- D E B U G -- 6-- -- 7-- S p e c -- 8-- -- 9-- Copyright (C) 1992-2003 Free Software Foundation, Inc. -- 10-- -- 11-- GNAT is free software; you can redistribute it and/or modify it under -- 12-- terms of the GNU General Public License as published by the Free Soft- -- 13-- ware Foundation; either version 2, or (at your option) any later ver- -- 14-- sion. GNAT is distributed in the hope that it will be useful, but WITH- -- 15-- OUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY -- 16-- or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License -- 17-- for more details. You should have received a copy of the GNU General -- 18-- Public License distributed with GNAT; see file COPYING. If not, write -- 19-- to the Free Software Foundation, 59 Temple Place - Suite 330, Boston, -- 20-- MA 02111-1307, USA. -- 21-- -- 22-- As a special exception, if other files instantiate generics from this -- 23-- unit, or you link this unit with other files to produce an executable, -- 24-- this unit does not by itself cause the resulting executable to be -- 25-- covered by the GNU General Public License. This exception does not -- 26-- however invalidate any other reasons why the executable file might be -- 27-- covered by the GNU Public License. -- 28-- -- 29-- GNAT was originally developed by the GNAT team at New York University. -- 30-- Extensive contributions were provided by Ada Core Technologies Inc. -- 31-- -- 32------------------------------------------------------------------------------ 33 34package Debug is 35pragma Preelaborate (Debug); 36 37-- This package contains global flags used to control the inclusion 38-- of debugging code in various phases of the compiler. Some of these 39-- flags are also used by the binder and gnatmake. 40 41 ------------------------- 42 -- Dynamic Debug Flags -- 43 ------------------------- 44 45 -- Sixty two flags that can be used to active various specialized 46 -- debugging output information. The flags are preset to False, which 47 -- corresponds to the given output being suppressed. The individual 48 -- flags can be turned on using the undocumented switch dxxx where 49 -- xxx is a string of letters for flags to be turned on. Documentation 50 -- on the current usage of these flags is contained in the body of Debug 51 -- rather than the spec, so that we don't have to recompile the world 52 -- when a new debug flag is added 53 54 Debug_Flag_A : Boolean := False; 55 Debug_Flag_B : Boolean := False; 56 Debug_Flag_C : Boolean := False; 57 Debug_Flag_D : Boolean := False; 58 Debug_Flag_E : Boolean := False; 59 Debug_Flag_F : Boolean := False; 60 Debug_Flag_G : Boolean := False; 61 Debug_Flag_H : Boolean := False; 62 Debug_Flag_I : Boolean := False; 63 Debug_Flag_J : Boolean := False; 64 Debug_Flag_K : Boolean := False; 65 Debug_Flag_L : Boolean := False; 66 Debug_Flag_M : Boolean := False; 67 Debug_Flag_N : Boolean := False; 68 Debug_Flag_O : Boolean := False; 69 Debug_Flag_P : Boolean := False; 70 Debug_Flag_Q : Boolean := False; 71 Debug_Flag_R : Boolean := False; 72 Debug_Flag_S : Boolean := False; 73 Debug_Flag_T : Boolean := False; 74 Debug_Flag_U : Boolean := False; 75 Debug_Flag_V : Boolean := False; 76 Debug_Flag_W : Boolean := False; 77 Debug_Flag_X : Boolean := False; 78 Debug_Flag_Y : Boolean := False; 79 Debug_Flag_Z : Boolean := False; 80 81 Debug_Flag_AA : Boolean := False; 82 Debug_Flag_BB : Boolean := False; 83 Debug_Flag_CC : Boolean := False; 84 Debug_Flag_DD : Boolean := False; 85 Debug_Flag_EE : Boolean := False; 86 Debug_Flag_FF : Boolean := False; 87 Debug_Flag_GG : Boolean := False; 88 Debug_Flag_HH : Boolean := False; 89 Debug_Flag_II : Boolean := False; 90 Debug_Flag_JJ : Boolean := False; 91 Debug_Flag_KK : Boolean := False; 92 Debug_Flag_LL : Boolean := False; 93 Debug_Flag_MM : Boolean := False; 94 Debug_Flag_NN : Boolean := False; 95 Debug_Flag_OO : Boolean := False; 96 Debug_Flag_PP : Boolean := False; 97 Debug_Flag_QQ : Boolean := False; 98 Debug_Flag_RR : Boolean := False; 99 Debug_Flag_SS : Boolean := False; 100 Debug_Flag_TT : Boolean := False; 101 Debug_Flag_UU : Boolean := False; 102 Debug_Flag_VV : Boolean := False; 103 Debug_Flag_WW : Boolean := False; 104 Debug_Flag_XX : Boolean := False; 105 Debug_Flag_YY : Boolean := False; 106 Debug_Flag_ZZ : Boolean := False; 107 108 Debug_Flag_1 : Boolean := False; 109 Debug_Flag_2 : Boolean := False; 110 Debug_Flag_3 : Boolean := False; 111 Debug_Flag_4 : Boolean := False; 112 Debug_Flag_5 : Boolean := False; 113 Debug_Flag_6 : Boolean := False; 114 Debug_Flag_7 : Boolean := False; 115 Debug_Flag_8 : Boolean := False; 116 Debug_Flag_9 : Boolean := False; 117 118 Debug_Flag_Dot_A : Boolean := False; 119 Debug_Flag_Dot_B : Boolean := False; 120 Debug_Flag_Dot_C : Boolean := False; 121 Debug_Flag_Dot_D : Boolean := False; 122 Debug_Flag_Dot_E : Boolean := False; 123 Debug_Flag_Dot_F : Boolean := False; 124 Debug_Flag_Dot_G : Boolean := False; 125 Debug_Flag_Dot_H : Boolean := False; 126 Debug_Flag_Dot_I : Boolean := False; 127 Debug_Flag_Dot_J : Boolean := False; 128 Debug_Flag_Dot_K : Boolean := False; 129 Debug_Flag_Dot_L : Boolean := False; 130 Debug_Flag_Dot_M : Boolean := False; 131 Debug_Flag_Dot_N : Boolean := False; 132 Debug_Flag_Dot_O : Boolean := False; 133 Debug_Flag_Dot_P : Boolean := False; 134 Debug_Flag_Dot_Q : Boolean := False; 135 Debug_Flag_Dot_R : Boolean := False; 136 Debug_Flag_Dot_S : Boolean := False; 137 Debug_Flag_Dot_T : Boolean := False; 138 Debug_Flag_Dot_U : Boolean := False; 139 Debug_Flag_Dot_V : Boolean := False; 140 Debug_Flag_Dot_W : Boolean := False; 141 Debug_Flag_Dot_X : Boolean := False; 142 Debug_Flag_Dot_Y : Boolean := False; 143 Debug_Flag_Dot_Z : Boolean := False; 144 145 Debug_Flag_Dot_AA : Boolean := False; 146 Debug_Flag_Dot_BB : Boolean := False; 147 Debug_Flag_Dot_CC : Boolean := False; 148 Debug_Flag_Dot_DD : Boolean := False; 149 Debug_Flag_Dot_EE : Boolean := False; 150 Debug_Flag_Dot_FF : Boolean := False; 151 Debug_Flag_Dot_GG : Boolean := False; 152 Debug_Flag_Dot_HH : Boolean := False; 153 Debug_Flag_Dot_II : Boolean := False; 154 Debug_Flag_Dot_JJ : Boolean := False; 155 Debug_Flag_Dot_KK : Boolean := False; 156 Debug_Flag_Dot_LL : Boolean := False; 157 Debug_Flag_Dot_MM : Boolean := False; 158 Debug_Flag_Dot_NN : Boolean := False; 159 Debug_Flag_Dot_OO : Boolean := False; 160 Debug_Flag_Dot_PP : Boolean := False; 161 Debug_Flag_Dot_QQ : Boolean := False; 162 Debug_Flag_Dot_RR : Boolean := False; 163 Debug_Flag_Dot_SS : Boolean := False; 164 Debug_Flag_Dot_TT : Boolean := False; 165 Debug_Flag_Dot_UU : Boolean := False; 166 Debug_Flag_Dot_VV : Boolean := False; 167 Debug_Flag_Dot_WW : Boolean := False; 168 Debug_Flag_Dot_XX : Boolean := False; 169 Debug_Flag_Dot_YY : Boolean := False; 170 Debug_Flag_Dot_ZZ : Boolean := False; 171 172 Debug_Flag_Dot_1 : Boolean := False; 173 Debug_Flag_Dot_2 : Boolean := False; 174 Debug_Flag_Dot_3 : Boolean := False; 175 Debug_Flag_Dot_4 : Boolean := False; 176 Debug_Flag_Dot_5 : Boolean := False; 177 Debug_Flag_Dot_6 : Boolean := False; 178 Debug_Flag_Dot_7 : Boolean := False; 179 Debug_Flag_Dot_8 : Boolean := False; 180 Debug_Flag_Dot_9 : Boolean := False; 181 182 function Get_Debug_Flag_K return Boolean; 183 -- This function is called from C code to get the setting of the K flag 184 -- (it does not work to try to access a constant object directly). 185 186 procedure Set_Debug_Flag (C : Character; Val : Boolean := True); 187 -- Where C is 0-9, A-Z, or a-z, sets the corresponding debug flag to 188 -- the given value. In the checks off version of debug, the call to 189 -- Set_Debug_Flag is always a null operation. 190 191 procedure Set_Dotted_Debug_Flag (C : Character; Val : Boolean := True); 192 -- Where C is 0-9, A-Z, or a-z, sets the corresponding dotted debug 193 -- flag (e.g. call with C = 'a' for the .a flag). 194 195end Debug; 196