1 /* The common simulator framework for GDB, the GNU Debugger. 2 3 Copyright 2002-2017 Free Software Foundation, Inc. 4 5 Contributed by Andrew Cagney and Red Hat. 6 7 This file is part of GDB. 8 9 This program is free software; you can redistribute it and/or modify 10 it under the terms of the GNU General Public License as published by 11 the Free Software Foundation; either version 3 of the License, or 12 (at your option) any later version. 13 14 This program is distributed in the hope that it will be useful, 15 but WITHOUT ANY WARRANTY; without even the implied warranty of 16 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the 17 GNU General Public License for more details. 18 19 You should have received a copy of the GNU General Public License 20 along with this program. If not, see <http://www.gnu.org/licenses/>. */ 21 22 23 #ifndef SIM_CONFIG_H 24 #define SIM_CONFIG_H 25 26 27 /* Host dependant: 28 29 The CPP below defines information about the compilation host. In 30 particular it defines the macro's: 31 32 HOST_BYTE_ORDER The byte order of the host. Could be BFD_ENDIAN_LITTLE 33 or BFD_ENDIAN_BIG. 34 35 */ 36 37 #ifdef WORDS_BIGENDIAN 38 # define HOST_BYTE_ORDER BFD_ENDIAN_BIG 39 #else 40 # define HOST_BYTE_ORDER BFD_ENDIAN_LITTLE 41 #endif 42 43 44 /* Until devices and tree properties are sorted out, tell sim-config.c 45 not to call the tree_find_foo fns. */ 46 #define WITH_TREE_PROPERTIES 0 47 48 49 /* Endianness of the target. 50 51 Possible values are BFD_ENDIAN_UNKNOWN, BFD_ENDIAN_LITTLE, or BFD_ENDIAN_BIG. */ 52 53 #ifndef WITH_TARGET_BYTE_ORDER 54 #define WITH_TARGET_BYTE_ORDER BFD_ENDIAN_UNKNOWN 55 #endif 56 57 #ifndef WITH_DEFAULT_TARGET_BYTE_ORDER 58 #define WITH_DEFAULT_TARGET_BYTE_ORDER BFD_ENDIAN_UNKNOWN 59 #endif 60 61 extern enum bfd_endian current_target_byte_order; 62 #define CURRENT_TARGET_BYTE_ORDER \ 63 (WITH_TARGET_BYTE_ORDER != BFD_ENDIAN_UNKNOWN \ 64 ? WITH_TARGET_BYTE_ORDER : current_target_byte_order) 65 66 67 68 /* XOR endian. 69 70 In addition to the above, the simulator can support the horrible 71 XOR endian mode (as found in the PowerPC and MIPS ISA). See 72 sim-core for more information. 73 74 If WITH_XOR_ENDIAN is non-zero, it specifies the number of bytes 75 potentially involved in the XOR munge. A typical value is 8. */ 76 77 #ifndef WITH_XOR_ENDIAN 78 #define WITH_XOR_ENDIAN 0 79 #endif 80 81 82 83 /* SMP support: 84 85 Sets a limit on the number of processors that can be simulated. If 86 WITH_SMP is set to zero (0), the simulator is restricted to 87 suporting only one processor (and as a consequence leaves the SMP 88 code out of the build process). 89 90 The actual number of processors is taken from the device 91 /options/smp@<nr-cpu> */ 92 93 #if defined (WITH_SMP) && (WITH_SMP > 0) 94 #define MAX_NR_PROCESSORS WITH_SMP 95 #endif 96 97 #ifndef MAX_NR_PROCESSORS 98 #define MAX_NR_PROCESSORS 1 99 #endif 100 101 102 /* Size of target word, address and OpenFirmware Cell: 103 104 The target word size is determined by the natural size of its 105 reginsters. 106 107 On most hosts, the address and cell are the same size as a target 108 word. */ 109 110 #ifndef WITH_TARGET_WORD_BITSIZE 111 #define WITH_TARGET_WORD_BITSIZE 32 112 #endif 113 114 #ifndef WITH_TARGET_ADDRESS_BITSIZE 115 #define WITH_TARGET_ADDRESS_BITSIZE WITH_TARGET_WORD_BITSIZE 116 #endif 117 118 #ifndef WITH_TARGET_CELL_BITSIZE 119 #define WITH_TARGET_CELL_BITSIZE WITH_TARGET_WORD_BITSIZE 120 #endif 121 122 #ifndef WITH_TARGET_FLOATING_POINT_BITSIZE 123 #define WITH_TARGET_FLOATING_POINT_BITSIZE 64 124 #endif 125 126 127 128 /* Most significant bit of target: 129 130 Set this according to your target's bit numbering convention. For 131 the PowerPC it is zero, for many other targets it is 31 or 63. 132 133 For targets that can both have either 32 or 64 bit words and number 134 MSB as 31, 63. Define this to be (WITH_TARGET_WORD_BITSIZE - 1) */ 135 136 #ifndef WITH_TARGET_WORD_MSB 137 #define WITH_TARGET_WORD_MSB 0 138 #endif 139 140 141 142 /* Program environment: 143 144 Three environments are available - UEA (user), VEA (virtual) and 145 OEA (perating). The former two are environment that users would 146 expect to see (VEA includes things like coherency and the time 147 base) while OEA is what an operating system expects to see. By 148 setting these to specific values, the build process is able to 149 eliminate non relevent environment code. 150 151 STATE_ENVIRONMENT(sd) specifies which of vea or oea is required for 152 the current runtime. 153 154 ALL_ENVIRONMENT is used during configuration as a value for 155 WITH_ENVIRONMENT to indicate the choice is runtime selectable. 156 The default is then USER_ENVIRONMENT [since allowing the user to choose 157 the default at configure time seems like featuritis and since people using 158 OPERATING_ENVIRONMENT have more to worry about than selecting the 159 default]. 160 ALL_ENVIRONMENT is also used to set STATE_ENVIRONMENT to the 161 "uninitialized" state. */ 162 163 enum sim_environment { 164 ALL_ENVIRONMENT, 165 USER_ENVIRONMENT, 166 VIRTUAL_ENVIRONMENT, 167 OPERATING_ENVIRONMENT 168 }; 169 170 /* To be prepended to simulator calls with absolute file paths and 171 chdir:ed at startup. */ 172 extern char *simulator_sysroot; 173 174 /* Callback & Modulo Memory. 175 176 Core includes a builtin memory type (raw_memory) that is 177 implemented using an array. raw_memory does not require any 178 additional functions etc. 179 180 Callback memory is where the core calls a core device for the data 181 it requires. Callback memory can be layered using priorities. 182 183 Modulo memory is a variation on raw_memory where ADDRESS & (MODULO 184 - 1) is used as the index into the memory array. 185 186 The OEA model uses callback memory for devices. 187 188 The VEA model uses callback memory to capture `page faults'. 189 190 BTW, while raw_memory could have been implemented as a callback, 191 profiling has shown that there is a biger win (at least for the 192 x86) in eliminating a function call for the most common 193 (raw_memory) case. */ 194 195 196 /* Alignment: 197 198 A processor architecture may or may not handle miss aligned 199 transfers. 200 201 As alternatives: both little and big endian modes take an exception 202 (STRICT_ALIGNMENT); big and little endian models handle mis aligned 203 transfers (NONSTRICT_ALIGNMENT); or the address is forced into 204 alignment using a mask (FORCED_ALIGNMENT). 205 206 Mixed alignment should be specified when the simulator needs to be 207 able to change the alignment requirements on the fly (eg for 208 bi-endian support). */ 209 210 enum sim_alignments { 211 MIXED_ALIGNMENT, 212 NONSTRICT_ALIGNMENT, 213 STRICT_ALIGNMENT, 214 FORCED_ALIGNMENT, 215 }; 216 217 extern enum sim_alignments current_alignment; 218 219 #if !defined (WITH_ALIGNMENT) 220 #define WITH_ALIGNMENT 0 221 #endif 222 223 #if !defined (WITH_DEFAULT_ALIGNMENT) 224 #define WITH_DEFAULT_ALIGNMENT 0 /* fatal */ 225 #endif 226 227 228 229 230 #define CURRENT_ALIGNMENT (WITH_ALIGNMENT \ 231 ? WITH_ALIGNMENT \ 232 : current_alignment) 233 234 235 236 /* Floating point suport: 237 238 Should the processor trap for all floating point instructions (as 239 if the hardware wasn't implemented) or implement the floating point 240 instructions directly. */ 241 242 #if defined (WITH_FLOATING_POINT) 243 244 #define SOFT_FLOATING_POINT 1 245 #define HARD_FLOATING_POINT 2 246 247 extern int current_floating_point; 248 #define CURRENT_FLOATING_POINT (WITH_FLOATING_POINT \ 249 ? WITH_FLOATING_POINT \ 250 : current_floating_point) 251 252 #endif 253 254 255 /* Whether to check instructions for reserved bits being set */ 256 257 /* #define WITH_RESERVED_BITS 1 */ 258 259 260 261 /* include monitoring code */ 262 263 #define MONITOR_INSTRUCTION_ISSUE 1 264 #define MONITOR_LOAD_STORE_UNIT 2 265 /* do not define WITH_MON by default */ 266 #define DEFAULT_WITH_MON (MONITOR_LOAD_STORE_UNIT \ 267 | MONITOR_INSTRUCTION_ISSUE) 268 269 270 /* Current CPU model (models are in the generated models.h include file) */ 271 #ifndef WITH_MODEL 272 #define WITH_MODEL 0 273 #endif 274 275 #define CURRENT_MODEL (WITH_MODEL \ 276 ? WITH_MODEL \ 277 : current_model) 278 279 #define MODEL_ISSUE_IGNORE (-1) 280 #define MODEL_ISSUE_PROCESS 1 281 282 #ifndef WITH_MODEL_ISSUE 283 #define WITH_MODEL_ISSUE 0 284 #endif 285 286 extern int current_model_issue; 287 #define CURRENT_MODEL_ISSUE (WITH_MODEL_ISSUE \ 288 ? WITH_MODEL_ISSUE \ 289 : current_model_issue) 290 291 292 293 /* Whether or not input/output just uses stdio, or uses printf_filtered for 294 output, and polling input for input. */ 295 296 #define DONT_USE_STDIO 2 297 #define DO_USE_STDIO 1 298 299 extern int current_stdio; 300 #define CURRENT_STDIO (WITH_STDIO \ 301 ? WITH_STDIO \ 302 : current_stdio) 303 304 305 306 /* Set the default state configuration, before parsing argv. */ 307 308 extern void sim_config_default (SIM_DESC sd); 309 310 /* Complete and verify the simulator configuration. */ 311 312 extern SIM_RC sim_config (SIM_DESC sd); 313 314 /* Print the simulator configuration. */ 315 316 extern void print_sim_config (SIM_DESC sd); 317 318 319 #endif 320