* valops.c (PUSH_ARGUMENTS): Delete definition.
[deliverable/binutils-gdb.git] / gdb / gdbarch.sh
1 #!/bin/sh -u
2
3 # Architecture commands for GDB, the GNU debugger.
4 # Copyright 1998, 1999, 2000, 2001, 2002 Free Software Foundation, Inc.
5 #
6 # This file is part of GDB.
7 #
8 # This program is free software; you can redistribute it and/or modify
9 # it under the terms of the GNU General Public License as published by
10 # the Free Software Foundation; either version 2 of the License, or
11 # (at your option) any later version.
12 #
13 # This program is distributed in the hope that it will be useful,
14 # but WITHOUT ANY WARRANTY; without even the implied warranty of
15 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
16 # GNU General Public License for more details.
17 #
18 # You should have received a copy of the GNU General Public License
19 # along with this program; if not, write to the Free Software
20 # Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
21
22 compare_new ()
23 {
24 file=$1
25 if test ! -r ${file}
26 then
27 echo "${file} missing? cp new-${file} ${file}" 1>&2
28 elif diff -c ${file} new-${file}
29 then
30 echo "${file} unchanged" 1>&2
31 else
32 echo "${file} has changed? cp new-${file} ${file}" 1>&2
33 fi
34 }
35
36
37 # Format of the input table
38 read="class level macro returntype function formal actual attrib staticdefault predefault postdefault invalid_p fmt print print_p description"
39
40 do_read ()
41 {
42 comment=""
43 class=""
44 while read line
45 do
46 if test "${line}" = ""
47 then
48 continue
49 elif test "${line}" = "#" -a "${comment}" = ""
50 then
51 continue
52 elif expr "${line}" : "#" > /dev/null
53 then
54 comment="${comment}
55 ${line}"
56 else
57
58 # The semantics of IFS varies between different SH's. Some
59 # treat ``::' as three fields while some treat it as just too.
60 # Work around this by eliminating ``::'' ....
61 line="`echo "${line}" | sed -e 's/::/: :/g' -e 's/::/: :/g'`"
62
63 OFS="${IFS}" ; IFS="[:]"
64 eval read ${read} <<EOF
65 ${line}
66 EOF
67 IFS="${OFS}"
68
69 # .... and then going back through each field and strip out those
70 # that ended up with just that space character.
71 for r in ${read}
72 do
73 if eval test \"\${${r}}\" = \"\ \"
74 then
75 eval ${r}=""
76 fi
77 done
78
79 case "${class}" in
80 m ) staticdefault="${predefault}" ;;
81 M ) staticdefault="0" ;;
82 * ) test "${staticdefault}" || staticdefault=0 ;;
83 esac
84 # NOT YET: Breaks BELIEVE_PCC_PROMOTION and confuses non-
85 # multi-arch defaults.
86 # test "${predefault}" || predefault=0
87
88 # come up with a format, use a few guesses for variables
89 case ":${class}:${fmt}:${print}:" in
90 :[vV]::: )
91 if [ "${returntype}" = int ]
92 then
93 fmt="%d"
94 print="${macro}"
95 elif [ "${returntype}" = long ]
96 then
97 fmt="%ld"
98 print="${macro}"
99 fi
100 ;;
101 esac
102 test "${fmt}" || fmt="%ld"
103 test "${print}" || print="(long) ${macro}"
104
105 case "${invalid_p}" in
106 0 ) valid_p=1 ;;
107 "" )
108 if [ -n "${predefault}" ]
109 then
110 #invalid_p="gdbarch->${function} == ${predefault}"
111 valid_p="gdbarch->${function} != ${predefault}"
112 else
113 #invalid_p="gdbarch->${function} == 0"
114 valid_p="gdbarch->${function} != 0"
115 fi
116 ;;
117 * ) valid_p="!(${invalid_p})"
118 esac
119
120 # PREDEFAULT is a valid fallback definition of MEMBER when
121 # multi-arch is not enabled. This ensures that the
122 # default value, when multi-arch is the same as the
123 # default value when not multi-arch. POSTDEFAULT is
124 # always a valid definition of MEMBER as this again
125 # ensures consistency.
126
127 if [ -n "${postdefault}" ]
128 then
129 fallbackdefault="${postdefault}"
130 elif [ -n "${predefault}" ]
131 then
132 fallbackdefault="${predefault}"
133 else
134 fallbackdefault="0"
135 fi
136
137 #NOT YET: See gdbarch.log for basic verification of
138 # database
139
140 break
141 fi
142 done
143 if [ -n "${class}" ]
144 then
145 true
146 else
147 false
148 fi
149 }
150
151
152 fallback_default_p ()
153 {
154 [ -n "${postdefault}" -a "x${invalid_p}" != "x0" ] \
155 || [ -n "${predefault}" -a "x${invalid_p}" = "x0" ]
156 }
157
158 class_is_variable_p ()
159 {
160 case "${class}" in
161 *v* | *V* ) true ;;
162 * ) false ;;
163 esac
164 }
165
166 class_is_function_p ()
167 {
168 case "${class}" in
169 *f* | *F* | *m* | *M* ) true ;;
170 * ) false ;;
171 esac
172 }
173
174 class_is_multiarch_p ()
175 {
176 case "${class}" in
177 *m* | *M* ) true ;;
178 * ) false ;;
179 esac
180 }
181
182 class_is_predicate_p ()
183 {
184 case "${class}" in
185 *F* | *V* | *M* ) true ;;
186 * ) false ;;
187 esac
188 }
189
190 class_is_info_p ()
191 {
192 case "${class}" in
193 *i* ) true ;;
194 * ) false ;;
195 esac
196 }
197
198
199 # dump out/verify the doco
200 for field in ${read}
201 do
202 case ${field} in
203
204 class ) : ;;
205
206 # # -> line disable
207 # f -> function
208 # hiding a function
209 # F -> function + predicate
210 # hiding a function + predicate to test function validity
211 # v -> variable
212 # hiding a variable
213 # V -> variable + predicate
214 # hiding a variable + predicate to test variables validity
215 # i -> set from info
216 # hiding something from the ``struct info'' object
217 # m -> multi-arch function
218 # hiding a multi-arch function (parameterised with the architecture)
219 # M -> multi-arch function + predicate
220 # hiding a multi-arch function + predicate to test function validity
221
222 level ) : ;;
223
224 # See GDB_MULTI_ARCH description. Having GDB_MULTI_ARCH >=
225 # LEVEL is a predicate on checking that a given method is
226 # initialized (using INVALID_P).
227
228 macro ) : ;;
229
230 # The name of the MACRO that this method is to be accessed by.
231
232 returntype ) : ;;
233
234 # For functions, the return type; for variables, the data type
235
236 function ) : ;;
237
238 # For functions, the member function name; for variables, the
239 # variable name. Member function names are always prefixed with
240 # ``gdbarch_'' for name-space purity.
241
242 formal ) : ;;
243
244 # The formal argument list. It is assumed that the formal
245 # argument list includes the actual name of each list element.
246 # A function with no arguments shall have ``void'' as the
247 # formal argument list.
248
249 actual ) : ;;
250
251 # The list of actual arguments. The arguments specified shall
252 # match the FORMAL list given above. Functions with out
253 # arguments leave this blank.
254
255 attrib ) : ;;
256
257 # Any GCC attributes that should be attached to the function
258 # declaration. At present this field is unused.
259
260 staticdefault ) : ;;
261
262 # To help with the GDB startup a static gdbarch object is
263 # created. STATICDEFAULT is the value to insert into that
264 # static gdbarch object. Since this a static object only
265 # simple expressions can be used.
266
267 # If STATICDEFAULT is empty, zero is used.
268
269 predefault ) : ;;
270
271 # An initial value to assign to MEMBER of the freshly
272 # malloc()ed gdbarch object. After initialization, the
273 # freshly malloc()ed object is passed to the target
274 # architecture code for further updates.
275
276 # If PREDEFAULT is empty, zero is used.
277
278 # A non-empty PREDEFAULT, an empty POSTDEFAULT and a zero
279 # INVALID_P are specified, PREDEFAULT will be used as the
280 # default for the non- multi-arch target.
281
282 # A zero PREDEFAULT function will force the fallback to call
283 # internal_error().
284
285 # Variable declarations can refer to ``gdbarch'' which will
286 # contain the current architecture. Care should be taken.
287
288 postdefault ) : ;;
289
290 # A value to assign to MEMBER of the new gdbarch object should
291 # the target architecture code fail to change the PREDEFAULT
292 # value.
293
294 # If POSTDEFAULT is empty, no post update is performed.
295
296 # If both INVALID_P and POSTDEFAULT are non-empty then
297 # INVALID_P will be used to determine if MEMBER should be
298 # changed to POSTDEFAULT.
299
300 # If a non-empty POSTDEFAULT and a zero INVALID_P are
301 # specified, POSTDEFAULT will be used as the default for the
302 # non- multi-arch target (regardless of the value of
303 # PREDEFAULT).
304
305 # You cannot specify both a zero INVALID_P and a POSTDEFAULT.
306
307 # Variable declarations can refer to ``gdbarch'' which will
308 # contain the current architecture. Care should be taken.
309
310 invalid_p ) : ;;
311
312 # A predicate equation that validates MEMBER. Non-zero is
313 # returned if the code creating the new architecture failed to
314 # initialize MEMBER or the initialized the member is invalid.
315 # If POSTDEFAULT is non-empty then MEMBER will be updated to
316 # that value. If POSTDEFAULT is empty then internal_error()
317 # is called.
318
319 # If INVALID_P is empty, a check that MEMBER is no longer
320 # equal to PREDEFAULT is used.
321
322 # The expression ``0'' disables the INVALID_P check making
323 # PREDEFAULT a legitimate value.
324
325 # See also PREDEFAULT and POSTDEFAULT.
326
327 fmt ) : ;;
328
329 # printf style format string that can be used to print out the
330 # MEMBER. Sometimes "%s" is useful. For functions, this is
331 # ignored and the function address is printed.
332
333 # If FMT is empty, ``%ld'' is used.
334
335 print ) : ;;
336
337 # An optional equation that casts MEMBER to a value suitable
338 # for formatting by FMT.
339
340 # If PRINT is empty, ``(long)'' is used.
341
342 print_p ) : ;;
343
344 # An optional indicator for any predicte to wrap around the
345 # print member code.
346
347 # () -> Call a custom function to do the dump.
348 # exp -> Wrap print up in ``if (${print_p}) ...
349 # ``'' -> No predicate
350
351 # If PRINT_P is empty, ``1'' is always used.
352
353 description ) : ;;
354
355 # Currently unused.
356
357 *) exit 1;;
358 esac
359 done
360
361
362 function_list ()
363 {
364 # See below (DOCO) for description of each field
365 cat <<EOF
366 i:2:TARGET_ARCHITECTURE:const struct bfd_arch_info *:bfd_arch_info::::&bfd_default_arch_struct::::%s:TARGET_ARCHITECTURE->printable_name:TARGET_ARCHITECTURE != NULL
367 #
368 i:2:TARGET_BYTE_ORDER:int:byte_order::::BFD_ENDIAN_BIG
369 # Number of bits in a char or unsigned char for the target machine.
370 # Just like CHAR_BIT in <limits.h> but describes the target machine.
371 # v::TARGET_CHAR_BIT:int:char_bit::::8 * sizeof (char):8::0:
372 #
373 # Number of bits in a short or unsigned short for the target machine.
374 v::TARGET_SHORT_BIT:int:short_bit::::8 * sizeof (short):2*TARGET_CHAR_BIT::0
375 # Number of bits in an int or unsigned int for the target machine.
376 v::TARGET_INT_BIT:int:int_bit::::8 * sizeof (int):4*TARGET_CHAR_BIT::0
377 # Number of bits in a long or unsigned long for the target machine.
378 v::TARGET_LONG_BIT:int:long_bit::::8 * sizeof (long):4*TARGET_CHAR_BIT::0
379 # Number of bits in a long long or unsigned long long for the target
380 # machine.
381 v::TARGET_LONG_LONG_BIT:int:long_long_bit::::8 * sizeof (LONGEST):2*TARGET_LONG_BIT::0
382 # Number of bits in a float for the target machine.
383 v::TARGET_FLOAT_BIT:int:float_bit::::8 * sizeof (float):4*TARGET_CHAR_BIT::0
384 # Number of bits in a double for the target machine.
385 v::TARGET_DOUBLE_BIT:int:double_bit::::8 * sizeof (double):8*TARGET_CHAR_BIT::0
386 # Number of bits in a long double for the target machine.
387 v::TARGET_LONG_DOUBLE_BIT:int:long_double_bit::::8 * sizeof (long double):2*TARGET_DOUBLE_BIT::0
388 # For most targets, a pointer on the target and its representation as an
389 # address in GDB have the same size and "look the same". For such a
390 # target, you need only set TARGET_PTR_BIT / ptr_bit and TARGET_ADDR_BIT
391 # / addr_bit will be set from it.
392 #
393 # If TARGET_PTR_BIT and TARGET_ADDR_BIT are different, you'll probably
394 # also need to set POINTER_TO_ADDRESS and ADDRESS_TO_POINTER as well.
395 #
396 # ptr_bit is the size of a pointer on the target
397 v::TARGET_PTR_BIT:int:ptr_bit::::8 * sizeof (void*):TARGET_INT_BIT::0
398 # addr_bit is the size of a target address as represented in gdb
399 v::TARGET_ADDR_BIT:int:addr_bit::::8 * sizeof (void*):0:TARGET_PTR_BIT:
400 # Number of bits in a BFD_VMA for the target object file format.
401 v::TARGET_BFD_VMA_BIT:int:bfd_vma_bit::::8 * sizeof (void*):TARGET_ARCHITECTURE->bits_per_address::0
402 #
403 # One if \`char' acts like \`signed char', zero if \`unsigned char'.
404 v::TARGET_CHAR_SIGNED:int:char_signed::::1:-1:1::::
405 #
406 f::TARGET_READ_PC:CORE_ADDR:read_pc:ptid_t ptid:ptid::0:generic_target_read_pc::0
407 f::TARGET_WRITE_PC:void:write_pc:CORE_ADDR val, ptid_t ptid:val, ptid::0:generic_target_write_pc::0
408 f::TARGET_READ_FP:CORE_ADDR:read_fp:void:::0:generic_target_read_fp::0
409 f::TARGET_WRITE_FP:void:write_fp:CORE_ADDR val:val::0:generic_target_write_fp::0
410 f::TARGET_READ_SP:CORE_ADDR:read_sp:void:::0:generic_target_read_sp::0
411 f::TARGET_WRITE_SP:void:write_sp:CORE_ADDR val:val::0:generic_target_write_sp::0
412 # Function for getting target's idea of a frame pointer. FIXME: GDB's
413 # whole scheme for dealing with "frames" and "frame pointers" needs a
414 # serious shakedown.
415 f::TARGET_VIRTUAL_FRAME_POINTER:void:virtual_frame_pointer:CORE_ADDR pc, int *frame_regnum, LONGEST *frame_offset:pc, frame_regnum, frame_offset::0:legacy_virtual_frame_pointer::0
416 #
417 M:::void:register_read:int regnum, char *buf:regnum, buf:
418 M:::void:register_write:int regnum, char *buf:regnum, buf:
419 #
420 v:2:NUM_REGS:int:num_regs::::0:-1
421 # This macro gives the number of pseudo-registers that live in the
422 # register namespace but do not get fetched or stored on the target.
423 # These pseudo-registers may be aliases for other registers,
424 # combinations of other registers, or they may be computed by GDB.
425 v:2:NUM_PSEUDO_REGS:int:num_pseudo_regs::::0:0::0:::
426 v:2:SP_REGNUM:int:sp_regnum::::0:-1
427 v:2:FP_REGNUM:int:fp_regnum::::0:-1
428 v:2:PC_REGNUM:int:pc_regnum::::0:-1
429 v:2:FP0_REGNUM:int:fp0_regnum::::0:-1::0
430 v:2:NPC_REGNUM:int:npc_regnum::::0:-1::0
431 v:2:NNPC_REGNUM:int:nnpc_regnum::::0:-1::0
432 # Convert stab register number (from \`r\' declaration) to a gdb REGNUM.
433 f:2:STAB_REG_TO_REGNUM:int:stab_reg_to_regnum:int stab_regnr:stab_regnr:::no_op_reg_to_regnum::0
434 # Provide a default mapping from a ecoff register number to a gdb REGNUM.
435 f:2:ECOFF_REG_TO_REGNUM:int:ecoff_reg_to_regnum:int ecoff_regnr:ecoff_regnr:::no_op_reg_to_regnum::0
436 # Provide a default mapping from a DWARF register number to a gdb REGNUM.
437 f:2:DWARF_REG_TO_REGNUM:int:dwarf_reg_to_regnum:int dwarf_regnr:dwarf_regnr:::no_op_reg_to_regnum::0
438 # Convert from an sdb register number to an internal gdb register number.
439 # This should be defined in tm.h, if REGISTER_NAMES is not set up
440 # to map one to one onto the sdb register numbers.
441 f:2:SDB_REG_TO_REGNUM:int:sdb_reg_to_regnum:int sdb_regnr:sdb_regnr:::no_op_reg_to_regnum::0
442 f:2:DWARF2_REG_TO_REGNUM:int:dwarf2_reg_to_regnum:int dwarf2_regnr:dwarf2_regnr:::no_op_reg_to_regnum::0
443 f:2:REGISTER_NAME:char *:register_name:int regnr:regnr:::legacy_register_name::0
444 v:2:REGISTER_SIZE:int:register_size::::0:-1
445 v:2:REGISTER_BYTES:int:register_bytes::::0:-1
446 f:2:REGISTER_BYTE:int:register_byte:int reg_nr:reg_nr::0:0
447 f:2:REGISTER_RAW_SIZE:int:register_raw_size:int reg_nr:reg_nr::generic_register_raw_size:0
448 v:2:MAX_REGISTER_RAW_SIZE:int:max_register_raw_size::::0:-1
449 f:2:REGISTER_VIRTUAL_SIZE:int:register_virtual_size:int reg_nr:reg_nr::generic_register_virtual_size:0
450 v:2:MAX_REGISTER_VIRTUAL_SIZE:int:max_register_virtual_size::::0:-1
451 f:2:REGISTER_VIRTUAL_TYPE:struct type *:register_virtual_type:int reg_nr:reg_nr::0:0
452 f:2:DO_REGISTERS_INFO:void:do_registers_info:int reg_nr, int fpregs:reg_nr, fpregs:::do_registers_info::0
453 f:2:PRINT_FLOAT_INFO:void:print_float_info:void::::default_print_float_info::0
454 # MAP a GDB RAW register number onto a simulator register number. See
455 # also include/...-sim.h.
456 f:2:REGISTER_SIM_REGNO:int:register_sim_regno:int reg_nr:reg_nr:::default_register_sim_regno::0
457 F:2:REGISTER_BYTES_OK:int:register_bytes_ok:long nr_bytes:nr_bytes::0:0
458 f:2:CANNOT_FETCH_REGISTER:int:cannot_fetch_register:int regnum:regnum:::cannot_register_not::0
459 f:2:CANNOT_STORE_REGISTER:int:cannot_store_register:int regnum:regnum:::cannot_register_not::0
460 #
461 v:1:USE_GENERIC_DUMMY_FRAMES:int:use_generic_dummy_frames::::0:-1
462 v:1:CALL_DUMMY_LOCATION:int:call_dummy_location::::0:0
463 f:2:CALL_DUMMY_ADDRESS:CORE_ADDR:call_dummy_address:void:::0:0::gdbarch->call_dummy_location == AT_ENTRY_POINT && gdbarch->call_dummy_address == 0
464 v:2:CALL_DUMMY_START_OFFSET:CORE_ADDR:call_dummy_start_offset::::0:-1:::0x%08lx
465 v:2:CALL_DUMMY_BREAKPOINT_OFFSET:CORE_ADDR:call_dummy_breakpoint_offset::::0:-1::gdbarch->call_dummy_breakpoint_offset_p && gdbarch->call_dummy_breakpoint_offset == -1:0x%08lx::CALL_DUMMY_BREAKPOINT_OFFSET_P
466 v:1:CALL_DUMMY_BREAKPOINT_OFFSET_P:int:call_dummy_breakpoint_offset_p::::0:-1
467 v:2:CALL_DUMMY_LENGTH:int:call_dummy_length::::0:-1:::::CALL_DUMMY_LOCATION == BEFORE_TEXT_END || CALL_DUMMY_LOCATION == AFTER_TEXT_END
468 f:1:PC_IN_CALL_DUMMY:int:pc_in_call_dummy:CORE_ADDR pc, CORE_ADDR sp, CORE_ADDR frame_address:pc, sp, frame_address::0:0
469 v:1:CALL_DUMMY_P:int:call_dummy_p::::0:-1
470 v:2:CALL_DUMMY_WORDS:LONGEST *:call_dummy_words::::0:legacy_call_dummy_words::0:0x%08lx
471 v:2:SIZEOF_CALL_DUMMY_WORDS:int:sizeof_call_dummy_words::::0:legacy_sizeof_call_dummy_words::0:0x%08lx
472 v:1:CALL_DUMMY_STACK_ADJUST_P:int:call_dummy_stack_adjust_p::::0:-1:::0x%08lx
473 v:2:CALL_DUMMY_STACK_ADJUST:int:call_dummy_stack_adjust::::0:::gdbarch->call_dummy_stack_adjust_p && gdbarch->call_dummy_stack_adjust == 0:0x%08lx::CALL_DUMMY_STACK_ADJUST_P
474 f:2:FIX_CALL_DUMMY:void:fix_call_dummy:char *dummy, CORE_ADDR pc, CORE_ADDR fun, int nargs, struct value **args, struct type *type, int gcc_p:dummy, pc, fun, nargs, args, type, gcc_p:::0
475 f:2:INIT_FRAME_PC_FIRST:void:init_frame_pc_first:int fromleaf, struct frame_info *prev:fromleaf, prev:::init_frame_pc_noop::0
476 f:2:INIT_FRAME_PC:void:init_frame_pc:int fromleaf, struct frame_info *prev:fromleaf, prev:::init_frame_pc_default::0
477 #
478 v:2:BELIEVE_PCC_PROMOTION:int:believe_pcc_promotion:::::::
479 v:2:BELIEVE_PCC_PROMOTION_TYPE:int:believe_pcc_promotion_type:::::::
480 f:2:COERCE_FLOAT_TO_DOUBLE:int:coerce_float_to_double:struct type *formal, struct type *actual:formal, actual:::default_coerce_float_to_double::0
481 f:1:GET_SAVED_REGISTER:void:get_saved_register:char *raw_buffer, int *optimized, CORE_ADDR *addrp, struct frame_info *frame, int regnum, enum lval_type *lval:raw_buffer, optimized, addrp, frame, regnum, lval::generic_get_saved_register:0
482 #
483 f:1:REGISTER_CONVERTIBLE:int:register_convertible:int nr:nr:::generic_register_convertible_not::0
484 f:2:REGISTER_CONVERT_TO_VIRTUAL:void:register_convert_to_virtual:int regnum, struct type *type, char *from, char *to:regnum, type, from, to:::0::0
485 f:2:REGISTER_CONVERT_TO_RAW:void:register_convert_to_raw:struct type *type, int regnum, char *from, char *to:type, regnum, from, to:::0::0
486 # This function is called when the value of a pseudo-register needs to
487 # be updated. Typically it will be defined on a per-architecture
488 # basis.
489 F:2:FETCH_PSEUDO_REGISTER:void:fetch_pseudo_register:int regnum:regnum:
490 # This function is called when the value of a pseudo-register needs to
491 # be set or stored. Typically it will be defined on a
492 # per-architecture basis.
493 F:2:STORE_PSEUDO_REGISTER:void:store_pseudo_register:int regnum:regnum:
494 #
495 f:2:POINTER_TO_ADDRESS:CORE_ADDR:pointer_to_address:struct type *type, void *buf:type, buf:::unsigned_pointer_to_address::0
496 f:2:ADDRESS_TO_POINTER:void:address_to_pointer:struct type *type, void *buf, CORE_ADDR addr:type, buf, addr:::unsigned_address_to_pointer::0
497 F:2:INTEGER_TO_ADDRESS:CORE_ADDR:integer_to_address:struct type *type, void *buf:type, buf
498 #
499 f:2:RETURN_VALUE_ON_STACK:int:return_value_on_stack:struct type *type:type:::generic_return_value_on_stack_not::0
500 f:2:EXTRACT_RETURN_VALUE:void:extract_return_value:struct type *type, char *regbuf, char *valbuf:type, regbuf, valbuf::0:0
501 f:2:PUSH_ARGUMENTS:CORE_ADDR:push_arguments:int nargs, struct value **args, CORE_ADDR sp, int struct_return, CORE_ADDR struct_addr:nargs, args, sp, struct_return, struct_addr::::default_push_arguments
502 f:2:PUSH_DUMMY_FRAME:void:push_dummy_frame:void:-:::0
503 F:1:PUSH_RETURN_ADDRESS:CORE_ADDR:push_return_address:CORE_ADDR pc, CORE_ADDR sp:pc, sp:::0
504 f:2:POP_FRAME:void:pop_frame:void:-:::0
505 #
506 f:2:STORE_STRUCT_RETURN:void:store_struct_return:CORE_ADDR addr, CORE_ADDR sp:addr, sp:::0
507 f:2:STORE_RETURN_VALUE:void:store_return_value:struct type *type, char *valbuf:type, valbuf:::0
508 F:2:EXTRACT_STRUCT_VALUE_ADDRESS:CORE_ADDR:extract_struct_value_address:char *regbuf:regbuf:::0
509 f:2:USE_STRUCT_CONVENTION:int:use_struct_convention:int gcc_p, struct type *value_type:gcc_p, value_type:::generic_use_struct_convention::0
510 #
511 f:2:FRAME_INIT_SAVED_REGS:void:frame_init_saved_regs:struct frame_info *frame:frame::0:0
512 F:2:INIT_EXTRA_FRAME_INFO:void:init_extra_frame_info:int fromleaf, struct frame_info *frame:fromleaf, frame:::0
513 #
514 f:2:SKIP_PROLOGUE:CORE_ADDR:skip_prologue:CORE_ADDR ip:ip::0:0
515 f:2:PROLOGUE_FRAMELESS_P:int:prologue_frameless_p:CORE_ADDR ip:ip::0:generic_prologue_frameless_p::0
516 f:2:INNER_THAN:int:inner_than:CORE_ADDR lhs, CORE_ADDR rhs:lhs, rhs::0:0
517 f:2:BREAKPOINT_FROM_PC:unsigned char *:breakpoint_from_pc:CORE_ADDR *pcptr, int *lenptr:pcptr, lenptr:::legacy_breakpoint_from_pc::0
518 f:2:MEMORY_INSERT_BREAKPOINT:int:memory_insert_breakpoint:CORE_ADDR addr, char *contents_cache:addr, contents_cache::0:default_memory_insert_breakpoint::0
519 f:2:MEMORY_REMOVE_BREAKPOINT:int:memory_remove_breakpoint:CORE_ADDR addr, char *contents_cache:addr, contents_cache::0:default_memory_remove_breakpoint::0
520 v:2:DECR_PC_AFTER_BREAK:CORE_ADDR:decr_pc_after_break::::0:-1
521 f::PREPARE_TO_PROCEED:int:prepare_to_proceed:int select_it:select_it::0:default_prepare_to_proceed::0
522 v:2:FUNCTION_START_OFFSET:CORE_ADDR:function_start_offset::::0:-1
523 #
524 f:2:REMOTE_TRANSLATE_XFER_ADDRESS:void:remote_translate_xfer_address:CORE_ADDR gdb_addr, int gdb_len, CORE_ADDR *rem_addr, int *rem_len:gdb_addr, gdb_len, rem_addr, rem_len:::generic_remote_translate_xfer_address::0
525 #
526 v:2:FRAME_ARGS_SKIP:CORE_ADDR:frame_args_skip::::0:-1
527 f:2:FRAMELESS_FUNCTION_INVOCATION:int:frameless_function_invocation:struct frame_info *fi:fi:::generic_frameless_function_invocation_not::0
528 f:2:FRAME_CHAIN:CORE_ADDR:frame_chain:struct frame_info *frame:frame::0:0
529 f:1:FRAME_CHAIN_VALID:int:frame_chain_valid:CORE_ADDR chain, struct frame_info *thisframe:chain, thisframe::0:0
530 f:2:FRAME_SAVED_PC:CORE_ADDR:frame_saved_pc:struct frame_info *fi:fi::0:0
531 f:2:FRAME_ARGS_ADDRESS:CORE_ADDR:frame_args_address:struct frame_info *fi:fi::0:0
532 f:2:FRAME_LOCALS_ADDRESS:CORE_ADDR:frame_locals_address:struct frame_info *fi:fi::0:0
533 f:2:SAVED_PC_AFTER_CALL:CORE_ADDR:saved_pc_after_call:struct frame_info *frame:frame::0:0
534 f:2:FRAME_NUM_ARGS:int:frame_num_args:struct frame_info *frame:frame::0:0
535 #
536 F:2:STACK_ALIGN:CORE_ADDR:stack_align:CORE_ADDR sp:sp::0:0
537 v:1:EXTRA_STACK_ALIGNMENT_NEEDED:int:extra_stack_alignment_needed::::0:1::0:::
538 F:2:REG_STRUCT_HAS_ADDR:int:reg_struct_has_addr:int gcc_p, struct type *type:gcc_p, type::0:0
539 F:2:SAVE_DUMMY_FRAME_TOS:void:save_dummy_frame_tos:CORE_ADDR sp:sp::0:0
540 v:2:PARM_BOUNDARY:int:parm_boundary
541 #
542 v:2:TARGET_FLOAT_FORMAT:const struct floatformat *:float_format::::::default_float_format (gdbarch)
543 v:2:TARGET_DOUBLE_FORMAT:const struct floatformat *:double_format::::::default_double_format (gdbarch)
544 v:2:TARGET_LONG_DOUBLE_FORMAT:const struct floatformat *:long_double_format::::::default_double_format (gdbarch)
545 f:2:CONVERT_FROM_FUNC_PTR_ADDR:CORE_ADDR:convert_from_func_ptr_addr:CORE_ADDR addr:addr:::core_addr_identity::0
546 # On some machines there are bits in addresses which are not really
547 # part of the address, but are used by the kernel, the hardware, etc.
548 # for special purposes. ADDR_BITS_REMOVE takes out any such bits so
549 # we get a "real" address such as one would find in a symbol table.
550 # This is used only for addresses of instructions, and even then I'm
551 # not sure it's used in all contexts. It exists to deal with there
552 # being a few stray bits in the PC which would mislead us, not as some
553 # sort of generic thing to handle alignment or segmentation (it's
554 # possible it should be in TARGET_READ_PC instead).
555 f:2:ADDR_BITS_REMOVE:CORE_ADDR:addr_bits_remove:CORE_ADDR addr:addr:::core_addr_identity::0
556 # It is not at all clear why SMASH_TEXT_ADDRESS is not folded into
557 # ADDR_BITS_REMOVE.
558 f:2:SMASH_TEXT_ADDRESS:CORE_ADDR:smash_text_address:CORE_ADDR addr:addr:::core_addr_identity::0
559 # FIXME/cagney/2001-01-18: This should be split in two. A target method that indicates if
560 # the target needs software single step. An ISA method to implement it.
561 #
562 # FIXME/cagney/2001-01-18: This should be replaced with something that inserts breakpoints
563 # using the breakpoint system instead of blatting memory directly (as with rs6000).
564 #
565 # FIXME/cagney/2001-01-18: The logic is backwards. It should be asking if the target can
566 # single step. If not, then implement single step using breakpoints.
567 F:2:SOFTWARE_SINGLE_STEP:void:software_single_step:enum target_signal sig, int insert_breakpoints_p:sig, insert_breakpoints_p::0:0
568 f:2:TARGET_PRINT_INSN:int:print_insn:bfd_vma vma, disassemble_info *info:vma, info:::legacy_print_insn::0
569 f:2:SKIP_TRAMPOLINE_CODE:CORE_ADDR:skip_trampoline_code:CORE_ADDR pc:pc:::generic_skip_trampoline_code::0
570 # For SVR4 shared libraries, each call goes through a small piece of
571 # trampoline code in the ".plt" section. IN_SOLIB_CALL_TRAMPOLINE evaluates
572 # to nonzero if we are current stopped in one of these.
573 f:2:IN_SOLIB_CALL_TRAMPOLINE:int:in_solib_call_trampoline:CORE_ADDR pc, char *name:pc, name:::generic_in_solib_call_trampoline::0
574 # A target might have problems with watchpoints as soon as the stack
575 # frame of the current function has been destroyed. This mostly happens
576 # as the first action in a funtion's epilogue. in_function_epilogue_p()
577 # is defined to return a non-zero value if either the given addr is one
578 # instruction after the stack destroying instruction up to the trailing
579 # return instruction or if we can figure out that the stack frame has
580 # already been invalidated regardless of the value of addr. Targets
581 # which don't suffer from that problem could just let this functionality
582 # untouched.
583 m:::int:in_function_epilogue_p:CORE_ADDR addr:addr::0:generic_in_function_epilogue_p::0
584 # Given a vector of command-line arguments, return a newly allocated
585 # string which, when passed to the create_inferior function, will be
586 # parsed (on Unix systems, by the shell) to yield the same vector.
587 # This function should call error() if the argument vector is not
588 # representable for this target or if this target does not support
589 # command-line arguments.
590 # ARGC is the number of elements in the vector.
591 # ARGV is an array of strings, one per argument.
592 m::CONSTRUCT_INFERIOR_ARGUMENTS:char *:construct_inferior_arguments:int argc, char **argv:argc, argv:::construct_inferior_arguments::0
593 F:2:DWARF2_BUILD_FRAME_INFO:void:dwarf2_build_frame_info:struct objfile *objfile:objfile:::0
594 f:2:ELF_MAKE_MSYMBOL_SPECIAL:void:elf_make_msymbol_special:asymbol *sym, struct minimal_symbol *msym:sym, msym:::default_elf_make_msymbol_special::0
595 f:2:COFF_MAKE_MSYMBOL_SPECIAL:void:coff_make_msymbol_special:int val, struct minimal_symbol *msym:val, msym:::default_coff_make_msymbol_special::0
596 EOF
597 }
598
599 #
600 # The .log file
601 #
602 exec > new-gdbarch.log
603 function_list | while do_read
604 do
605 cat <<EOF
606 ${class} ${macro}(${actual})
607 ${returntype} ${function} ($formal)${attrib}
608 EOF
609 for r in ${read}
610 do
611 eval echo \"\ \ \ \ ${r}=\${${r}}\"
612 done
613 # #fallbackdefault=${fallbackdefault}
614 # #valid_p=${valid_p}
615 #EOF
616 if class_is_predicate_p && fallback_default_p
617 then
618 echo "Error: predicate function ${macro} can not have a non- multi-arch default" 1>&2
619 kill $$
620 exit 1
621 fi
622 if [ "x${invalid_p}" = "x0" -a -n "${postdefault}" ]
623 then
624 echo "Error: postdefault is useless when invalid_p=0" 1>&2
625 kill $$
626 exit 1
627 fi
628 if class_is_multiarch_p
629 then
630 if class_is_predicate_p ; then :
631 elif test "x${predefault}" = "x"
632 then
633 echo "Error: pure multi-arch function must have a predefault" 1>&2
634 kill $$
635 exit 1
636 fi
637 fi
638 echo ""
639 done
640
641 exec 1>&2
642 compare_new gdbarch.log
643
644
645 copyright ()
646 {
647 cat <<EOF
648 /* *INDENT-OFF* */ /* THIS FILE IS GENERATED */
649
650 /* Dynamic architecture support for GDB, the GNU debugger.
651 Copyright 1998, 1999, 2000, 2001, 2002 Free Software Foundation, Inc.
652
653 This file is part of GDB.
654
655 This program is free software; you can redistribute it and/or modify
656 it under the terms of the GNU General Public License as published by
657 the Free Software Foundation; either version 2 of the License, or
658 (at your option) any later version.
659
660 This program is distributed in the hope that it will be useful,
661 but WITHOUT ANY WARRANTY; without even the implied warranty of
662 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
663 GNU General Public License for more details.
664
665 You should have received a copy of the GNU General Public License
666 along with this program; if not, write to the Free Software
667 Foundation, Inc., 59 Temple Place - Suite 330,
668 Boston, MA 02111-1307, USA. */
669
670 /* This file was created with the aid of \`\`gdbarch.sh''.
671
672 The Bourne shell script \`\`gdbarch.sh'' creates the files
673 \`\`new-gdbarch.c'' and \`\`new-gdbarch.h and then compares them
674 against the existing \`\`gdbarch.[hc]''. Any differences found
675 being reported.
676
677 If editing this file, please also run gdbarch.sh and merge any
678 changes into that script. Conversely, when making sweeping changes
679 to this file, modifying gdbarch.sh and using its output may prove
680 easier. */
681
682 EOF
683 }
684
685 #
686 # The .h file
687 #
688
689 exec > new-gdbarch.h
690 copyright
691 cat <<EOF
692 #ifndef GDBARCH_H
693 #define GDBARCH_H
694
695 #include "dis-asm.h" /* Get defs for disassemble_info, which unfortunately is a typedef. */
696 #if !GDB_MULTI_ARCH
697 #include "value.h" /* For default_coerce_float_to_double which is referenced by a macro. */
698 #endif
699
700 struct frame_info;
701 struct value;
702 struct objfile;
703 struct minimal_symbol;
704
705 extern struct gdbarch *current_gdbarch;
706
707
708 /* If any of the following are defined, the target wasn't correctly
709 converted. */
710
711 #if GDB_MULTI_ARCH
712 #if defined (EXTRA_FRAME_INFO)
713 #error "EXTRA_FRAME_INFO: replaced by struct frame_extra_info"
714 #endif
715 #endif
716
717 #if GDB_MULTI_ARCH
718 #if defined (FRAME_FIND_SAVED_REGS)
719 #error "FRAME_FIND_SAVED_REGS: replaced by FRAME_INIT_SAVED_REGS"
720 #endif
721 #endif
722
723 #if (GDB_MULTI_ARCH >= GDB_MULTI_ARCH_PURE) && defined (GDB_TM_FILE)
724 #error "GDB_TM_FILE: Pure multi-arch targets do not have a tm.h file."
725 #endif
726 EOF
727
728 # function typedef's
729 printf "\n"
730 printf "\n"
731 printf "/* The following are pre-initialized by GDBARCH. */\n"
732 function_list | while do_read
733 do
734 if class_is_info_p
735 then
736 printf "\n"
737 printf "extern ${returntype} gdbarch_${function} (struct gdbarch *gdbarch);\n"
738 printf "/* set_gdbarch_${function}() - not applicable - pre-initialized. */\n"
739 printf "#if (GDB_MULTI_ARCH > GDB_MULTI_ARCH_PARTIAL) && defined (${macro})\n"
740 printf "#error \"Non multi-arch definition of ${macro}\"\n"
741 printf "#endif\n"
742 printf "#if GDB_MULTI_ARCH\n"
743 printf "#if (GDB_MULTI_ARCH > GDB_MULTI_ARCH_PARTIAL) || !defined (${macro})\n"
744 printf "#define ${macro} (gdbarch_${function} (current_gdbarch))\n"
745 printf "#endif\n"
746 printf "#endif\n"
747 fi
748 done
749
750 # function typedef's
751 printf "\n"
752 printf "\n"
753 printf "/* The following are initialized by the target dependent code. */\n"
754 function_list | while do_read
755 do
756 if [ -n "${comment}" ]
757 then
758 echo "${comment}" | sed \
759 -e '2 s,#,/*,' \
760 -e '3,$ s,#, ,' \
761 -e '$ s,$, */,'
762 fi
763 if class_is_multiarch_p
764 then
765 if class_is_predicate_p
766 then
767 printf "\n"
768 printf "extern int gdbarch_${function}_p (struct gdbarch *gdbarch);\n"
769 fi
770 else
771 if class_is_predicate_p
772 then
773 printf "\n"
774 printf "#if defined (${macro})\n"
775 printf "/* Legacy for systems yet to multi-arch ${macro} */\n"
776 #printf "#if (GDB_MULTI_ARCH <= GDB_MULTI_ARCH_PARTIAL) && defined (${macro})\n"
777 printf "#if !defined (${macro}_P)\n"
778 printf "#define ${macro}_P() (1)\n"
779 printf "#endif\n"
780 printf "#endif\n"
781 printf "\n"
782 printf "/* Default predicate for non- multi-arch targets. */\n"
783 printf "#if (!GDB_MULTI_ARCH) && !defined (${macro}_P)\n"
784 printf "#define ${macro}_P() (0)\n"
785 printf "#endif\n"
786 printf "\n"
787 printf "extern int gdbarch_${function}_p (struct gdbarch *gdbarch);\n"
788 printf "#if (GDB_MULTI_ARCH > GDB_MULTI_ARCH_PARTIAL) && defined (${macro}_P)\n"
789 printf "#error \"Non multi-arch definition of ${macro}\"\n"
790 printf "#endif\n"
791 printf "#if (GDB_MULTI_ARCH > GDB_MULTI_ARCH_PARTIAL) || !defined (${macro}_P)\n"
792 printf "#define ${macro}_P() (gdbarch_${function}_p (current_gdbarch))\n"
793 printf "#endif\n"
794 fi
795 fi
796 if class_is_variable_p
797 then
798 if fallback_default_p || class_is_predicate_p
799 then
800 printf "\n"
801 printf "/* Default (value) for non- multi-arch platforms. */\n"
802 printf "#if (!GDB_MULTI_ARCH) && !defined (${macro})\n"
803 echo "#define ${macro} (${fallbackdefault})" \
804 | sed -e 's/\([^a-z_]\)\(gdbarch[^a-z_]\)/\1current_\2/g'
805 printf "#endif\n"
806 fi
807 printf "\n"
808 printf "extern ${returntype} gdbarch_${function} (struct gdbarch *gdbarch);\n"
809 printf "extern void set_gdbarch_${function} (struct gdbarch *gdbarch, ${returntype} ${function});\n"
810 printf "#if (GDB_MULTI_ARCH > GDB_MULTI_ARCH_PARTIAL) && defined (${macro})\n"
811 printf "#error \"Non multi-arch definition of ${macro}\"\n"
812 printf "#endif\n"
813 printf "#if GDB_MULTI_ARCH\n"
814 printf "#if (GDB_MULTI_ARCH > GDB_MULTI_ARCH_PARTIAL) || !defined (${macro})\n"
815 printf "#define ${macro} (gdbarch_${function} (current_gdbarch))\n"
816 printf "#endif\n"
817 printf "#endif\n"
818 fi
819 if class_is_function_p
820 then
821 if class_is_multiarch_p ; then :
822 elif fallback_default_p || class_is_predicate_p
823 then
824 printf "\n"
825 printf "/* Default (function) for non- multi-arch platforms. */\n"
826 printf "#if (!GDB_MULTI_ARCH) && !defined (${macro})\n"
827 if [ "x${fallbackdefault}" = "x0" ]
828 then
829 printf "#define ${macro}(${actual}) (internal_error (__FILE__, __LINE__, \"${macro}\"), 0)\n"
830 else
831 # FIXME: Should be passing current_gdbarch through!
832 echo "#define ${macro}(${actual}) (${fallbackdefault} (${actual}))" \
833 | sed -e 's/\([^a-z_]\)\(gdbarch[^a-z_]\)/\1current_\2/g'
834 fi
835 printf "#endif\n"
836 fi
837 printf "\n"
838 if [ "x${formal}" = "xvoid" ] && class_is_multiarch_p
839 then
840 printf "typedef ${returntype} (gdbarch_${function}_ftype) (struct gdbarch *gdbarch);\n"
841 elif class_is_multiarch_p
842 then
843 printf "typedef ${returntype} (gdbarch_${function}_ftype) (struct gdbarch *gdbarch, ${formal});\n"
844 else
845 printf "typedef ${returntype} (gdbarch_${function}_ftype) (${formal});\n"
846 fi
847 if [ "x${formal}" = "xvoid" ]
848 then
849 printf "extern ${returntype} gdbarch_${function} (struct gdbarch *gdbarch);\n"
850 else
851 printf "extern ${returntype} gdbarch_${function} (struct gdbarch *gdbarch, ${formal});\n"
852 fi
853 printf "extern void set_gdbarch_${function} (struct gdbarch *gdbarch, gdbarch_${function}_ftype *${function});\n"
854 if class_is_multiarch_p ; then :
855 else
856 printf "#if (GDB_MULTI_ARCH > GDB_MULTI_ARCH_PARTIAL) && defined (${macro})\n"
857 printf "#error \"Non multi-arch definition of ${macro}\"\n"
858 printf "#endif\n"
859 printf "#if GDB_MULTI_ARCH\n"
860 printf "#if (GDB_MULTI_ARCH > GDB_MULTI_ARCH_PARTIAL) || !defined (${macro})\n"
861 if [ "x${actual}" = "x" ]
862 then
863 printf "#define ${macro}() (gdbarch_${function} (current_gdbarch))\n"
864 elif [ "x${actual}" = "x-" ]
865 then
866 printf "#define ${macro} (gdbarch_${function} (current_gdbarch))\n"
867 else
868 printf "#define ${macro}(${actual}) (gdbarch_${function} (current_gdbarch, ${actual}))\n"
869 fi
870 printf "#endif\n"
871 printf "#endif\n"
872 fi
873 fi
874 done
875
876 # close it off
877 cat <<EOF
878
879 extern struct gdbarch_tdep *gdbarch_tdep (struct gdbarch *gdbarch);
880
881
882 /* Mechanism for co-ordinating the selection of a specific
883 architecture.
884
885 GDB targets (*-tdep.c) can register an interest in a specific
886 architecture. Other GDB components can register a need to maintain
887 per-architecture data.
888
889 The mechanisms below ensures that there is only a loose connection
890 between the set-architecture command and the various GDB
891 components. Each component can independently register their need
892 to maintain architecture specific data with gdbarch.
893
894 Pragmatics:
895
896 Previously, a single TARGET_ARCHITECTURE_HOOK was provided. It
897 didn't scale.
898
899 The more traditional mega-struct containing architecture specific
900 data for all the various GDB components was also considered. Since
901 GDB is built from a variable number of (fairly independent)
902 components it was determined that the global aproach was not
903 applicable. */
904
905
906 /* Register a new architectural family with GDB.
907
908 Register support for the specified ARCHITECTURE with GDB. When
909 gdbarch determines that the specified architecture has been
910 selected, the corresponding INIT function is called.
911
912 --
913
914 The INIT function takes two parameters: INFO which contains the
915 information available to gdbarch about the (possibly new)
916 architecture; ARCHES which is a list of the previously created
917 \`\`struct gdbarch'' for this architecture.
918
919 The INIT function parameter INFO shall, as far as possible, be
920 pre-initialized with information obtained from INFO.ABFD or
921 previously selected architecture (if similar).
922
923 The INIT function shall return any of: NULL - indicating that it
924 doesn't recognize the selected architecture; an existing \`\`struct
925 gdbarch'' from the ARCHES list - indicating that the new
926 architecture is just a synonym for an earlier architecture (see
927 gdbarch_list_lookup_by_info()); a newly created \`\`struct gdbarch''
928 - that describes the selected architecture (see gdbarch_alloc()).
929
930 The DUMP_TDEP function shall print out all target specific values.
931 Care should be taken to ensure that the function works in both the
932 multi-arch and non- multi-arch cases. */
933
934 struct gdbarch_list
935 {
936 struct gdbarch *gdbarch;
937 struct gdbarch_list *next;
938 };
939
940 struct gdbarch_info
941 {
942 /* Use default: NULL (ZERO). */
943 const struct bfd_arch_info *bfd_arch_info;
944
945 /* Use default: BFD_ENDIAN_UNKNOWN (NB: is not ZERO). */
946 int byte_order;
947
948 /* Use default: NULL (ZERO). */
949 bfd *abfd;
950
951 /* Use default: NULL (ZERO). */
952 struct gdbarch_tdep_info *tdep_info;
953 };
954
955 typedef struct gdbarch *(gdbarch_init_ftype) (struct gdbarch_info info, struct gdbarch_list *arches);
956 typedef void (gdbarch_dump_tdep_ftype) (struct gdbarch *gdbarch, struct ui_file *file);
957
958 /* DEPRECATED - use gdbarch_register() */
959 extern void register_gdbarch_init (enum bfd_architecture architecture, gdbarch_init_ftype *);
960
961 extern void gdbarch_register (enum bfd_architecture architecture,
962 gdbarch_init_ftype *,
963 gdbarch_dump_tdep_ftype *);
964
965
966 /* Return a freshly allocated, NULL terminated, array of the valid
967 architecture names. Since architectures are registered during the
968 _initialize phase this function only returns useful information
969 once initialization has been completed. */
970
971 extern const char **gdbarch_printable_names (void);
972
973
974 /* Helper function. Search the list of ARCHES for a GDBARCH that
975 matches the information provided by INFO. */
976
977 extern struct gdbarch_list *gdbarch_list_lookup_by_info (struct gdbarch_list *arches, const struct gdbarch_info *info);
978
979
980 /* Helper function. Create a preliminary \`\`struct gdbarch''. Perform
981 basic initialization using values obtained from the INFO andTDEP
982 parameters. set_gdbarch_*() functions are called to complete the
983 initialization of the object. */
984
985 extern struct gdbarch *gdbarch_alloc (const struct gdbarch_info *info, struct gdbarch_tdep *tdep);
986
987
988 /* Helper function. Free a partially-constructed \`\`struct gdbarch''.
989 It is assumed that the caller freeds the \`\`struct
990 gdbarch_tdep''. */
991
992 extern void gdbarch_free (struct gdbarch *);
993
994
995 /* Helper function. Force an update of the current architecture.
996
997 The actual architecture selected is determined by INFO, \`\`(gdb) set
998 architecture'' et.al., the existing architecture and BFD's default
999 architecture. INFO should be initialized to zero and then selected
1000 fields should be updated.
1001
1002 Returns non-zero if the update succeeds */
1003
1004 extern int gdbarch_update_p (struct gdbarch_info info);
1005
1006
1007
1008 /* Register per-architecture data-pointer.
1009
1010 Reserve space for a per-architecture data-pointer. An identifier
1011 for the reserved data-pointer is returned. That identifer should
1012 be saved in a local static variable.
1013
1014 The per-architecture data-pointer can be initialized in one of two
1015 ways: The value can be set explicitly using a call to
1016 set_gdbarch_data(); the value can be set implicitly using the value
1017 returned by a non-NULL INIT() callback. INIT(), when non-NULL is
1018 called after the basic architecture vector has been created.
1019
1020 When a previously created architecture is re-selected, the
1021 per-architecture data-pointer for that previous architecture is
1022 restored. INIT() is not called.
1023
1024 During initialization, multiple assignments of the data-pointer are
1025 allowed, non-NULL values are deleted by calling FREE(). If the
1026 architecture is deleted using gdbarch_free() all non-NULL data
1027 pointers are also deleted using FREE().
1028
1029 Multiple registrarants for any architecture are allowed (and
1030 strongly encouraged). */
1031
1032 struct gdbarch_data;
1033
1034 typedef void *(gdbarch_data_init_ftype) (struct gdbarch *gdbarch);
1035 typedef void (gdbarch_data_free_ftype) (struct gdbarch *gdbarch,
1036 void *pointer);
1037 extern struct gdbarch_data *register_gdbarch_data (gdbarch_data_init_ftype *init,
1038 gdbarch_data_free_ftype *free);
1039 extern void set_gdbarch_data (struct gdbarch *gdbarch,
1040 struct gdbarch_data *data,
1041 void *pointer);
1042
1043 extern void *gdbarch_data (struct gdbarch_data*);
1044
1045
1046 /* Register per-architecture memory region.
1047
1048 Provide a memory-region swap mechanism. Per-architecture memory
1049 region are created. These memory regions are swapped whenever the
1050 architecture is changed. For a new architecture, the memory region
1051 is initialized with zero (0) and the INIT function is called.
1052
1053 Memory regions are swapped / initialized in the order that they are
1054 registered. NULL DATA and/or INIT values can be specified.
1055
1056 New code should use register_gdbarch_data(). */
1057
1058 typedef void (gdbarch_swap_ftype) (void);
1059 extern void register_gdbarch_swap (void *data, unsigned long size, gdbarch_swap_ftype *init);
1060 #define REGISTER_GDBARCH_SWAP(VAR) register_gdbarch_swap (&(VAR), sizeof ((VAR)), NULL)
1061
1062
1063
1064 /* The target-system-dependent byte order is dynamic */
1065
1066 extern int target_byte_order;
1067 #ifndef TARGET_BYTE_ORDER
1068 #define TARGET_BYTE_ORDER (target_byte_order + 0)
1069 #endif
1070
1071 extern int target_byte_order_auto;
1072 #ifndef TARGET_BYTE_ORDER_AUTO
1073 #define TARGET_BYTE_ORDER_AUTO (target_byte_order_auto + 0)
1074 #endif
1075
1076
1077
1078 /* The target-system-dependent BFD architecture is dynamic */
1079
1080 extern int target_architecture_auto;
1081 #ifndef TARGET_ARCHITECTURE_AUTO
1082 #define TARGET_ARCHITECTURE_AUTO (target_architecture_auto + 0)
1083 #endif
1084
1085 extern const struct bfd_arch_info *target_architecture;
1086 #ifndef TARGET_ARCHITECTURE
1087 #define TARGET_ARCHITECTURE (target_architecture + 0)
1088 #endif
1089
1090
1091 /* The target-system-dependent disassembler is semi-dynamic */
1092
1093 extern int dis_asm_read_memory (bfd_vma memaddr, bfd_byte *myaddr,
1094 unsigned int len, disassemble_info *info);
1095
1096 extern void dis_asm_memory_error (int status, bfd_vma memaddr,
1097 disassemble_info *info);
1098
1099 extern void dis_asm_print_address (bfd_vma addr,
1100 disassemble_info *info);
1101
1102 extern int (*tm_print_insn) (bfd_vma, disassemble_info*);
1103 extern disassemble_info tm_print_insn_info;
1104 #ifndef TARGET_PRINT_INSN_INFO
1105 #define TARGET_PRINT_INSN_INFO (&tm_print_insn_info)
1106 #endif
1107
1108
1109
1110 /* Set the dynamic target-system-dependent parameters (architecture,
1111 byte-order, ...) using information found in the BFD */
1112
1113 extern void set_gdbarch_from_file (bfd *);
1114
1115
1116 /* Initialize the current architecture to the "first" one we find on
1117 our list. */
1118
1119 extern void initialize_current_architecture (void);
1120
1121 /* For non-multiarched targets, do any initialization of the default
1122 gdbarch object necessary after the _initialize_MODULE functions
1123 have run. */
1124 extern void initialize_non_multiarch ();
1125
1126 /* gdbarch trace variable */
1127 extern int gdbarch_debug;
1128
1129 extern void gdbarch_dump (struct gdbarch *gdbarch, struct ui_file *file);
1130
1131 #endif
1132 EOF
1133 exec 1>&2
1134 #../move-if-change new-gdbarch.h gdbarch.h
1135 compare_new gdbarch.h
1136
1137
1138 #
1139 # C file
1140 #
1141
1142 exec > new-gdbarch.c
1143 copyright
1144 cat <<EOF
1145
1146 #include "defs.h"
1147 #include "arch-utils.h"
1148
1149 #if GDB_MULTI_ARCH
1150 #include "gdbcmd.h"
1151 #include "inferior.h" /* enum CALL_DUMMY_LOCATION et.al. */
1152 #else
1153 /* Just include everything in sight so that the every old definition
1154 of macro is visible. */
1155 #include "gdb_string.h"
1156 #include <ctype.h>
1157 #include "symtab.h"
1158 #include "frame.h"
1159 #include "inferior.h"
1160 #include "breakpoint.h"
1161 #include "gdb_wait.h"
1162 #include "gdbcore.h"
1163 #include "gdbcmd.h"
1164 #include "target.h"
1165 #include "gdbthread.h"
1166 #include "annotate.h"
1167 #include "symfile.h" /* for overlay functions */
1168 #include "value.h" /* For old tm.h/nm.h macros. */
1169 #endif
1170 #include "symcat.h"
1171
1172 #include "floatformat.h"
1173
1174 #include "gdb_assert.h"
1175 #include "gdb-events.h"
1176
1177 /* Static function declarations */
1178
1179 static void verify_gdbarch (struct gdbarch *gdbarch);
1180 static void alloc_gdbarch_data (struct gdbarch *);
1181 static void init_gdbarch_data (struct gdbarch *);
1182 static void free_gdbarch_data (struct gdbarch *);
1183 static void init_gdbarch_swap (struct gdbarch *);
1184 static void swapout_gdbarch_swap (struct gdbarch *);
1185 static void swapin_gdbarch_swap (struct gdbarch *);
1186
1187 /* Convenience macro for allocting typesafe memory. */
1188
1189 #ifndef XMALLOC
1190 #define XMALLOC(TYPE) (TYPE*) xmalloc (sizeof (TYPE))
1191 #endif
1192
1193
1194 /* Non-zero if we want to trace architecture code. */
1195
1196 #ifndef GDBARCH_DEBUG
1197 #define GDBARCH_DEBUG 0
1198 #endif
1199 int gdbarch_debug = GDBARCH_DEBUG;
1200
1201 EOF
1202
1203 # gdbarch open the gdbarch object
1204 printf "\n"
1205 printf "/* Maintain the struct gdbarch object */\n"
1206 printf "\n"
1207 printf "struct gdbarch\n"
1208 printf "{\n"
1209 printf " /* basic architectural information */\n"
1210 function_list | while do_read
1211 do
1212 if class_is_info_p
1213 then
1214 printf " ${returntype} ${function};\n"
1215 fi
1216 done
1217 printf "\n"
1218 printf " /* target specific vector. */\n"
1219 printf " struct gdbarch_tdep *tdep;\n"
1220 printf " gdbarch_dump_tdep_ftype *dump_tdep;\n"
1221 printf "\n"
1222 printf " /* per-architecture data-pointers */\n"
1223 printf " unsigned nr_data;\n"
1224 printf " void **data;\n"
1225 printf "\n"
1226 printf " /* per-architecture swap-regions */\n"
1227 printf " struct gdbarch_swap *swap;\n"
1228 printf "\n"
1229 cat <<EOF
1230 /* Multi-arch values.
1231
1232 When extending this structure you must:
1233
1234 Add the field below.
1235
1236 Declare set/get functions and define the corresponding
1237 macro in gdbarch.h.
1238
1239 gdbarch_alloc(): If zero/NULL is not a suitable default,
1240 initialize the new field.
1241
1242 verify_gdbarch(): Confirm that the target updated the field
1243 correctly.
1244
1245 gdbarch_dump(): Add a fprintf_unfiltered call so that the new
1246 field is dumped out
1247
1248 \`\`startup_gdbarch()'': Append an initial value to the static
1249 variable (base values on the host's c-type system).
1250
1251 get_gdbarch(): Implement the set/get functions (probably using
1252 the macro's as shortcuts).
1253
1254 */
1255
1256 EOF
1257 function_list | while do_read
1258 do
1259 if class_is_variable_p
1260 then
1261 printf " ${returntype} ${function};\n"
1262 elif class_is_function_p
1263 then
1264 printf " gdbarch_${function}_ftype *${function}${attrib};\n"
1265 fi
1266 done
1267 printf "};\n"
1268
1269 # A pre-initialized vector
1270 printf "\n"
1271 printf "\n"
1272 cat <<EOF
1273 /* The default architecture uses host values (for want of a better
1274 choice). */
1275 EOF
1276 printf "\n"
1277 printf "extern const struct bfd_arch_info bfd_default_arch_struct;\n"
1278 printf "\n"
1279 printf "struct gdbarch startup_gdbarch =\n"
1280 printf "{\n"
1281 printf " /* basic architecture information */\n"
1282 function_list | while do_read
1283 do
1284 if class_is_info_p
1285 then
1286 printf " ${staticdefault},\n"
1287 fi
1288 done
1289 cat <<EOF
1290 /* target specific vector and its dump routine */
1291 NULL, NULL,
1292 /*per-architecture data-pointers and swap regions */
1293 0, NULL, NULL,
1294 /* Multi-arch values */
1295 EOF
1296 function_list | while do_read
1297 do
1298 if class_is_function_p || class_is_variable_p
1299 then
1300 printf " ${staticdefault},\n"
1301 fi
1302 done
1303 cat <<EOF
1304 /* startup_gdbarch() */
1305 };
1306
1307 struct gdbarch *current_gdbarch = &startup_gdbarch;
1308
1309 /* Do any initialization needed for a non-multiarch configuration
1310 after the _initialize_MODULE functions have been run. */
1311 void
1312 initialize_non_multiarch ()
1313 {
1314 alloc_gdbarch_data (&startup_gdbarch);
1315 init_gdbarch_data (&startup_gdbarch);
1316 }
1317 EOF
1318
1319 # Create a new gdbarch struct
1320 printf "\n"
1321 printf "\n"
1322 cat <<EOF
1323 /* Create a new \`\`struct gdbarch'' based on information provided by
1324 \`\`struct gdbarch_info''. */
1325 EOF
1326 printf "\n"
1327 cat <<EOF
1328 struct gdbarch *
1329 gdbarch_alloc (const struct gdbarch_info *info,
1330 struct gdbarch_tdep *tdep)
1331 {
1332 /* NOTE: The new architecture variable is named \`\`current_gdbarch''
1333 so that macros such as TARGET_DOUBLE_BIT, when expanded, refer to
1334 the current local architecture and not the previous global
1335 architecture. This ensures that the new architectures initial
1336 values are not influenced by the previous architecture. Once
1337 everything is parameterised with gdbarch, this will go away. */
1338 struct gdbarch *current_gdbarch = XMALLOC (struct gdbarch);
1339 memset (current_gdbarch, 0, sizeof (*current_gdbarch));
1340
1341 alloc_gdbarch_data (current_gdbarch);
1342
1343 current_gdbarch->tdep = tdep;
1344 EOF
1345 printf "\n"
1346 function_list | while do_read
1347 do
1348 if class_is_info_p
1349 then
1350 printf " current_gdbarch->${function} = info->${function};\n"
1351 fi
1352 done
1353 printf "\n"
1354 printf " /* Force the explicit initialization of these. */\n"
1355 function_list | while do_read
1356 do
1357 if class_is_function_p || class_is_variable_p
1358 then
1359 if [ -n "${predefault}" -a "x${predefault}" != "x0" ]
1360 then
1361 printf " current_gdbarch->${function} = ${predefault};\n"
1362 fi
1363 fi
1364 done
1365 cat <<EOF
1366 /* gdbarch_alloc() */
1367
1368 return current_gdbarch;
1369 }
1370 EOF
1371
1372 # Free a gdbarch struct.
1373 printf "\n"
1374 printf "\n"
1375 cat <<EOF
1376 /* Free a gdbarch struct. This should never happen in normal
1377 operation --- once you've created a gdbarch, you keep it around.
1378 However, if an architecture's init function encounters an error
1379 building the structure, it may need to clean up a partially
1380 constructed gdbarch. */
1381
1382 void
1383 gdbarch_free (struct gdbarch *arch)
1384 {
1385 gdb_assert (arch != NULL);
1386 free_gdbarch_data (arch);
1387 xfree (arch);
1388 }
1389 EOF
1390
1391 # verify a new architecture
1392 printf "\n"
1393 printf "\n"
1394 printf "/* Ensure that all values in a GDBARCH are reasonable. */\n"
1395 printf "\n"
1396 cat <<EOF
1397 static void
1398 verify_gdbarch (struct gdbarch *gdbarch)
1399 {
1400 struct ui_file *log;
1401 struct cleanup *cleanups;
1402 long dummy;
1403 char *buf;
1404 /* Only perform sanity checks on a multi-arch target. */
1405 if (!GDB_MULTI_ARCH)
1406 return;
1407 log = mem_fileopen ();
1408 cleanups = make_cleanup_ui_file_delete (log);
1409 /* fundamental */
1410 if (gdbarch->byte_order == BFD_ENDIAN_UNKNOWN)
1411 fprintf_unfiltered (log, "\n\tbyte-order");
1412 if (gdbarch->bfd_arch_info == NULL)
1413 fprintf_unfiltered (log, "\n\tbfd_arch_info");
1414 /* Check those that need to be defined for the given multi-arch level. */
1415 EOF
1416 function_list | while do_read
1417 do
1418 if class_is_function_p || class_is_variable_p
1419 then
1420 if [ "x${invalid_p}" = "x0" ]
1421 then
1422 printf " /* Skip verify of ${function}, invalid_p == 0 */\n"
1423 elif class_is_predicate_p
1424 then
1425 printf " /* Skip verify of ${function}, has predicate */\n"
1426 # FIXME: See do_read for potential simplification
1427 elif [ -n "${invalid_p}" -a -n "${postdefault}" ]
1428 then
1429 printf " if (${invalid_p})\n"
1430 printf " gdbarch->${function} = ${postdefault};\n"
1431 elif [ -n "${predefault}" -a -n "${postdefault}" ]
1432 then
1433 printf " if (gdbarch->${function} == ${predefault})\n"
1434 printf " gdbarch->${function} = ${postdefault};\n"
1435 elif [ -n "${postdefault}" ]
1436 then
1437 printf " if (gdbarch->${function} == 0)\n"
1438 printf " gdbarch->${function} = ${postdefault};\n"
1439 elif [ -n "${invalid_p}" ]
1440 then
1441 printf " if ((GDB_MULTI_ARCH >= ${level})\n"
1442 printf " && (${invalid_p}))\n"
1443 printf " fprintf_unfiltered (log, \"\\\\n\\\\t${function}\");\n"
1444 elif [ -n "${predefault}" ]
1445 then
1446 printf " if ((GDB_MULTI_ARCH >= ${level})\n"
1447 printf " && (gdbarch->${function} == ${predefault}))\n"
1448 printf " fprintf_unfiltered (log, \"\\\\n\\\\t${function}\");\n"
1449 fi
1450 fi
1451 done
1452 cat <<EOF
1453 buf = ui_file_xstrdup (log, &dummy);
1454 make_cleanup (xfree, buf);
1455 if (strlen (buf) > 0)
1456 internal_error (__FILE__, __LINE__,
1457 "verify_gdbarch: the following are invalid ...%s",
1458 buf);
1459 do_cleanups (cleanups);
1460 }
1461 EOF
1462
1463 # dump the structure
1464 printf "\n"
1465 printf "\n"
1466 cat <<EOF
1467 /* Print out the details of the current architecture. */
1468
1469 /* NOTE/WARNING: The parameter is called \`\`current_gdbarch'' so that it
1470 just happens to match the global variable \`\`current_gdbarch''. That
1471 way macros refering to that variable get the local and not the global
1472 version - ulgh. Once everything is parameterised with gdbarch, this
1473 will go away. */
1474
1475 void
1476 gdbarch_dump (struct gdbarch *gdbarch, struct ui_file *file)
1477 {
1478 fprintf_unfiltered (file,
1479 "gdbarch_dump: GDB_MULTI_ARCH = %d\\n",
1480 GDB_MULTI_ARCH);
1481 EOF
1482 function_list | sort -t: +2 | while do_read
1483 do
1484 # multiarch functions don't have macros.
1485 if class_is_multiarch_p
1486 then
1487 printf " if (GDB_MULTI_ARCH)\n"
1488 printf " fprintf_unfiltered (file,\n"
1489 printf " \"gdbarch_dump: ${function} = 0x%%08lx\\\\n\",\n"
1490 printf " (long) current_gdbarch->${function});\n"
1491 continue
1492 fi
1493 # Print the macro definition.
1494 printf "#ifdef ${macro}\n"
1495 if [ "x${returntype}" = "xvoid" ]
1496 then
1497 printf "#if GDB_MULTI_ARCH\n"
1498 printf " /* Macro might contain \`[{}]' when not multi-arch */\n"
1499 fi
1500 if class_is_function_p
1501 then
1502 printf " fprintf_unfiltered (file,\n"
1503 printf " \"gdbarch_dump: %%s # %%s\\\\n\",\n"
1504 printf " \"${macro}(${actual})\",\n"
1505 printf " XSTRING (${macro} (${actual})));\n"
1506 else
1507 printf " fprintf_unfiltered (file,\n"
1508 printf " \"gdbarch_dump: ${macro} # %%s\\\\n\",\n"
1509 printf " XSTRING (${macro}));\n"
1510 fi
1511 # Print the architecture vector value
1512 if [ "x${returntype}" = "xvoid" ]
1513 then
1514 printf "#endif\n"
1515 fi
1516 if [ "x${print_p}" = "x()" ]
1517 then
1518 printf " gdbarch_dump_${function} (current_gdbarch);\n"
1519 elif [ "x${print_p}" = "x0" ]
1520 then
1521 printf " /* skip print of ${macro}, print_p == 0. */\n"
1522 elif [ -n "${print_p}" ]
1523 then
1524 printf " if (${print_p})\n"
1525 printf " fprintf_unfiltered (file,\n"
1526 printf " \"gdbarch_dump: ${macro} = %s\\\\n\",\n" "${fmt}"
1527 printf " ${print});\n"
1528 elif class_is_function_p
1529 then
1530 printf " if (GDB_MULTI_ARCH)\n"
1531 printf " fprintf_unfiltered (file,\n"
1532 printf " \"gdbarch_dump: ${macro} = 0x%%08lx\\\\n\",\n"
1533 printf " (long) current_gdbarch->${function}\n"
1534 printf " /*${macro} ()*/);\n"
1535 else
1536 printf " fprintf_unfiltered (file,\n"
1537 printf " \"gdbarch_dump: ${macro} = %s\\\\n\",\n" "${fmt}"
1538 printf " ${print});\n"
1539 fi
1540 printf "#endif\n"
1541 done
1542 cat <<EOF
1543 if (current_gdbarch->dump_tdep != NULL)
1544 current_gdbarch->dump_tdep (current_gdbarch, file);
1545 }
1546 EOF
1547
1548
1549 # GET/SET
1550 printf "\n"
1551 cat <<EOF
1552 struct gdbarch_tdep *
1553 gdbarch_tdep (struct gdbarch *gdbarch)
1554 {
1555 if (gdbarch_debug >= 2)
1556 fprintf_unfiltered (gdb_stdlog, "gdbarch_tdep called\\n");
1557 return gdbarch->tdep;
1558 }
1559 EOF
1560 printf "\n"
1561 function_list | while do_read
1562 do
1563 if class_is_predicate_p
1564 then
1565 printf "\n"
1566 printf "int\n"
1567 printf "gdbarch_${function}_p (struct gdbarch *gdbarch)\n"
1568 printf "{\n"
1569 if [ -n "${valid_p}" ]
1570 then
1571 printf " return ${valid_p};\n"
1572 else
1573 printf "#error \"gdbarch_${function}_p: not defined\"\n"
1574 fi
1575 printf "}\n"
1576 fi
1577 if class_is_function_p
1578 then
1579 printf "\n"
1580 printf "${returntype}\n"
1581 if [ "x${formal}" = "xvoid" ]
1582 then
1583 printf "gdbarch_${function} (struct gdbarch *gdbarch)\n"
1584 else
1585 printf "gdbarch_${function} (struct gdbarch *gdbarch, ${formal})\n"
1586 fi
1587 printf "{\n"
1588 printf " if (gdbarch->${function} == 0)\n"
1589 printf " internal_error (__FILE__, __LINE__,\n"
1590 printf " \"gdbarch: gdbarch_${function} invalid\");\n"
1591 printf " if (gdbarch_debug >= 2)\n"
1592 printf " fprintf_unfiltered (gdb_stdlog, \"gdbarch_${function} called\\\\n\");\n"
1593 if [ "x${actual}" = "x-" -o "x${actual}" = "x" ]
1594 then
1595 if class_is_multiarch_p
1596 then
1597 params="gdbarch"
1598 else
1599 params=""
1600 fi
1601 else
1602 if class_is_multiarch_p
1603 then
1604 params="gdbarch, ${actual}"
1605 else
1606 params="${actual}"
1607 fi
1608 fi
1609 if [ "x${returntype}" = "xvoid" ]
1610 then
1611 printf " gdbarch->${function} (${params});\n"
1612 else
1613 printf " return gdbarch->${function} (${params});\n"
1614 fi
1615 printf "}\n"
1616 printf "\n"
1617 printf "void\n"
1618 printf "set_gdbarch_${function} (struct gdbarch *gdbarch,\n"
1619 printf " `echo ${function} | sed -e 's/./ /g'` gdbarch_${function}_ftype ${function})\n"
1620 printf "{\n"
1621 printf " gdbarch->${function} = ${function};\n"
1622 printf "}\n"
1623 elif class_is_variable_p
1624 then
1625 printf "\n"
1626 printf "${returntype}\n"
1627 printf "gdbarch_${function} (struct gdbarch *gdbarch)\n"
1628 printf "{\n"
1629 if [ "x${invalid_p}" = "x0" ]
1630 then
1631 printf " /* Skip verify of ${function}, invalid_p == 0 */\n"
1632 elif [ -n "${invalid_p}" ]
1633 then
1634 printf " if (${invalid_p})\n"
1635 printf " internal_error (__FILE__, __LINE__,\n"
1636 printf " \"gdbarch: gdbarch_${function} invalid\");\n"
1637 elif [ -n "${predefault}" ]
1638 then
1639 printf " if (gdbarch->${function} == ${predefault})\n"
1640 printf " internal_error (__FILE__, __LINE__,\n"
1641 printf " \"gdbarch: gdbarch_${function} invalid\");\n"
1642 fi
1643 printf " if (gdbarch_debug >= 2)\n"
1644 printf " fprintf_unfiltered (gdb_stdlog, \"gdbarch_${function} called\\\\n\");\n"
1645 printf " return gdbarch->${function};\n"
1646 printf "}\n"
1647 printf "\n"
1648 printf "void\n"
1649 printf "set_gdbarch_${function} (struct gdbarch *gdbarch,\n"
1650 printf " `echo ${function} | sed -e 's/./ /g'` ${returntype} ${function})\n"
1651 printf "{\n"
1652 printf " gdbarch->${function} = ${function};\n"
1653 printf "}\n"
1654 elif class_is_info_p
1655 then
1656 printf "\n"
1657 printf "${returntype}\n"
1658 printf "gdbarch_${function} (struct gdbarch *gdbarch)\n"
1659 printf "{\n"
1660 printf " if (gdbarch_debug >= 2)\n"
1661 printf " fprintf_unfiltered (gdb_stdlog, \"gdbarch_${function} called\\\\n\");\n"
1662 printf " return gdbarch->${function};\n"
1663 printf "}\n"
1664 fi
1665 done
1666
1667 # All the trailing guff
1668 cat <<EOF
1669
1670
1671 /* Keep a registry of per-architecture data-pointers required by GDB
1672 modules. */
1673
1674 struct gdbarch_data
1675 {
1676 unsigned index;
1677 gdbarch_data_init_ftype *init;
1678 gdbarch_data_free_ftype *free;
1679 };
1680
1681 struct gdbarch_data_registration
1682 {
1683 struct gdbarch_data *data;
1684 struct gdbarch_data_registration *next;
1685 };
1686
1687 struct gdbarch_data_registry
1688 {
1689 unsigned nr;
1690 struct gdbarch_data_registration *registrations;
1691 };
1692
1693 struct gdbarch_data_registry gdbarch_data_registry =
1694 {
1695 0, NULL,
1696 };
1697
1698 struct gdbarch_data *
1699 register_gdbarch_data (gdbarch_data_init_ftype *init,
1700 gdbarch_data_free_ftype *free)
1701 {
1702 struct gdbarch_data_registration **curr;
1703 for (curr = &gdbarch_data_registry.registrations;
1704 (*curr) != NULL;
1705 curr = &(*curr)->next);
1706 (*curr) = XMALLOC (struct gdbarch_data_registration);
1707 (*curr)->next = NULL;
1708 (*curr)->data = XMALLOC (struct gdbarch_data);
1709 (*curr)->data->index = gdbarch_data_registry.nr++;
1710 (*curr)->data->init = init;
1711 (*curr)->data->free = free;
1712 return (*curr)->data;
1713 }
1714
1715
1716 /* Walk through all the registered users initializing each in turn. */
1717
1718 static void
1719 init_gdbarch_data (struct gdbarch *gdbarch)
1720 {
1721 struct gdbarch_data_registration *rego;
1722 for (rego = gdbarch_data_registry.registrations;
1723 rego != NULL;
1724 rego = rego->next)
1725 {
1726 struct gdbarch_data *data = rego->data;
1727 gdb_assert (data->index < gdbarch->nr_data);
1728 if (data->init != NULL)
1729 {
1730 void *pointer = data->init (gdbarch);
1731 set_gdbarch_data (gdbarch, data, pointer);
1732 }
1733 }
1734 }
1735
1736 /* Create/delete the gdbarch data vector. */
1737
1738 static void
1739 alloc_gdbarch_data (struct gdbarch *gdbarch)
1740 {
1741 gdb_assert (gdbarch->data == NULL);
1742 gdbarch->nr_data = gdbarch_data_registry.nr;
1743 gdbarch->data = xcalloc (gdbarch->nr_data, sizeof (void*));
1744 }
1745
1746 static void
1747 free_gdbarch_data (struct gdbarch *gdbarch)
1748 {
1749 struct gdbarch_data_registration *rego;
1750 gdb_assert (gdbarch->data != NULL);
1751 for (rego = gdbarch_data_registry.registrations;
1752 rego != NULL;
1753 rego = rego->next)
1754 {
1755 struct gdbarch_data *data = rego->data;
1756 gdb_assert (data->index < gdbarch->nr_data);
1757 if (data->free != NULL && gdbarch->data[data->index] != NULL)
1758 {
1759 data->free (gdbarch, gdbarch->data[data->index]);
1760 gdbarch->data[data->index] = NULL;
1761 }
1762 }
1763 xfree (gdbarch->data);
1764 gdbarch->data = NULL;
1765 }
1766
1767
1768 /* Initialize the current value of thee specified per-architecture
1769 data-pointer. */
1770
1771 void
1772 set_gdbarch_data (struct gdbarch *gdbarch,
1773 struct gdbarch_data *data,
1774 void *pointer)
1775 {
1776 gdb_assert (data->index < gdbarch->nr_data);
1777 if (data->free != NULL && gdbarch->data[data->index] != NULL)
1778 data->free (gdbarch, gdbarch->data[data->index]);
1779 gdbarch->data[data->index] = pointer;
1780 }
1781
1782 /* Return the current value of the specified per-architecture
1783 data-pointer. */
1784
1785 void *
1786 gdbarch_data (struct gdbarch_data *data)
1787 {
1788 gdb_assert (data->index < current_gdbarch->nr_data);
1789 return current_gdbarch->data[data->index];
1790 }
1791
1792
1793
1794 /* Keep a registry of swapped data required by GDB modules. */
1795
1796 struct gdbarch_swap
1797 {
1798 void *swap;
1799 struct gdbarch_swap_registration *source;
1800 struct gdbarch_swap *next;
1801 };
1802
1803 struct gdbarch_swap_registration
1804 {
1805 void *data;
1806 unsigned long sizeof_data;
1807 gdbarch_swap_ftype *init;
1808 struct gdbarch_swap_registration *next;
1809 };
1810
1811 struct gdbarch_swap_registry
1812 {
1813 int nr;
1814 struct gdbarch_swap_registration *registrations;
1815 };
1816
1817 struct gdbarch_swap_registry gdbarch_swap_registry =
1818 {
1819 0, NULL,
1820 };
1821
1822 void
1823 register_gdbarch_swap (void *data,
1824 unsigned long sizeof_data,
1825 gdbarch_swap_ftype *init)
1826 {
1827 struct gdbarch_swap_registration **rego;
1828 for (rego = &gdbarch_swap_registry.registrations;
1829 (*rego) != NULL;
1830 rego = &(*rego)->next);
1831 (*rego) = XMALLOC (struct gdbarch_swap_registration);
1832 (*rego)->next = NULL;
1833 (*rego)->init = init;
1834 (*rego)->data = data;
1835 (*rego)->sizeof_data = sizeof_data;
1836 }
1837
1838
1839 static void
1840 init_gdbarch_swap (struct gdbarch *gdbarch)
1841 {
1842 struct gdbarch_swap_registration *rego;
1843 struct gdbarch_swap **curr = &gdbarch->swap;
1844 for (rego = gdbarch_swap_registry.registrations;
1845 rego != NULL;
1846 rego = rego->next)
1847 {
1848 if (rego->data != NULL)
1849 {
1850 (*curr) = XMALLOC (struct gdbarch_swap);
1851 (*curr)->source = rego;
1852 (*curr)->swap = xmalloc (rego->sizeof_data);
1853 (*curr)->next = NULL;
1854 memset (rego->data, 0, rego->sizeof_data);
1855 curr = &(*curr)->next;
1856 }
1857 if (rego->init != NULL)
1858 rego->init ();
1859 }
1860 }
1861
1862 static void
1863 swapout_gdbarch_swap (struct gdbarch *gdbarch)
1864 {
1865 struct gdbarch_swap *curr;
1866 for (curr = gdbarch->swap;
1867 curr != NULL;
1868 curr = curr->next)
1869 memcpy (curr->swap, curr->source->data, curr->source->sizeof_data);
1870 }
1871
1872 static void
1873 swapin_gdbarch_swap (struct gdbarch *gdbarch)
1874 {
1875 struct gdbarch_swap *curr;
1876 for (curr = gdbarch->swap;
1877 curr != NULL;
1878 curr = curr->next)
1879 memcpy (curr->source->data, curr->swap, curr->source->sizeof_data);
1880 }
1881
1882
1883 /* Keep a registry of the architectures known by GDB. */
1884
1885 struct gdbarch_registration
1886 {
1887 enum bfd_architecture bfd_architecture;
1888 gdbarch_init_ftype *init;
1889 gdbarch_dump_tdep_ftype *dump_tdep;
1890 struct gdbarch_list *arches;
1891 struct gdbarch_registration *next;
1892 };
1893
1894 static struct gdbarch_registration *gdbarch_registry = NULL;
1895
1896 static void
1897 append_name (const char ***buf, int *nr, const char *name)
1898 {
1899 *buf = xrealloc (*buf, sizeof (char**) * (*nr + 1));
1900 (*buf)[*nr] = name;
1901 *nr += 1;
1902 }
1903
1904 const char **
1905 gdbarch_printable_names (void)
1906 {
1907 if (GDB_MULTI_ARCH)
1908 {
1909 /* Accumulate a list of names based on the registed list of
1910 architectures. */
1911 enum bfd_architecture a;
1912 int nr_arches = 0;
1913 const char **arches = NULL;
1914 struct gdbarch_registration *rego;
1915 for (rego = gdbarch_registry;
1916 rego != NULL;
1917 rego = rego->next)
1918 {
1919 const struct bfd_arch_info *ap;
1920 ap = bfd_lookup_arch (rego->bfd_architecture, 0);
1921 if (ap == NULL)
1922 internal_error (__FILE__, __LINE__,
1923 "gdbarch_architecture_names: multi-arch unknown");
1924 do
1925 {
1926 append_name (&arches, &nr_arches, ap->printable_name);
1927 ap = ap->next;
1928 }
1929 while (ap != NULL);
1930 }
1931 append_name (&arches, &nr_arches, NULL);
1932 return arches;
1933 }
1934 else
1935 /* Just return all the architectures that BFD knows. Assume that
1936 the legacy architecture framework supports them. */
1937 return bfd_arch_list ();
1938 }
1939
1940
1941 void
1942 gdbarch_register (enum bfd_architecture bfd_architecture,
1943 gdbarch_init_ftype *init,
1944 gdbarch_dump_tdep_ftype *dump_tdep)
1945 {
1946 struct gdbarch_registration **curr;
1947 const struct bfd_arch_info *bfd_arch_info;
1948 /* Check that BFD recognizes this architecture */
1949 bfd_arch_info = bfd_lookup_arch (bfd_architecture, 0);
1950 if (bfd_arch_info == NULL)
1951 {
1952 internal_error (__FILE__, __LINE__,
1953 "gdbarch: Attempt to register unknown architecture (%d)",
1954 bfd_architecture);
1955 }
1956 /* Check that we haven't seen this architecture before */
1957 for (curr = &gdbarch_registry;
1958 (*curr) != NULL;
1959 curr = &(*curr)->next)
1960 {
1961 if (bfd_architecture == (*curr)->bfd_architecture)
1962 internal_error (__FILE__, __LINE__,
1963 "gdbarch: Duplicate registraration of architecture (%s)",
1964 bfd_arch_info->printable_name);
1965 }
1966 /* log it */
1967 if (gdbarch_debug)
1968 fprintf_unfiltered (gdb_stdlog, "register_gdbarch_init (%s, 0x%08lx)\n",
1969 bfd_arch_info->printable_name,
1970 (long) init);
1971 /* Append it */
1972 (*curr) = XMALLOC (struct gdbarch_registration);
1973 (*curr)->bfd_architecture = bfd_architecture;
1974 (*curr)->init = init;
1975 (*curr)->dump_tdep = dump_tdep;
1976 (*curr)->arches = NULL;
1977 (*curr)->next = NULL;
1978 /* When non- multi-arch, install whatever target dump routine we've
1979 been provided - hopefully that routine has been written correctly
1980 and works regardless of multi-arch. */
1981 if (!GDB_MULTI_ARCH && dump_tdep != NULL
1982 && startup_gdbarch.dump_tdep == NULL)
1983 startup_gdbarch.dump_tdep = dump_tdep;
1984 }
1985
1986 void
1987 register_gdbarch_init (enum bfd_architecture bfd_architecture,
1988 gdbarch_init_ftype *init)
1989 {
1990 gdbarch_register (bfd_architecture, init, NULL);
1991 }
1992
1993
1994 /* Look for an architecture using gdbarch_info. Base search on only
1995 BFD_ARCH_INFO and BYTE_ORDER. */
1996
1997 struct gdbarch_list *
1998 gdbarch_list_lookup_by_info (struct gdbarch_list *arches,
1999 const struct gdbarch_info *info)
2000 {
2001 for (; arches != NULL; arches = arches->next)
2002 {
2003 if (info->bfd_arch_info != arches->gdbarch->bfd_arch_info)
2004 continue;
2005 if (info->byte_order != arches->gdbarch->byte_order)
2006 continue;
2007 return arches;
2008 }
2009 return NULL;
2010 }
2011
2012
2013 /* Update the current architecture. Return ZERO if the update request
2014 failed. */
2015
2016 int
2017 gdbarch_update_p (struct gdbarch_info info)
2018 {
2019 struct gdbarch *new_gdbarch;
2020 struct gdbarch_list **list;
2021 struct gdbarch_registration *rego;
2022
2023 /* Fill in missing parts of the INFO struct using a number of
2024 sources: \`\`set ...''; INFOabfd supplied; existing target. */
2025
2026 /* \`\`(gdb) set architecture ...'' */
2027 if (info.bfd_arch_info == NULL
2028 && !TARGET_ARCHITECTURE_AUTO)
2029 info.bfd_arch_info = TARGET_ARCHITECTURE;
2030 if (info.bfd_arch_info == NULL
2031 && info.abfd != NULL
2032 && bfd_get_arch (info.abfd) != bfd_arch_unknown
2033 && bfd_get_arch (info.abfd) != bfd_arch_obscure)
2034 info.bfd_arch_info = bfd_get_arch_info (info.abfd);
2035 if (info.bfd_arch_info == NULL)
2036 info.bfd_arch_info = TARGET_ARCHITECTURE;
2037
2038 /* \`\`(gdb) set byte-order ...'' */
2039 if (info.byte_order == BFD_ENDIAN_UNKNOWN
2040 && !TARGET_BYTE_ORDER_AUTO)
2041 info.byte_order = TARGET_BYTE_ORDER;
2042 /* From the INFO struct. */
2043 if (info.byte_order == BFD_ENDIAN_UNKNOWN
2044 && info.abfd != NULL)
2045 info.byte_order = (bfd_big_endian (info.abfd) ? BFD_ENDIAN_BIG
2046 : bfd_little_endian (info.abfd) ? BFD_ENDIAN_LITTLE
2047 : BFD_ENDIAN_UNKNOWN);
2048 /* From the current target. */
2049 if (info.byte_order == BFD_ENDIAN_UNKNOWN)
2050 info.byte_order = TARGET_BYTE_ORDER;
2051
2052 /* Must have found some sort of architecture. */
2053 gdb_assert (info.bfd_arch_info != NULL);
2054
2055 if (gdbarch_debug)
2056 {
2057 fprintf_unfiltered (gdb_stdlog,
2058 "gdbarch_update: info.bfd_arch_info %s\n",
2059 (info.bfd_arch_info != NULL
2060 ? info.bfd_arch_info->printable_name
2061 : "(null)"));
2062 fprintf_unfiltered (gdb_stdlog,
2063 "gdbarch_update: info.byte_order %d (%s)\n",
2064 info.byte_order,
2065 (info.byte_order == BFD_ENDIAN_BIG ? "big"
2066 : info.byte_order == BFD_ENDIAN_LITTLE ? "little"
2067 : "default"));
2068 fprintf_unfiltered (gdb_stdlog,
2069 "gdbarch_update: info.abfd 0x%lx\n",
2070 (long) info.abfd);
2071 fprintf_unfiltered (gdb_stdlog,
2072 "gdbarch_update: info.tdep_info 0x%lx\n",
2073 (long) info.tdep_info);
2074 }
2075
2076 /* Find the target that knows about this architecture. */
2077 for (rego = gdbarch_registry;
2078 rego != NULL;
2079 rego = rego->next)
2080 if (rego->bfd_architecture == info.bfd_arch_info->arch)
2081 break;
2082 if (rego == NULL)
2083 {
2084 if (gdbarch_debug)
2085 fprintf_unfiltered (gdb_stdlog, "gdbarch_update: No matching architecture\\n");
2086 return 0;
2087 }
2088
2089 /* Ask the target for a replacement architecture. */
2090 new_gdbarch = rego->init (info, rego->arches);
2091
2092 /* Did the target like it? No. Reject the change. */
2093 if (new_gdbarch == NULL)
2094 {
2095 if (gdbarch_debug)
2096 fprintf_unfiltered (gdb_stdlog, "gdbarch_update: Target rejected architecture\\n");
2097 return 0;
2098 }
2099
2100 /* Did the architecture change? No. Do nothing. */
2101 if (current_gdbarch == new_gdbarch)
2102 {
2103 if (gdbarch_debug)
2104 fprintf_unfiltered (gdb_stdlog, "gdbarch_update: Architecture 0x%08lx (%s) unchanged\\n",
2105 (long) new_gdbarch,
2106 new_gdbarch->bfd_arch_info->printable_name);
2107 return 1;
2108 }
2109
2110 /* Swap all data belonging to the old target out */
2111 swapout_gdbarch_swap (current_gdbarch);
2112
2113 /* Is this a pre-existing architecture? Yes. Swap it in. */
2114 for (list = &rego->arches;
2115 (*list) != NULL;
2116 list = &(*list)->next)
2117 {
2118 if ((*list)->gdbarch == new_gdbarch)
2119 {
2120 if (gdbarch_debug)
2121 fprintf_unfiltered (gdb_stdlog,
2122 "gdbarch_update: Previous architecture 0x%08lx (%s) selected\\n",
2123 (long) new_gdbarch,
2124 new_gdbarch->bfd_arch_info->printable_name);
2125 current_gdbarch = new_gdbarch;
2126 swapin_gdbarch_swap (new_gdbarch);
2127 architecture_changed_event ();
2128 return 1;
2129 }
2130 }
2131
2132 /* Append this new architecture to this targets list. */
2133 (*list) = XMALLOC (struct gdbarch_list);
2134 (*list)->next = NULL;
2135 (*list)->gdbarch = new_gdbarch;
2136
2137 /* Switch to this new architecture. Dump it out. */
2138 current_gdbarch = new_gdbarch;
2139 if (gdbarch_debug)
2140 {
2141 fprintf_unfiltered (gdb_stdlog,
2142 "gdbarch_update: New architecture 0x%08lx (%s) selected\\n",
2143 (long) new_gdbarch,
2144 new_gdbarch->bfd_arch_info->printable_name);
2145 }
2146
2147 /* Check that the newly installed architecture is valid. Plug in
2148 any post init values. */
2149 new_gdbarch->dump_tdep = rego->dump_tdep;
2150 verify_gdbarch (new_gdbarch);
2151
2152 /* Initialize the per-architecture memory (swap) areas.
2153 CURRENT_GDBARCH must be update before these modules are
2154 called. */
2155 init_gdbarch_swap (new_gdbarch);
2156
2157 /* Initialize the per-architecture data-pointer of all parties that
2158 registered an interest in this architecture. CURRENT_GDBARCH
2159 must be updated before these modules are called. */
2160 init_gdbarch_data (new_gdbarch);
2161 architecture_changed_event ();
2162
2163 if (gdbarch_debug)
2164 gdbarch_dump (current_gdbarch, gdb_stdlog);
2165
2166 return 1;
2167 }
2168
2169
2170 /* Disassembler */
2171
2172 /* Pointer to the target-dependent disassembly function. */
2173 int (*tm_print_insn) (bfd_vma, disassemble_info *);
2174 disassemble_info tm_print_insn_info;
2175
2176
2177 extern void _initialize_gdbarch (void);
2178
2179 void
2180 _initialize_gdbarch (void)
2181 {
2182 struct cmd_list_element *c;
2183
2184 INIT_DISASSEMBLE_INFO_NO_ARCH (tm_print_insn_info, gdb_stdout, (fprintf_ftype)fprintf_filtered);
2185 tm_print_insn_info.flavour = bfd_target_unknown_flavour;
2186 tm_print_insn_info.read_memory_func = dis_asm_read_memory;
2187 tm_print_insn_info.memory_error_func = dis_asm_memory_error;
2188 tm_print_insn_info.print_address_func = dis_asm_print_address;
2189
2190 add_show_from_set (add_set_cmd ("arch",
2191 class_maintenance,
2192 var_zinteger,
2193 (char *)&gdbarch_debug,
2194 "Set architecture debugging.\\n\\
2195 When non-zero, architecture debugging is enabled.", &setdebuglist),
2196 &showdebuglist);
2197 c = add_set_cmd ("archdebug",
2198 class_maintenance,
2199 var_zinteger,
2200 (char *)&gdbarch_debug,
2201 "Set architecture debugging.\\n\\
2202 When non-zero, architecture debugging is enabled.", &setlist);
2203
2204 deprecate_cmd (c, "set debug arch");
2205 deprecate_cmd (add_show_from_set (c, &showlist), "show debug arch");
2206 }
2207 EOF
2208
2209 # close things off
2210 exec 1>&2
2211 #../move-if-change new-gdbarch.c gdbarch.c
2212 compare_new gdbarch.c
This page took 0.078466 seconds and 5 git commands to generate.