3 # Architecture commands for GDB, the GNU debugger.
5 # Copyright (C) 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007
6 # Free Software Foundation, Inc.
8 # This file is part of GDB.
10 # This program is free software; you can redistribute it and/or modify
11 # it under the terms of the GNU General Public License as published by
12 # the Free Software Foundation; either version 2 of the License, or
13 # (at your option) any later version.
15 # This program is distributed in the hope that it will be useful,
16 # but WITHOUT ANY WARRANTY; without even the implied warranty of
17 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
18 # GNU General Public License for more details.
20 # You should have received a copy of the GNU General Public License
21 # along with this program; if not, write to the Free Software
22 # Foundation, Inc., 51 Franklin Street, Fifth Floor,
23 # Boston, MA 02110-1301, USA.
25 # Make certain that the script is not running in an internationalized
28 LC_ALL=c ; export LC_ALL
36 echo "${file} missing? cp new-${file} ${file}" 1>&2
37 elif diff -u ${file} new-${file}
39 echo "${file} unchanged" 1>&2
41 echo "${file} has changed? cp new-${file} ${file}" 1>&2
46 # Format of the input table
47 read="class macro returntype function formal actual staticdefault predefault postdefault invalid_p print garbage_at_eol"
55 if test "${line}" = ""
58 elif test "${line}" = "#" -a "${comment}" = ""
61 elif expr "${line}" : "#" > /dev/null
67 # The semantics of IFS varies between different SH's. Some
68 # treat ``::' as three fields while some treat it as just too.
69 # Work around this by eliminating ``::'' ....
70 line="`echo "${line}" | sed -e 's/::/: :/g' -e 's/::/: :/g'`"
72 OFS="${IFS}" ; IFS="[:]"
73 eval read ${read} <<EOF
78 if test -n "${garbage_at_eol}"
80 echo "Garbage at end-of-line in ${line}" 1>&2
85 # .... and then going back through each field and strip out those
86 # that ended up with just that space character.
89 if eval test \"\${${r}}\" = \"\ \"
95 FUNCTION=`echo ${function} | tr '[a-z]' '[A-Z]'`
96 if test "x${macro}" = "x="
98 # Provide a UCASE version of function (for when there isn't MACRO)
100 elif test "${macro}" = "${FUNCTION}"
102 echo "${function}: Specify = for macro field" 1>&2
107 # Check that macro definition wasn't supplied for multi-arch
110 if test "${macro}" != ""
112 echo "Error: Function ${function} multi-arch yet macro ${macro} supplied" 1>&2
119 m ) staticdefault="${predefault}" ;;
120 M ) staticdefault="0" ;;
121 * ) test "${staticdefault}" || staticdefault=0 ;;
126 case "${invalid_p}" in
128 if test -n "${predefault}"
130 #invalid_p="gdbarch->${function} == ${predefault}"
131 predicate="gdbarch->${function} != ${predefault}"
132 elif class_is_variable_p
134 predicate="gdbarch->${function} != 0"
135 elif class_is_function_p
137 predicate="gdbarch->${function} != NULL"
141 echo "Predicate function ${function} with invalid_p." 1>&2
148 # PREDEFAULT is a valid fallback definition of MEMBER when
149 # multi-arch is not enabled. This ensures that the
150 # default value, when multi-arch is the same as the
151 # default value when not multi-arch. POSTDEFAULT is
152 # always a valid definition of MEMBER as this again
153 # ensures consistency.
155 if [ -n "${postdefault}" ]
157 fallbackdefault="${postdefault}"
158 elif [ -n "${predefault}" ]
160 fallbackdefault="${predefault}"
165 #NOT YET: See gdbarch.log for basic verification of
180 fallback_default_p ()
182 [ -n "${postdefault}" -a "x${invalid_p}" != "x0" ] \
183 || [ -n "${predefault}" -a "x${invalid_p}" = "x0" ]
186 class_is_variable_p ()
194 class_is_function_p ()
197 *f* | *F* | *m* | *M* ) true ;;
202 class_is_multiarch_p ()
210 class_is_predicate_p ()
213 *F* | *V* | *M* ) true ;;
227 # dump out/verify the doco
237 # F -> function + predicate
238 # hiding a function + predicate to test function validity
241 # V -> variable + predicate
242 # hiding a variable + predicate to test variables validity
244 # hiding something from the ``struct info'' object
245 # m -> multi-arch function
246 # hiding a multi-arch function (parameterised with the architecture)
247 # M -> multi-arch function + predicate
248 # hiding a multi-arch function + predicate to test function validity
252 # The name of the legacy C macro by which this method can be
253 # accessed. If empty, no macro is defined. If "=", a macro
254 # formed from the upper-case function name is used.
258 # For functions, the return type; for variables, the data type
262 # For functions, the member function name; for variables, the
263 # variable name. Member function names are always prefixed with
264 # ``gdbarch_'' for name-space purity.
268 # The formal argument list. It is assumed that the formal
269 # argument list includes the actual name of each list element.
270 # A function with no arguments shall have ``void'' as the
271 # formal argument list.
275 # The list of actual arguments. The arguments specified shall
276 # match the FORMAL list given above. Functions with out
277 # arguments leave this blank.
281 # To help with the GDB startup a static gdbarch object is
282 # created. STATICDEFAULT is the value to insert into that
283 # static gdbarch object. Since this a static object only
284 # simple expressions can be used.
286 # If STATICDEFAULT is empty, zero is used.
290 # An initial value to assign to MEMBER of the freshly
291 # malloc()ed gdbarch object. After initialization, the
292 # freshly malloc()ed object is passed to the target
293 # architecture code for further updates.
295 # If PREDEFAULT is empty, zero is used.
297 # A non-empty PREDEFAULT, an empty POSTDEFAULT and a zero
298 # INVALID_P are specified, PREDEFAULT will be used as the
299 # default for the non- multi-arch target.
301 # A zero PREDEFAULT function will force the fallback to call
304 # Variable declarations can refer to ``gdbarch'' which will
305 # contain the current architecture. Care should be taken.
309 # A value to assign to MEMBER of the new gdbarch object should
310 # the target architecture code fail to change the PREDEFAULT
313 # If POSTDEFAULT is empty, no post update is performed.
315 # If both INVALID_P and POSTDEFAULT are non-empty then
316 # INVALID_P will be used to determine if MEMBER should be
317 # changed to POSTDEFAULT.
319 # If a non-empty POSTDEFAULT and a zero INVALID_P are
320 # specified, POSTDEFAULT will be used as the default for the
321 # non- multi-arch target (regardless of the value of
324 # You cannot specify both a zero INVALID_P and a POSTDEFAULT.
326 # Variable declarations can refer to ``current_gdbarch'' which
327 # will contain the current architecture. Care should be
332 # A predicate equation that validates MEMBER. Non-zero is
333 # returned if the code creating the new architecture failed to
334 # initialize MEMBER or the initialized the member is invalid.
335 # If POSTDEFAULT is non-empty then MEMBER will be updated to
336 # that value. If POSTDEFAULT is empty then internal_error()
339 # If INVALID_P is empty, a check that MEMBER is no longer
340 # equal to PREDEFAULT is used.
342 # The expression ``0'' disables the INVALID_P check making
343 # PREDEFAULT a legitimate value.
345 # See also PREDEFAULT and POSTDEFAULT.
349 # An optional expression that convers MEMBER to a value
350 # suitable for formatting using %s.
352 # If PRINT is empty, paddr_nz (for CORE_ADDR) or paddr_d
353 # (anything else) is used.
355 garbage_at_eol ) : ;;
357 # Catches stray fields.
360 echo "Bad field ${field}"
368 # See below (DOCO) for description of each field
370 i::const struct bfd_arch_info *:bfd_arch_info:::&bfd_default_arch_struct::::gdbarch_bfd_arch_info (current_gdbarch)->printable_name
372 i::int:byte_order:::BFD_ENDIAN_BIG
374 i::enum gdb_osabi:osabi:::GDB_OSABI_UNKNOWN
376 i::const struct target_desc *:target_desc:::::::paddr_d ((long) current_gdbarch->target_desc)
377 # Number of bits in a char or unsigned char for the target machine.
378 # Just like CHAR_BIT in <limits.h> but describes the target machine.
379 # v:TARGET_CHAR_BIT:int:char_bit::::8 * sizeof (char):8::0:
381 # Number of bits in a short or unsigned short for the target machine.
382 v::int:short_bit:::8 * sizeof (short):2*TARGET_CHAR_BIT::0
383 # Number of bits in an int or unsigned int for the target machine.
384 v::int:int_bit:::8 * sizeof (int):4*TARGET_CHAR_BIT::0
385 # Number of bits in a long or unsigned long for the target machine.
386 v::int:long_bit:::8 * sizeof (long):4*TARGET_CHAR_BIT::0
387 # Number of bits in a long long or unsigned long long for the target
389 v::int:long_long_bit:::8 * sizeof (LONGEST):2*current_gdbarch->long_bit::0
391 # The ABI default bit-size and format for "float", "double", and "long
392 # double". These bit/format pairs should eventually be combined into
393 # a single object. For the moment, just initialize them as a pair.
394 # Each format describes both the big and little endian layouts (if
397 v::int:float_bit:::8 * sizeof (float):4*TARGET_CHAR_BIT::0
398 v::const struct floatformat **:float_format:::::floatformats_ieee_single::pformat (current_gdbarch->float_format)
399 v::int:double_bit:::8 * sizeof (double):8*TARGET_CHAR_BIT::0
400 v::const struct floatformat **:double_format:::::floatformats_ieee_double::pformat (current_gdbarch->double_format)
401 v::int:long_double_bit:::8 * sizeof (long double):8*TARGET_CHAR_BIT::0
402 v::const struct floatformat **:long_double_format:::::floatformats_ieee_double::pformat (current_gdbarch->long_double_format)
404 # For most targets, a pointer on the target and its representation as an
405 # address in GDB have the same size and "look the same". For such a
406 # target, you need only set gdbarch_ptr_bit and gdbarch_addr_bit
407 # / addr_bit will be set from it.
409 # If gdbarch_ptr_bit and gdbarch_addr_bit are different, you'll probably
410 # also need to set gdbarch_pointer_to_address and gdbarch_address_to_pointer
413 # ptr_bit is the size of a pointer on the target
414 v::int:ptr_bit:::8 * sizeof (void*):current_gdbarch->int_bit::0
415 # addr_bit is the size of a target address as represented in gdb
416 v::int:addr_bit:::8 * sizeof (void*):0:gdbarch_ptr_bit (current_gdbarch):
418 # One if \`char' acts like \`signed char', zero if \`unsigned char'.
419 v::int:char_signed:::1:-1:1
421 F::CORE_ADDR:read_pc:struct regcache *regcache:regcache
422 F::void:write_pc:struct regcache *regcache, CORE_ADDR val:regcache, val
423 # Function for getting target's idea of a frame pointer. FIXME: GDB's
424 # whole scheme for dealing with "frames" and "frame pointers" needs a
426 f::void:virtual_frame_pointer:CORE_ADDR pc, int *frame_regnum, LONGEST *frame_offset:pc, frame_regnum, frame_offset:0:legacy_virtual_frame_pointer::0
428 M::void:pseudo_register_read:struct regcache *regcache, int cookednum, gdb_byte *buf:regcache, cookednum, buf
429 M::void:pseudo_register_write:struct regcache *regcache, int cookednum, const gdb_byte *buf:regcache, cookednum, buf
431 v::int:num_regs:::0:-1
432 # This macro gives the number of pseudo-registers that live in the
433 # register namespace but do not get fetched or stored on the target.
434 # These pseudo-registers may be aliases for other registers,
435 # combinations of other registers, or they may be computed by GDB.
436 v::int:num_pseudo_regs:::0:0::0
438 # GDB's standard (or well known) register numbers. These can map onto
439 # a real register or a pseudo (computed) register or not be defined at
441 # gdbarch_sp_regnum will hopefully be replaced by UNWIND_SP.
442 v::int:sp_regnum:::-1:-1::0
443 v::int:pc_regnum:::-1:-1::0
444 v::int:ps_regnum:::-1:-1::0
445 v::int:fp0_regnum:::0:-1::0
446 # Convert stab register number (from \`r\' declaration) to a gdb REGNUM.
447 f::int:stab_reg_to_regnum:int stab_regnr:stab_regnr::no_op_reg_to_regnum::0
448 # Provide a default mapping from a ecoff register number to a gdb REGNUM.
449 f::int:ecoff_reg_to_regnum:int ecoff_regnr:ecoff_regnr::no_op_reg_to_regnum::0
450 # Provide a default mapping from a DWARF register number to a gdb REGNUM.
451 f::int:dwarf_reg_to_regnum:int dwarf_regnr:dwarf_regnr::no_op_reg_to_regnum::0
452 # Convert from an sdb register number to an internal gdb register number.
453 f::int:sdb_reg_to_regnum:int sdb_regnr:sdb_regnr::no_op_reg_to_regnum::0
454 f::int:dwarf2_reg_to_regnum:int dwarf2_regnr:dwarf2_regnr::no_op_reg_to_regnum::0
455 f::const char *:register_name:int regnr:regnr
457 # Return the type of a register specified by the architecture. Only
458 # the register cache should call this function directly; others should
459 # use "register_type".
460 M::struct type *:register_type:int reg_nr:reg_nr
462 # See gdbint.texinfo, and PUSH_DUMMY_CALL.
463 M::struct frame_id:unwind_dummy_id:struct frame_info *info:info
464 # Implement UNWIND_DUMMY_ID and PUSH_DUMMY_CALL, then delete
465 # DEPRECATED_FP_REGNUM.
466 v:=:int:deprecated_fp_regnum:::-1:-1::0
468 # See gdbint.texinfo. See infcall.c.
469 M::CORE_ADDR:push_dummy_call:struct value *function, struct regcache *regcache, CORE_ADDR bp_addr, int nargs, struct value **args, CORE_ADDR sp, int struct_return, CORE_ADDR struct_addr:function, regcache, bp_addr, nargs, args, sp, struct_return, struct_addr
470 # DEPRECATED_REGISTER_SIZE can be deleted.
471 v:=:int:deprecated_register_size
472 v::int:call_dummy_location::::AT_ENTRY_POINT::0
473 M::CORE_ADDR:push_dummy_code:CORE_ADDR sp, CORE_ADDR funaddr, int using_gcc, struct value **args, int nargs, struct type *value_type, CORE_ADDR *real_pc, CORE_ADDR *bp_addr, struct regcache *regcache:sp, funaddr, using_gcc, args, nargs, value_type, real_pc, bp_addr, regcache
475 m::void:print_registers_info:struct ui_file *file, struct frame_info *frame, int regnum, int all:file, frame, regnum, all::default_print_registers_info::0
476 M::void:print_float_info:struct ui_file *file, struct frame_info *frame, const char *args:file, frame, args
477 M::void:print_vector_info:struct ui_file *file, struct frame_info *frame, const char *args:file, frame, args
478 # MAP a GDB RAW register number onto a simulator register number. See
479 # also include/...-sim.h.
480 f::int:register_sim_regno:int reg_nr:reg_nr::legacy_register_sim_regno::0
481 f::int:cannot_fetch_register:int regnum:regnum::cannot_register_not::0
482 f::int:cannot_store_register:int regnum:regnum::cannot_register_not::0
483 # setjmp/longjmp support.
484 F::int:get_longjmp_target:struct frame_info *frame, CORE_ADDR *pc:frame, pc
486 v:=:int:believe_pcc_promotion:::::::
488 f::int:convert_register_p:int regnum, struct type *type:regnum, type:0:generic_convert_register_p::0
489 f::void:register_to_value:struct frame_info *frame, int regnum, struct type *type, gdb_byte *buf:frame, regnum, type, buf:0
490 f::void:value_to_register:struct frame_info *frame, int regnum, struct type *type, const gdb_byte *buf:frame, regnum, type, buf:0
491 # Construct a value representing the contents of register REGNUM in
492 # frame FRAME, interpreted as type TYPE. The routine needs to
493 # allocate and return a struct value with all value attributes
494 # (but not the value contents) filled in.
495 f::struct value *:value_from_register:struct type *type, int regnum, struct frame_info *frame:type, regnum, frame::default_value_from_register::0
497 f::CORE_ADDR:pointer_to_address:struct type *type, const gdb_byte *buf:type, buf::unsigned_pointer_to_address::0
498 f::void:address_to_pointer:struct type *type, gdb_byte *buf, CORE_ADDR addr:type, buf, addr::unsigned_address_to_pointer::0
499 M::CORE_ADDR:integer_to_address:struct type *type, const gdb_byte *buf:type, buf
501 # It has been suggested that this, well actually its predecessor,
502 # should take the type/value of the function to be called and not the
503 # return type. This is left as an exercise for the reader.
505 # NOTE: cagney/2004-06-13: The function stack.c:return_command uses
506 # the predicate with default hack to avoid calling STORE_RETURN_VALUE
507 # (via legacy_return_value), when a small struct is involved.
509 M::enum return_value_convention:return_value:struct type *valtype, struct regcache *regcache, gdb_byte *readbuf, const gdb_byte *writebuf:valtype, regcache, readbuf, writebuf::legacy_return_value
511 # The deprecated methods EXTRACT_RETURN_VALUE, STORE_RETURN_VALUE,
512 # DEPRECATED_EXTRACT_STRUCT_VALUE_ADDRESS and
513 # DEPRECATED_USE_STRUCT_CONVENTION have all been folded into
516 f:=:void:extract_return_value:struct type *type, struct regcache *regcache, gdb_byte *valbuf:type, regcache, valbuf:0
517 f:=:void:store_return_value:struct type *type, struct regcache *regcache, const gdb_byte *valbuf:type, regcache, valbuf:0
518 f:=:int:deprecated_use_struct_convention:int gcc_p, struct type *value_type:gcc_p, value_type::generic_use_struct_convention::0
520 # As of 2004-01-17 only the 32-bit SPARC ABI has been identified as an
521 # ABI suitable for the implementation of a robust extract
522 # struct-convention return-value address method (the sparc saves the
523 # address in the callers frame). All the other cases so far examined,
524 # the DEPRECATED_EXTRACT_STRUCT_VALUE implementation has been
525 # erreneous - the code was incorrectly assuming that the return-value
526 # address, stored in a register, was preserved across the entire
529 # For the moment retain DEPRECATED_EXTRACT_STRUCT_VALUE as a marker of
530 # the ABIs that are still to be analyzed - perhaps this should simply
531 # be deleted. The commented out extract_returned_value_address method
532 # is provided as a starting point for the 32-bit SPARC. It, or
533 # something like it, along with changes to both infcmd.c and stack.c
534 # will be needed for that case to work. NB: It is passed the callers
535 # frame since it is only after the callee has returned that this
538 #M::CORE_ADDR:extract_returned_value_address:struct frame_info *caller_frame:caller_frame
539 F:=:CORE_ADDR:deprecated_extract_struct_value_address:struct regcache *regcache:regcache
542 f::CORE_ADDR:skip_prologue:CORE_ADDR ip:ip:0:0
543 f::int:inner_than:CORE_ADDR lhs, CORE_ADDR rhs:lhs, rhs:0:0
544 f::const gdb_byte *:breakpoint_from_pc:CORE_ADDR *pcptr, int *lenptr:pcptr, lenptr::0:
545 M::CORE_ADDR:adjust_breakpoint_address:CORE_ADDR bpaddr:bpaddr
546 f::int:memory_insert_breakpoint:struct bp_target_info *bp_tgt:bp_tgt:0:default_memory_insert_breakpoint::0
547 f::int:memory_remove_breakpoint:struct bp_target_info *bp_tgt:bp_tgt:0:default_memory_remove_breakpoint::0
548 v::CORE_ADDR:decr_pc_after_break:::0:::0
550 # A function can be addressed by either it's "pointer" (possibly a
551 # descriptor address) or "entry point" (first executable instruction).
552 # The method "convert_from_func_ptr_addr" converting the former to the
553 # latter. DEPRECATED_FUNCTION_START_OFFSET is being used to implement
554 # a simplified subset of that functionality - the function's address
555 # corresponds to the "function pointer" and the function's start
556 # corresponds to the "function entry point" - and hence is redundant.
558 v:=:CORE_ADDR:deprecated_function_start_offset:::0:::0
560 # Return the remote protocol register number associated with this
561 # register. Normally the identity mapping.
562 m::int:remote_register_number:int regno:regno::default_remote_register_number::0
564 # Fetch the target specific address used to represent a load module.
565 F::CORE_ADDR:fetch_tls_load_module_address:struct objfile *objfile:objfile
567 v::CORE_ADDR:frame_args_skip:::0:::0
568 M::CORE_ADDR:unwind_pc:struct frame_info *next_frame:next_frame
569 M::CORE_ADDR:unwind_sp:struct frame_info *next_frame:next_frame
570 # DEPRECATED_FRAME_LOCALS_ADDRESS as been replaced by the per-frame
571 # frame-base. Enable frame-base before frame-unwind.
572 F::int:frame_num_args:struct frame_info *frame:frame
574 M::CORE_ADDR:frame_align:CORE_ADDR address:address
575 # DEPRECATED_REG_STRUCT_HAS_ADDR has been replaced by
576 # stabs_argument_has_addr.
577 F:=:int:deprecated_reg_struct_has_addr:int gcc_p, struct type *type:gcc_p, type
578 m::int:stabs_argument_has_addr:struct type *type:type::default_stabs_argument_has_addr::0
579 v::int:frame_red_zone_size
581 m::CORE_ADDR:convert_from_func_ptr_addr:CORE_ADDR addr, struct target_ops *targ:addr, targ::convert_from_func_ptr_addr_identity::0
582 # On some machines there are bits in addresses which are not really
583 # part of the address, but are used by the kernel, the hardware, etc.
584 # for special purposes. gdbarch_addr_bits_remove takes out any such bits so
585 # we get a "real" address such as one would find in a symbol table.
586 # This is used only for addresses of instructions, and even then I'm
587 # not sure it's used in all contexts. It exists to deal with there
588 # being a few stray bits in the PC which would mislead us, not as some
589 # sort of generic thing to handle alignment or segmentation (it's
590 # possible it should be in TARGET_READ_PC instead).
591 f::CORE_ADDR:addr_bits_remove:CORE_ADDR addr:addr::core_addr_identity::0
592 # It is not at all clear why gdbarch_smash_text_address is not folded into
593 # gdbarch_addr_bits_remove.
594 f::CORE_ADDR:smash_text_address:CORE_ADDR addr:addr::core_addr_identity::0
596 # FIXME/cagney/2001-01-18: This should be split in two. A target method that
597 # indicates if the target needs software single step. An ISA method to
600 # FIXME/cagney/2001-01-18: This should be replaced with something that inserts
601 # breakpoints using the breakpoint system instead of blatting memory directly
604 # FIXME/cagney/2001-01-18: The logic is backwards. It should be asking if the
605 # target can single step. If not, then implement single step using breakpoints.
607 # A return value of 1 means that the software_single_step breakpoints
608 # were inserted; 0 means they were not.
609 F:=:int:software_single_step:struct frame_info *frame:frame
611 # Return non-zero if the processor is executing a delay slot and a
612 # further single-step is needed before the instruction finishes.
613 M::int:single_step_through_delay:struct frame_info *frame:frame
614 # FIXME: cagney/2003-08-28: Need to find a better way of selecting the
615 # disassembler. Perhaps objdump can handle it?
616 f:TARGET_PRINT_INSN:int:print_insn:bfd_vma vma, struct disassemble_info *info:vma, info::0:
617 f::CORE_ADDR:skip_trampoline_code:struct frame_info *frame, CORE_ADDR pc:frame, pc::generic_skip_trampoline_code::0
620 # If IN_SOLIB_DYNSYM_RESOLVE_CODE returns true, and SKIP_SOLIB_RESOLVER
621 # evaluates non-zero, this is the address where the debugger will place
622 # a step-resume breakpoint to get us past the dynamic linker.
623 m::CORE_ADDR:skip_solib_resolver:CORE_ADDR pc:pc::generic_skip_solib_resolver::0
624 # Some systems also have trampoline code for returning from shared libs.
625 f::int:in_solib_return_trampoline:CORE_ADDR pc, char *name:pc, name::generic_in_solib_return_trampoline::0
627 # A target might have problems with watchpoints as soon as the stack
628 # frame of the current function has been destroyed. This mostly happens
629 # as the first action in a funtion's epilogue. in_function_epilogue_p()
630 # is defined to return a non-zero value if either the given addr is one
631 # instruction after the stack destroying instruction up to the trailing
632 # return instruction or if we can figure out that the stack frame has
633 # already been invalidated regardless of the value of addr. Targets
634 # which don't suffer from that problem could just let this functionality
636 m::int:in_function_epilogue_p:CORE_ADDR addr:addr:0:generic_in_function_epilogue_p::0
637 # Given a vector of command-line arguments, return a newly allocated
638 # string which, when passed to the create_inferior function, will be
639 # parsed (on Unix systems, by the shell) to yield the same vector.
640 # This function should call error() if the argument vector is not
641 # representable for this target or if this target does not support
642 # command-line arguments.
643 # ARGC is the number of elements in the vector.
644 # ARGV is an array of strings, one per argument.
645 m::char *:construct_inferior_arguments:int argc, char **argv:argc, argv::construct_inferior_arguments::0
646 f::void:elf_make_msymbol_special:asymbol *sym, struct minimal_symbol *msym:sym, msym::default_elf_make_msymbol_special::0
647 f::void:coff_make_msymbol_special:int val, struct minimal_symbol *msym:val, msym::default_coff_make_msymbol_special::0
648 v::const char *:name_of_malloc:::"malloc":"malloc"::0:current_gdbarch->name_of_malloc
649 v::int:cannot_step_breakpoint:::0:0::0
650 v::int:have_nonsteppable_watchpoint:::0:0::0
651 F::int:address_class_type_flags:int byte_size, int dwarf2_addr_class:byte_size, dwarf2_addr_class
652 M::const char *:address_class_type_flags_to_name:int type_flags:type_flags
653 M::int:address_class_name_to_type_flags:const char *name, int *type_flags_ptr:name, type_flags_ptr
654 # Is a register in a group
655 m::int:register_reggroup_p:int regnum, struct reggroup *reggroup:regnum, reggroup::default_register_reggroup_p::0
656 # Fetch the pointer to the ith function argument.
657 F::CORE_ADDR:fetch_pointer_argument:struct frame_info *frame, int argi, struct type *type:frame, argi, type
659 # Return the appropriate register set for a core file section with
660 # name SECT_NAME and size SECT_SIZE.
661 M::const struct regset *:regset_from_core_section:const char *sect_name, size_t sect_size:sect_name, sect_size
663 # If the elements of C++ vtables are in-place function descriptors rather
664 # than normal function pointers (which may point to code or a descriptor),
666 v::int:vtable_function_descriptors:::0:0::0
668 # Set if the least significant bit of the delta is used instead of the least
669 # significant bit of the pfn for pointers to virtual member functions.
670 v::int:vbit_in_delta:::0:0::0
672 # Advance PC to next instruction in order to skip a permanent breakpoint.
673 F::void:skip_permanent_breakpoint:struct regcache *regcache:regcache
675 # Refresh overlay mapped state for section OSECT.
676 F::void:overlay_update:struct obj_section *osect:osect
683 exec > new-gdbarch.log
684 function_list | while do_read
687 ${class} ${returntype} ${function} ($formal)
691 eval echo \"\ \ \ \ ${r}=\${${r}}\"
693 if class_is_predicate_p && fallback_default_p
695 echo "Error: predicate function ${function} can not have a non- multi-arch default" 1>&2
699 if [ "x${invalid_p}" = "x0" -a -n "${postdefault}" ]
701 echo "Error: postdefault is useless when invalid_p=0" 1>&2
705 if class_is_multiarch_p
707 if class_is_predicate_p ; then :
708 elif test "x${predefault}" = "x"
710 echo "Error: pure multi-arch function ${function} must have a predefault" 1>&2
719 compare_new gdbarch.log
725 /* *INDENT-OFF* */ /* THIS FILE IS GENERATED */
727 /* Dynamic architecture support for GDB, the GNU debugger.
729 Copyright (C) 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006
730 Free Software Foundation, Inc.
732 This file is part of GDB.
734 This program is free software; you can redistribute it and/or modify
735 it under the terms of the GNU General Public License as published by
736 the Free Software Foundation; either version 2 of the License, or
737 (at your option) any later version.
739 This program is distributed in the hope that it will be useful,
740 but WITHOUT ANY WARRANTY; without even the implied warranty of
741 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
742 GNU General Public License for more details.
744 You should have received a copy of the GNU General Public License
745 along with this program; if not, write to the Free Software
746 Foundation, Inc., 51 Franklin Street, Fifth Floor,
747 Boston, MA 02110-1301, USA. */
749 /* This file was created with the aid of \`\`gdbarch.sh''.
751 The Bourne shell script \`\`gdbarch.sh'' creates the files
752 \`\`new-gdbarch.c'' and \`\`new-gdbarch.h and then compares them
753 against the existing \`\`gdbarch.[hc]''. Any differences found
756 If editing this file, please also run gdbarch.sh and merge any
757 changes into that script. Conversely, when making sweeping changes
758 to this file, modifying gdbarch.sh and using its output may prove
780 struct minimal_symbol;
784 struct disassemble_info;
787 struct bp_target_info;
790 extern struct gdbarch *current_gdbarch;
796 printf "/* The following are pre-initialized by GDBARCH. */\n"
797 function_list | while do_read
802 printf "extern ${returntype} gdbarch_${function} (struct gdbarch *gdbarch);\n"
803 printf "/* set_gdbarch_${function}() - not applicable - pre-initialized. */\n"
804 if test -n "${macro}"
806 printf "#if !defined (GDB_TM_FILE) && defined (${macro})\n"
807 printf "#error \"Non multi-arch definition of ${macro}\"\n"
809 printf "#if !defined (${macro})\n"
810 printf "#define ${macro} (gdbarch_${function} (current_gdbarch))\n"
819 printf "/* The following are initialized by the target dependent code. */\n"
820 function_list | while do_read
822 if [ -n "${comment}" ]
824 echo "${comment}" | sed \
830 if class_is_predicate_p
832 if test -n "${macro}"
835 printf "#if defined (${macro})\n"
836 printf "/* Legacy for systems yet to multi-arch ${macro} */\n"
837 printf "#if !defined (${macro}_P)\n"
838 printf "#define ${macro}_P() (1)\n"
843 printf "extern int gdbarch_${function}_p (struct gdbarch *gdbarch);\n"
844 if test -n "${macro}"
846 printf "#if !defined (GDB_TM_FILE) && defined (${macro}_P)\n"
847 printf "#error \"Non multi-arch definition of ${macro}\"\n"
849 printf "#if !defined (${macro}_P)\n"
850 printf "#define ${macro}_P() (gdbarch_${function}_p (current_gdbarch))\n"
854 if class_is_variable_p
857 printf "extern ${returntype} gdbarch_${function} (struct gdbarch *gdbarch);\n"
858 printf "extern void set_gdbarch_${function} (struct gdbarch *gdbarch, ${returntype} ${function});\n"
859 if test -n "${macro}"
861 printf "#if !defined (GDB_TM_FILE) && defined (${macro})\n"
862 printf "#error \"Non multi-arch definition of ${macro}\"\n"
864 printf "#if !defined (${macro})\n"
865 printf "#define ${macro} (gdbarch_${function} (current_gdbarch))\n"
869 if class_is_function_p
872 if [ "x${formal}" = "xvoid" ] && class_is_multiarch_p
874 printf "typedef ${returntype} (gdbarch_${function}_ftype) (struct gdbarch *gdbarch);\n"
875 elif class_is_multiarch_p
877 printf "typedef ${returntype} (gdbarch_${function}_ftype) (struct gdbarch *gdbarch, ${formal});\n"
879 printf "typedef ${returntype} (gdbarch_${function}_ftype) (${formal});\n"
881 if [ "x${formal}" = "xvoid" ]
883 printf "extern ${returntype} gdbarch_${function} (struct gdbarch *gdbarch);\n"
885 printf "extern ${returntype} gdbarch_${function} (struct gdbarch *gdbarch, ${formal});\n"
887 printf "extern void set_gdbarch_${function} (struct gdbarch *gdbarch, gdbarch_${function}_ftype *${function});\n"
888 if test -n "${macro}"
890 printf "#if !defined (GDB_TM_FILE) && defined (${macro})\n"
891 printf "#error \"Non multi-arch definition of ${macro}\"\n"
893 if [ "x${actual}" = "x" ]
895 d="#define ${macro}() (gdbarch_${function} (current_gdbarch))"
896 elif [ "x${actual}" = "x-" ]
898 d="#define ${macro} (gdbarch_${function} (current_gdbarch))"
900 d="#define ${macro}(${actual}) (gdbarch_${function} (current_gdbarch, ${actual}))"
902 printf "#if !defined (${macro})\n"
903 if [ "x${actual}" = "x" ]
905 printf "#define ${macro}() (gdbarch_${function} (current_gdbarch))\n"
906 elif [ "x${actual}" = "x-" ]
908 printf "#define ${macro} (gdbarch_${function} (current_gdbarch))\n"
910 printf "#define ${macro}(${actual}) (gdbarch_${function} (current_gdbarch, ${actual}))\n"
920 extern struct gdbarch_tdep *gdbarch_tdep (struct gdbarch *gdbarch);
923 /* Mechanism for co-ordinating the selection of a specific
926 GDB targets (*-tdep.c) can register an interest in a specific
927 architecture. Other GDB components can register a need to maintain
928 per-architecture data.
930 The mechanisms below ensures that there is only a loose connection
931 between the set-architecture command and the various GDB
932 components. Each component can independently register their need
933 to maintain architecture specific data with gdbarch.
937 Previously, a single TARGET_ARCHITECTURE_HOOK was provided. It
940 The more traditional mega-struct containing architecture specific
941 data for all the various GDB components was also considered. Since
942 GDB is built from a variable number of (fairly independent)
943 components it was determined that the global aproach was not
947 /* Register a new architectural family with GDB.
949 Register support for the specified ARCHITECTURE with GDB. When
950 gdbarch determines that the specified architecture has been
951 selected, the corresponding INIT function is called.
955 The INIT function takes two parameters: INFO which contains the
956 information available to gdbarch about the (possibly new)
957 architecture; ARCHES which is a list of the previously created
958 \`\`struct gdbarch'' for this architecture.
960 The INFO parameter is, as far as possible, be pre-initialized with
961 information obtained from INFO.ABFD or the global defaults.
963 The ARCHES parameter is a linked list (sorted most recently used)
964 of all the previously created architures for this architecture
965 family. The (possibly NULL) ARCHES->gdbarch can used to access
966 values from the previously selected architecture for this
967 architecture family. The global \`\`current_gdbarch'' shall not be
970 The INIT function shall return any of: NULL - indicating that it
971 doesn't recognize the selected architecture; an existing \`\`struct
972 gdbarch'' from the ARCHES list - indicating that the new
973 architecture is just a synonym for an earlier architecture (see
974 gdbarch_list_lookup_by_info()); a newly created \`\`struct gdbarch''
975 - that describes the selected architecture (see gdbarch_alloc()).
977 The DUMP_TDEP function shall print out all target specific values.
978 Care should be taken to ensure that the function works in both the
979 multi-arch and non- multi-arch cases. */
983 struct gdbarch *gdbarch;
984 struct gdbarch_list *next;
989 /* Use default: NULL (ZERO). */
990 const struct bfd_arch_info *bfd_arch_info;
992 /* Use default: BFD_ENDIAN_UNKNOWN (NB: is not ZERO). */
995 /* Use default: NULL (ZERO). */
998 /* Use default: NULL (ZERO). */
999 struct gdbarch_tdep_info *tdep_info;
1001 /* Use default: GDB_OSABI_UNINITIALIZED (-1). */
1002 enum gdb_osabi osabi;
1004 /* Use default: NULL (ZERO). */
1005 const struct target_desc *target_desc;
1008 typedef struct gdbarch *(gdbarch_init_ftype) (struct gdbarch_info info, struct gdbarch_list *arches);
1009 typedef void (gdbarch_dump_tdep_ftype) (struct gdbarch *gdbarch, struct ui_file *file);
1011 /* DEPRECATED - use gdbarch_register() */
1012 extern void register_gdbarch_init (enum bfd_architecture architecture, gdbarch_init_ftype *);
1014 extern void gdbarch_register (enum bfd_architecture architecture,
1015 gdbarch_init_ftype *,
1016 gdbarch_dump_tdep_ftype *);
1019 /* Return a freshly allocated, NULL terminated, array of the valid
1020 architecture names. Since architectures are registered during the
1021 _initialize phase this function only returns useful information
1022 once initialization has been completed. */
1024 extern const char **gdbarch_printable_names (void);
1027 /* Helper function. Search the list of ARCHES for a GDBARCH that
1028 matches the information provided by INFO. */
1030 extern struct gdbarch_list *gdbarch_list_lookup_by_info (struct gdbarch_list *arches, const struct gdbarch_info *info);
1033 /* Helper function. Create a preliminary \`\`struct gdbarch''. Perform
1034 basic initialization using values obtained from the INFO and TDEP
1035 parameters. set_gdbarch_*() functions are called to complete the
1036 initialization of the object. */
1038 extern struct gdbarch *gdbarch_alloc (const struct gdbarch_info *info, struct gdbarch_tdep *tdep);
1041 /* Helper function. Free a partially-constructed \`\`struct gdbarch''.
1042 It is assumed that the caller freeds the \`\`struct
1045 extern void gdbarch_free (struct gdbarch *);
1048 /* Helper function. Allocate memory from the \`\`struct gdbarch''
1049 obstack. The memory is freed when the corresponding architecture
1052 extern void *gdbarch_obstack_zalloc (struct gdbarch *gdbarch, long size);
1053 #define GDBARCH_OBSTACK_CALLOC(GDBARCH, NR, TYPE) ((TYPE *) gdbarch_obstack_zalloc ((GDBARCH), (NR) * sizeof (TYPE)))
1054 #define GDBARCH_OBSTACK_ZALLOC(GDBARCH, TYPE) ((TYPE *) gdbarch_obstack_zalloc ((GDBARCH), sizeof (TYPE)))
1057 /* Helper function. Force an update of the current architecture.
1059 The actual architecture selected is determined by INFO, \`\`(gdb) set
1060 architecture'' et.al., the existing architecture and BFD's default
1061 architecture. INFO should be initialized to zero and then selected
1062 fields should be updated.
1064 Returns non-zero if the update succeeds */
1066 extern int gdbarch_update_p (struct gdbarch_info info);
1069 /* Helper function. Find an architecture matching info.
1071 INFO should be initialized using gdbarch_info_init, relevant fields
1072 set, and then finished using gdbarch_info_fill.
1074 Returns the corresponding architecture, or NULL if no matching
1075 architecture was found. "current_gdbarch" is not updated. */
1077 extern struct gdbarch *gdbarch_find_by_info (struct gdbarch_info info);
1080 /* Helper function. Set the global "current_gdbarch" to "gdbarch".
1082 FIXME: kettenis/20031124: Of the functions that follow, only
1083 gdbarch_from_bfd is supposed to survive. The others will
1084 dissappear since in the future GDB will (hopefully) be truly
1085 multi-arch. However, for now we're still stuck with the concept of
1086 a single active architecture. */
1088 extern void deprecated_current_gdbarch_select_hack (struct gdbarch *gdbarch);
1091 /* Register per-architecture data-pointer.
1093 Reserve space for a per-architecture data-pointer. An identifier
1094 for the reserved data-pointer is returned. That identifer should
1095 be saved in a local static variable.
1097 Memory for the per-architecture data shall be allocated using
1098 gdbarch_obstack_zalloc. That memory will be deleted when the
1099 corresponding architecture object is deleted.
1101 When a previously created architecture is re-selected, the
1102 per-architecture data-pointer for that previous architecture is
1103 restored. INIT() is not re-called.
1105 Multiple registrarants for any architecture are allowed (and
1106 strongly encouraged). */
1108 struct gdbarch_data;
1110 typedef void *(gdbarch_data_pre_init_ftype) (struct obstack *obstack);
1111 extern struct gdbarch_data *gdbarch_data_register_pre_init (gdbarch_data_pre_init_ftype *init);
1112 typedef void *(gdbarch_data_post_init_ftype) (struct gdbarch *gdbarch);
1113 extern struct gdbarch_data *gdbarch_data_register_post_init (gdbarch_data_post_init_ftype *init);
1114 extern void deprecated_set_gdbarch_data (struct gdbarch *gdbarch,
1115 struct gdbarch_data *data,
1118 extern void *gdbarch_data (struct gdbarch *gdbarch, struct gdbarch_data *);
1122 /* Register per-architecture memory region.
1124 Provide a memory-region swap mechanism. Per-architecture memory
1125 region are created. These memory regions are swapped whenever the
1126 architecture is changed. For a new architecture, the memory region
1127 is initialized with zero (0) and the INIT function is called.
1129 Memory regions are swapped / initialized in the order that they are
1130 registered. NULL DATA and/or INIT values can be specified.
1132 New code should use gdbarch_data_register_*(). */
1134 typedef void (gdbarch_swap_ftype) (void);
1135 extern void deprecated_register_gdbarch_swap (void *data, unsigned long size, gdbarch_swap_ftype *init);
1136 #define DEPRECATED_REGISTER_GDBARCH_SWAP(VAR) deprecated_register_gdbarch_swap (&(VAR), sizeof ((VAR)), NULL)
1140 /* Set the dynamic target-system-dependent parameters (architecture,
1141 byte-order, ...) using information found in the BFD */
1143 extern void set_gdbarch_from_file (bfd *);
1146 /* Initialize the current architecture to the "first" one we find on
1149 extern void initialize_current_architecture (void);
1151 /* gdbarch trace variable */
1152 extern int gdbarch_debug;
1154 extern void gdbarch_dump (struct gdbarch *gdbarch, struct ui_file *file);
1159 #../move-if-change new-gdbarch.h gdbarch.h
1160 compare_new gdbarch.h
1167 exec > new-gdbarch.c
1172 #include "arch-utils.h"
1175 #include "inferior.h"
1178 #include "floatformat.h"
1180 #include "gdb_assert.h"
1181 #include "gdb_string.h"
1182 #include "gdb-events.h"
1183 #include "reggroups.h"
1185 #include "gdb_obstack.h"
1187 /* Static function declarations */
1189 static void alloc_gdbarch_data (struct gdbarch *);
1191 /* Non-zero if we want to trace architecture code. */
1193 #ifndef GDBARCH_DEBUG
1194 #define GDBARCH_DEBUG 0
1196 int gdbarch_debug = GDBARCH_DEBUG;
1198 show_gdbarch_debug (struct ui_file *file, int from_tty,
1199 struct cmd_list_element *c, const char *value)
1201 fprintf_filtered (file, _("Architecture debugging is %s.\\n"), value);
1205 pformat (const struct floatformat **format)
1210 /* Just print out one of them - this is only for diagnostics. */
1211 return format[0]->name;
1216 # gdbarch open the gdbarch object
1218 printf "/* Maintain the struct gdbarch object */\n"
1220 printf "struct gdbarch\n"
1222 printf " /* Has this architecture been fully initialized? */\n"
1223 printf " int initialized_p;\n"
1225 printf " /* An obstack bound to the lifetime of the architecture. */\n"
1226 printf " struct obstack *obstack;\n"
1228 printf " /* basic architectural information */\n"
1229 function_list | while do_read
1233 printf " ${returntype} ${function};\n"
1237 printf " /* target specific vector. */\n"
1238 printf " struct gdbarch_tdep *tdep;\n"
1239 printf " gdbarch_dump_tdep_ftype *dump_tdep;\n"
1241 printf " /* per-architecture data-pointers */\n"
1242 printf " unsigned nr_data;\n"
1243 printf " void **data;\n"
1245 printf " /* per-architecture swap-regions */\n"
1246 printf " struct gdbarch_swap *swap;\n"
1249 /* Multi-arch values.
1251 When extending this structure you must:
1253 Add the field below.
1255 Declare set/get functions and define the corresponding
1258 gdbarch_alloc(): If zero/NULL is not a suitable default,
1259 initialize the new field.
1261 verify_gdbarch(): Confirm that the target updated the field
1264 gdbarch_dump(): Add a fprintf_unfiltered call so that the new
1267 \`\`startup_gdbarch()'': Append an initial value to the static
1268 variable (base values on the host's c-type system).
1270 get_gdbarch(): Implement the set/get functions (probably using
1271 the macro's as shortcuts).
1276 function_list | while do_read
1278 if class_is_variable_p
1280 printf " ${returntype} ${function};\n"
1281 elif class_is_function_p
1283 printf " gdbarch_${function}_ftype *${function};\n"
1288 # A pre-initialized vector
1292 /* The default architecture uses host values (for want of a better
1296 printf "extern const struct bfd_arch_info bfd_default_arch_struct;\n"
1298 printf "struct gdbarch startup_gdbarch =\n"
1300 printf " 1, /* Always initialized. */\n"
1301 printf " NULL, /* The obstack. */\n"
1302 printf " /* basic architecture information */\n"
1303 function_list | while do_read
1307 printf " ${staticdefault}, /* ${function} */\n"
1311 /* target specific vector and its dump routine */
1313 /*per-architecture data-pointers and swap regions */
1315 /* Multi-arch values */
1317 function_list | while do_read
1319 if class_is_function_p || class_is_variable_p
1321 printf " ${staticdefault}, /* ${function} */\n"
1325 /* startup_gdbarch() */
1328 struct gdbarch *current_gdbarch = &startup_gdbarch;
1331 # Create a new gdbarch struct
1334 /* Create a new \`\`struct gdbarch'' based on information provided by
1335 \`\`struct gdbarch_info''. */
1340 gdbarch_alloc (const struct gdbarch_info *info,
1341 struct gdbarch_tdep *tdep)
1343 /* NOTE: The new architecture variable is named \`\`current_gdbarch''
1344 so that macros such as TARGET_ARCHITECTURE, when expanded, refer to
1345 the current local architecture and not the previous global
1346 architecture. This ensures that the new architectures initial
1347 values are not influenced by the previous architecture. Once
1348 everything is parameterised with gdbarch, this will go away. */
1349 struct gdbarch *current_gdbarch;
1351 /* Create an obstack for allocating all the per-architecture memory,
1352 then use that to allocate the architecture vector. */
1353 struct obstack *obstack = XMALLOC (struct obstack);
1354 obstack_init (obstack);
1355 current_gdbarch = obstack_alloc (obstack, sizeof (*current_gdbarch));
1356 memset (current_gdbarch, 0, sizeof (*current_gdbarch));
1357 current_gdbarch->obstack = obstack;
1359 alloc_gdbarch_data (current_gdbarch);
1361 current_gdbarch->tdep = tdep;
1364 function_list | while do_read
1368 printf " current_gdbarch->${function} = info->${function};\n"
1372 printf " /* Force the explicit initialization of these. */\n"
1373 function_list | while do_read
1375 if class_is_function_p || class_is_variable_p
1377 if [ -n "${predefault}" -a "x${predefault}" != "x0" ]
1379 printf " current_gdbarch->${function} = ${predefault};\n"
1384 /* gdbarch_alloc() */
1386 return current_gdbarch;
1390 # Free a gdbarch struct.
1394 /* Allocate extra space using the per-architecture obstack. */
1397 gdbarch_obstack_zalloc (struct gdbarch *arch, long size)
1399 void *data = obstack_alloc (arch->obstack, size);
1400 memset (data, 0, size);
1405 /* Free a gdbarch struct. This should never happen in normal
1406 operation --- once you've created a gdbarch, you keep it around.
1407 However, if an architecture's init function encounters an error
1408 building the structure, it may need to clean up a partially
1409 constructed gdbarch. */
1412 gdbarch_free (struct gdbarch *arch)
1414 struct obstack *obstack;
1415 gdb_assert (arch != NULL);
1416 gdb_assert (!arch->initialized_p);
1417 obstack = arch->obstack;
1418 obstack_free (obstack, 0); /* Includes the ARCH. */
1423 # verify a new architecture
1427 /* Ensure that all values in a GDBARCH are reasonable. */
1429 /* NOTE/WARNING: The parameter is called \`\`current_gdbarch'' so that it
1430 just happens to match the global variable \`\`current_gdbarch''. That
1431 way macros refering to that variable get the local and not the global
1432 version - ulgh. Once everything is parameterised with gdbarch, this
1436 verify_gdbarch (struct gdbarch *current_gdbarch)
1438 struct ui_file *log;
1439 struct cleanup *cleanups;
1442 log = mem_fileopen ();
1443 cleanups = make_cleanup_ui_file_delete (log);
1445 if (current_gdbarch->byte_order == BFD_ENDIAN_UNKNOWN)
1446 fprintf_unfiltered (log, "\n\tbyte-order");
1447 if (current_gdbarch->bfd_arch_info == NULL)
1448 fprintf_unfiltered (log, "\n\tbfd_arch_info");
1449 /* Check those that need to be defined for the given multi-arch level. */
1451 function_list | while do_read
1453 if class_is_function_p || class_is_variable_p
1455 if [ "x${invalid_p}" = "x0" ]
1457 printf " /* Skip verify of ${function}, invalid_p == 0 */\n"
1458 elif class_is_predicate_p
1460 printf " /* Skip verify of ${function}, has predicate */\n"
1461 # FIXME: See do_read for potential simplification
1462 elif [ -n "${invalid_p}" -a -n "${postdefault}" ]
1464 printf " if (${invalid_p})\n"
1465 printf " current_gdbarch->${function} = ${postdefault};\n"
1466 elif [ -n "${predefault}" -a -n "${postdefault}" ]
1468 printf " if (current_gdbarch->${function} == ${predefault})\n"
1469 printf " current_gdbarch->${function} = ${postdefault};\n"
1470 elif [ -n "${postdefault}" ]
1472 printf " if (current_gdbarch->${function} == 0)\n"
1473 printf " current_gdbarch->${function} = ${postdefault};\n"
1474 elif [ -n "${invalid_p}" ]
1476 printf " if (${invalid_p})\n"
1477 printf " fprintf_unfiltered (log, \"\\\\n\\\\t${function}\");\n"
1478 elif [ -n "${predefault}" ]
1480 printf " if (current_gdbarch->${function} == ${predefault})\n"
1481 printf " fprintf_unfiltered (log, \"\\\\n\\\\t${function}\");\n"
1486 buf = ui_file_xstrdup (log, &dummy);
1487 make_cleanup (xfree, buf);
1488 if (strlen (buf) > 0)
1489 internal_error (__FILE__, __LINE__,
1490 _("verify_gdbarch: the following are invalid ...%s"),
1492 do_cleanups (cleanups);
1496 # dump the structure
1500 /* Print out the details of the current architecture. */
1502 /* NOTE/WARNING: The parameter is called \`\`current_gdbarch'' so that it
1503 just happens to match the global variable \`\`current_gdbarch''. That
1504 way macros refering to that variable get the local and not the global
1505 version - ulgh. Once everything is parameterised with gdbarch, this
1509 gdbarch_dump (struct gdbarch *current_gdbarch, struct ui_file *file)
1511 const char *gdb_xm_file = "<not-defined>";
1512 const char *gdb_nm_file = "<not-defined>";
1513 const char *gdb_tm_file = "<not-defined>";
1514 #if defined (GDB_XM_FILE)
1515 gdb_xm_file = GDB_XM_FILE;
1517 fprintf_unfiltered (file,
1518 "gdbarch_dump: GDB_XM_FILE = %s\\n",
1520 #if defined (GDB_NM_FILE)
1521 gdb_nm_file = GDB_NM_FILE;
1523 fprintf_unfiltered (file,
1524 "gdbarch_dump: GDB_NM_FILE = %s\\n",
1526 #if defined (GDB_TM_FILE)
1527 gdb_tm_file = GDB_TM_FILE;
1529 fprintf_unfiltered (file,
1530 "gdbarch_dump: GDB_TM_FILE = %s\\n",
1533 function_list | sort -t: -k 4 | while do_read
1535 # First the predicate
1536 if class_is_predicate_p
1538 if test -n "${macro}"
1540 printf "#ifdef ${macro}_P\n"
1541 printf " fprintf_unfiltered (file,\n"
1542 printf " \"gdbarch_dump: %%s # %%s\\\\n\",\n"
1543 printf " \"${macro}_P()\",\n"
1544 printf " XSTRING (${macro}_P ()));\n"
1547 printf " fprintf_unfiltered (file,\n"
1548 printf " \"gdbarch_dump: gdbarch_${function}_p() = %%d\\\\n\",\n"
1549 printf " gdbarch_${function}_p (current_gdbarch));\n"
1551 # Print the macro definition.
1552 if test -n "${macro}"
1554 printf "#ifdef ${macro}\n"
1555 if class_is_function_p
1557 printf " fprintf_unfiltered (file,\n"
1558 printf " \"gdbarch_dump: %%s # %%s\\\\n\",\n"
1559 printf " \"${macro}(${actual})\",\n"
1560 printf " XSTRING (${macro} (${actual})));\n"
1562 printf " fprintf_unfiltered (file,\n"
1563 printf " \"gdbarch_dump: ${macro} # %%s\\\\n\",\n"
1564 printf " XSTRING (${macro}));\n"
1568 # Print the corresponding value.
1569 if class_is_function_p
1571 printf " fprintf_unfiltered (file,\n"
1572 printf " \"gdbarch_dump: ${function} = <0x%%lx>\\\\n\",\n"
1573 printf " (long) current_gdbarch->${function});\n"
1576 case "${print}:${returntype}" in
1579 print="paddr_nz (current_gdbarch->${function})"
1583 print="paddr_d (current_gdbarch->${function})"
1589 printf " fprintf_unfiltered (file,\n"
1590 printf " \"gdbarch_dump: ${function} = %s\\\\n\",\n" "${fmt}"
1591 printf " ${print});\n"
1595 if (current_gdbarch->dump_tdep != NULL)
1596 current_gdbarch->dump_tdep (current_gdbarch, file);
1604 struct gdbarch_tdep *
1605 gdbarch_tdep (struct gdbarch *gdbarch)
1607 if (gdbarch_debug >= 2)
1608 fprintf_unfiltered (gdb_stdlog, "gdbarch_tdep called\\n");
1609 return gdbarch->tdep;
1613 function_list | while do_read
1615 if class_is_predicate_p
1619 printf "gdbarch_${function}_p (struct gdbarch *gdbarch)\n"
1621 printf " gdb_assert (gdbarch != NULL);\n"
1622 printf " return ${predicate};\n"
1625 if class_is_function_p
1628 printf "${returntype}\n"
1629 if [ "x${formal}" = "xvoid" ]
1631 printf "gdbarch_${function} (struct gdbarch *gdbarch)\n"
1633 printf "gdbarch_${function} (struct gdbarch *gdbarch, ${formal})\n"
1636 printf " gdb_assert (gdbarch != NULL);\n"
1637 printf " gdb_assert (gdbarch->${function} != NULL);\n"
1638 if class_is_predicate_p && test -n "${predefault}"
1640 # Allow a call to a function with a predicate.
1641 printf " /* Do not check predicate: ${predicate}, allow call. */\n"
1643 printf " if (gdbarch_debug >= 2)\n"
1644 printf " fprintf_unfiltered (gdb_stdlog, \"gdbarch_${function} called\\\\n\");\n"
1645 if [ "x${actual}" = "x-" -o "x${actual}" = "x" ]
1647 if class_is_multiarch_p
1654 if class_is_multiarch_p
1656 params="gdbarch, ${actual}"
1661 if [ "x${returntype}" = "xvoid" ]
1663 printf " gdbarch->${function} (${params});\n"
1665 printf " return gdbarch->${function} (${params});\n"
1670 printf "set_gdbarch_${function} (struct gdbarch *gdbarch,\n"
1671 printf " `echo ${function} | sed -e 's/./ /g'` gdbarch_${function}_ftype ${function})\n"
1673 printf " gdbarch->${function} = ${function};\n"
1675 elif class_is_variable_p
1678 printf "${returntype}\n"
1679 printf "gdbarch_${function} (struct gdbarch *gdbarch)\n"
1681 printf " gdb_assert (gdbarch != NULL);\n"
1682 if [ "x${invalid_p}" = "x0" ]
1684 printf " /* Skip verify of ${function}, invalid_p == 0 */\n"
1685 elif [ -n "${invalid_p}" ]
1687 printf " /* Check variable is valid. */\n"
1688 printf " gdb_assert (!(${invalid_p}));\n"
1689 elif [ -n "${predefault}" ]
1691 printf " /* Check variable changed from pre-default. */\n"
1692 printf " gdb_assert (gdbarch->${function} != ${predefault});\n"
1694 printf " if (gdbarch_debug >= 2)\n"
1695 printf " fprintf_unfiltered (gdb_stdlog, \"gdbarch_${function} called\\\\n\");\n"
1696 printf " return gdbarch->${function};\n"
1700 printf "set_gdbarch_${function} (struct gdbarch *gdbarch,\n"
1701 printf " `echo ${function} | sed -e 's/./ /g'` ${returntype} ${function})\n"
1703 printf " gdbarch->${function} = ${function};\n"
1705 elif class_is_info_p
1708 printf "${returntype}\n"
1709 printf "gdbarch_${function} (struct gdbarch *gdbarch)\n"
1711 printf " gdb_assert (gdbarch != NULL);\n"
1712 printf " if (gdbarch_debug >= 2)\n"
1713 printf " fprintf_unfiltered (gdb_stdlog, \"gdbarch_${function} called\\\\n\");\n"
1714 printf " return gdbarch->${function};\n"
1719 # All the trailing guff
1723 /* Keep a registry of per-architecture data-pointers required by GDB
1730 gdbarch_data_pre_init_ftype *pre_init;
1731 gdbarch_data_post_init_ftype *post_init;
1734 struct gdbarch_data_registration
1736 struct gdbarch_data *data;
1737 struct gdbarch_data_registration *next;
1740 struct gdbarch_data_registry
1743 struct gdbarch_data_registration *registrations;
1746 struct gdbarch_data_registry gdbarch_data_registry =
1751 static struct gdbarch_data *
1752 gdbarch_data_register (gdbarch_data_pre_init_ftype *pre_init,
1753 gdbarch_data_post_init_ftype *post_init)
1755 struct gdbarch_data_registration **curr;
1756 /* Append the new registraration. */
1757 for (curr = &gdbarch_data_registry.registrations;
1759 curr = &(*curr)->next);
1760 (*curr) = XMALLOC (struct gdbarch_data_registration);
1761 (*curr)->next = NULL;
1762 (*curr)->data = XMALLOC (struct gdbarch_data);
1763 (*curr)->data->index = gdbarch_data_registry.nr++;
1764 (*curr)->data->pre_init = pre_init;
1765 (*curr)->data->post_init = post_init;
1766 (*curr)->data->init_p = 1;
1767 return (*curr)->data;
1770 struct gdbarch_data *
1771 gdbarch_data_register_pre_init (gdbarch_data_pre_init_ftype *pre_init)
1773 return gdbarch_data_register (pre_init, NULL);
1776 struct gdbarch_data *
1777 gdbarch_data_register_post_init (gdbarch_data_post_init_ftype *post_init)
1779 return gdbarch_data_register (NULL, post_init);
1782 /* Create/delete the gdbarch data vector. */
1785 alloc_gdbarch_data (struct gdbarch *gdbarch)
1787 gdb_assert (gdbarch->data == NULL);
1788 gdbarch->nr_data = gdbarch_data_registry.nr;
1789 gdbarch->data = GDBARCH_OBSTACK_CALLOC (gdbarch, gdbarch->nr_data, void *);
1792 /* Initialize the current value of the specified per-architecture
1796 deprecated_set_gdbarch_data (struct gdbarch *gdbarch,
1797 struct gdbarch_data *data,
1800 gdb_assert (data->index < gdbarch->nr_data);
1801 gdb_assert (gdbarch->data[data->index] == NULL);
1802 gdb_assert (data->pre_init == NULL);
1803 gdbarch->data[data->index] = pointer;
1806 /* Return the current value of the specified per-architecture
1810 gdbarch_data (struct gdbarch *gdbarch, struct gdbarch_data *data)
1812 gdb_assert (data->index < gdbarch->nr_data);
1813 if (gdbarch->data[data->index] == NULL)
1815 /* The data-pointer isn't initialized, call init() to get a
1817 if (data->pre_init != NULL)
1818 /* Mid architecture creation: pass just the obstack, and not
1819 the entire architecture, as that way it isn't possible for
1820 pre-init code to refer to undefined architecture
1822 gdbarch->data[data->index] = data->pre_init (gdbarch->obstack);
1823 else if (gdbarch->initialized_p
1824 && data->post_init != NULL)
1825 /* Post architecture creation: pass the entire architecture
1826 (as all fields are valid), but be careful to also detect
1827 recursive references. */
1829 gdb_assert (data->init_p);
1831 gdbarch->data[data->index] = data->post_init (gdbarch);
1835 /* The architecture initialization hasn't completed - punt -
1836 hope that the caller knows what they are doing. Once
1837 deprecated_set_gdbarch_data has been initialized, this can be
1838 changed to an internal error. */
1840 gdb_assert (gdbarch->data[data->index] != NULL);
1842 return gdbarch->data[data->index];
1847 /* Keep a registry of swapped data required by GDB modules. */
1852 struct gdbarch_swap_registration *source;
1853 struct gdbarch_swap *next;
1856 struct gdbarch_swap_registration
1859 unsigned long sizeof_data;
1860 gdbarch_swap_ftype *init;
1861 struct gdbarch_swap_registration *next;
1864 struct gdbarch_swap_registry
1867 struct gdbarch_swap_registration *registrations;
1870 struct gdbarch_swap_registry gdbarch_swap_registry =
1876 deprecated_register_gdbarch_swap (void *data,
1877 unsigned long sizeof_data,
1878 gdbarch_swap_ftype *init)
1880 struct gdbarch_swap_registration **rego;
1881 for (rego = &gdbarch_swap_registry.registrations;
1883 rego = &(*rego)->next);
1884 (*rego) = XMALLOC (struct gdbarch_swap_registration);
1885 (*rego)->next = NULL;
1886 (*rego)->init = init;
1887 (*rego)->data = data;
1888 (*rego)->sizeof_data = sizeof_data;
1892 current_gdbarch_swap_init_hack (void)
1894 struct gdbarch_swap_registration *rego;
1895 struct gdbarch_swap **curr = ¤t_gdbarch->swap;
1896 for (rego = gdbarch_swap_registry.registrations;
1900 if (rego->data != NULL)
1902 (*curr) = GDBARCH_OBSTACK_ZALLOC (current_gdbarch,
1903 struct gdbarch_swap);
1904 (*curr)->source = rego;
1905 (*curr)->swap = gdbarch_obstack_zalloc (current_gdbarch,
1907 (*curr)->next = NULL;
1908 curr = &(*curr)->next;
1910 if (rego->init != NULL)
1915 static struct gdbarch *
1916 current_gdbarch_swap_out_hack (void)
1918 struct gdbarch *old_gdbarch = current_gdbarch;
1919 struct gdbarch_swap *curr;
1921 gdb_assert (old_gdbarch != NULL);
1922 for (curr = old_gdbarch->swap;
1926 memcpy (curr->swap, curr->source->data, curr->source->sizeof_data);
1927 memset (curr->source->data, 0, curr->source->sizeof_data);
1929 current_gdbarch = NULL;
1934 current_gdbarch_swap_in_hack (struct gdbarch *new_gdbarch)
1936 struct gdbarch_swap *curr;
1938 gdb_assert (current_gdbarch == NULL);
1939 for (curr = new_gdbarch->swap;
1942 memcpy (curr->source->data, curr->swap, curr->source->sizeof_data);
1943 current_gdbarch = new_gdbarch;
1947 /* Keep a registry of the architectures known by GDB. */
1949 struct gdbarch_registration
1951 enum bfd_architecture bfd_architecture;
1952 gdbarch_init_ftype *init;
1953 gdbarch_dump_tdep_ftype *dump_tdep;
1954 struct gdbarch_list *arches;
1955 struct gdbarch_registration *next;
1958 static struct gdbarch_registration *gdbarch_registry = NULL;
1961 append_name (const char ***buf, int *nr, const char *name)
1963 *buf = xrealloc (*buf, sizeof (char**) * (*nr + 1));
1969 gdbarch_printable_names (void)
1971 /* Accumulate a list of names based on the registed list of
1973 enum bfd_architecture a;
1975 const char **arches = NULL;
1976 struct gdbarch_registration *rego;
1977 for (rego = gdbarch_registry;
1981 const struct bfd_arch_info *ap;
1982 ap = bfd_lookup_arch (rego->bfd_architecture, 0);
1984 internal_error (__FILE__, __LINE__,
1985 _("gdbarch_architecture_names: multi-arch unknown"));
1988 append_name (&arches, &nr_arches, ap->printable_name);
1993 append_name (&arches, &nr_arches, NULL);
1999 gdbarch_register (enum bfd_architecture bfd_architecture,
2000 gdbarch_init_ftype *init,
2001 gdbarch_dump_tdep_ftype *dump_tdep)
2003 struct gdbarch_registration **curr;
2004 const struct bfd_arch_info *bfd_arch_info;
2005 /* Check that BFD recognizes this architecture */
2006 bfd_arch_info = bfd_lookup_arch (bfd_architecture, 0);
2007 if (bfd_arch_info == NULL)
2009 internal_error (__FILE__, __LINE__,
2010 _("gdbarch: Attempt to register unknown architecture (%d)"),
2013 /* Check that we haven't seen this architecture before */
2014 for (curr = &gdbarch_registry;
2016 curr = &(*curr)->next)
2018 if (bfd_architecture == (*curr)->bfd_architecture)
2019 internal_error (__FILE__, __LINE__,
2020 _("gdbarch: Duplicate registraration of architecture (%s)"),
2021 bfd_arch_info->printable_name);
2025 fprintf_unfiltered (gdb_stdlog, "register_gdbarch_init (%s, 0x%08lx)\n",
2026 bfd_arch_info->printable_name,
2029 (*curr) = XMALLOC (struct gdbarch_registration);
2030 (*curr)->bfd_architecture = bfd_architecture;
2031 (*curr)->init = init;
2032 (*curr)->dump_tdep = dump_tdep;
2033 (*curr)->arches = NULL;
2034 (*curr)->next = NULL;
2038 register_gdbarch_init (enum bfd_architecture bfd_architecture,
2039 gdbarch_init_ftype *init)
2041 gdbarch_register (bfd_architecture, init, NULL);
2045 /* Look for an architecture using gdbarch_info. */
2047 struct gdbarch_list *
2048 gdbarch_list_lookup_by_info (struct gdbarch_list *arches,
2049 const struct gdbarch_info *info)
2051 for (; arches != NULL; arches = arches->next)
2053 if (info->bfd_arch_info != arches->gdbarch->bfd_arch_info)
2055 if (info->byte_order != arches->gdbarch->byte_order)
2057 if (info->osabi != arches->gdbarch->osabi)
2059 if (info->target_desc != arches->gdbarch->target_desc)
2067 /* Find an architecture that matches the specified INFO. Create a new
2068 architecture if needed. Return that new architecture. Assumes
2069 that there is no current architecture. */
2071 static struct gdbarch *
2072 find_arch_by_info (struct gdbarch_info info)
2074 struct gdbarch *new_gdbarch;
2075 struct gdbarch_registration *rego;
2077 /* The existing architecture has been swapped out - all this code
2078 works from a clean slate. */
2079 gdb_assert (current_gdbarch == NULL);
2081 /* Fill in missing parts of the INFO struct using a number of
2082 sources: "set ..."; INFOabfd supplied; and the global
2084 gdbarch_info_fill (&info);
2086 /* Must have found some sort of architecture. */
2087 gdb_assert (info.bfd_arch_info != NULL);
2091 fprintf_unfiltered (gdb_stdlog,
2092 "find_arch_by_info: info.bfd_arch_info %s\n",
2093 (info.bfd_arch_info != NULL
2094 ? info.bfd_arch_info->printable_name
2096 fprintf_unfiltered (gdb_stdlog,
2097 "find_arch_by_info: info.byte_order %d (%s)\n",
2099 (info.byte_order == BFD_ENDIAN_BIG ? "big"
2100 : info.byte_order == BFD_ENDIAN_LITTLE ? "little"
2102 fprintf_unfiltered (gdb_stdlog,
2103 "find_arch_by_info: info.osabi %d (%s)\n",
2104 info.osabi, gdbarch_osabi_name (info.osabi));
2105 fprintf_unfiltered (gdb_stdlog,
2106 "find_arch_by_info: info.abfd 0x%lx\n",
2108 fprintf_unfiltered (gdb_stdlog,
2109 "find_arch_by_info: info.tdep_info 0x%lx\n",
2110 (long) info.tdep_info);
2113 /* Find the tdep code that knows about this architecture. */
2114 for (rego = gdbarch_registry;
2117 if (rego->bfd_architecture == info.bfd_arch_info->arch)
2122 fprintf_unfiltered (gdb_stdlog, "find_arch_by_info: "
2123 "No matching architecture\n");
2127 /* Ask the tdep code for an architecture that matches "info". */
2128 new_gdbarch = rego->init (info, rego->arches);
2130 /* Did the tdep code like it? No. Reject the change and revert to
2131 the old architecture. */
2132 if (new_gdbarch == NULL)
2135 fprintf_unfiltered (gdb_stdlog, "find_arch_by_info: "
2136 "Target rejected architecture\n");
2140 /* Is this a pre-existing architecture (as determined by already
2141 being initialized)? Move it to the front of the architecture
2142 list (keeping the list sorted Most Recently Used). */
2143 if (new_gdbarch->initialized_p)
2145 struct gdbarch_list **list;
2146 struct gdbarch_list *this;
2148 fprintf_unfiltered (gdb_stdlog, "find_arch_by_info: "
2149 "Previous architecture 0x%08lx (%s) selected\n",
2151 new_gdbarch->bfd_arch_info->printable_name);
2152 /* Find the existing arch in the list. */
2153 for (list = ®o->arches;
2154 (*list) != NULL && (*list)->gdbarch != new_gdbarch;
2155 list = &(*list)->next);
2156 /* It had better be in the list of architectures. */
2157 gdb_assert ((*list) != NULL && (*list)->gdbarch == new_gdbarch);
2160 (*list) = this->next;
2161 /* Insert THIS at the front. */
2162 this->next = rego->arches;
2163 rego->arches = this;
2168 /* It's a new architecture. */
2170 fprintf_unfiltered (gdb_stdlog, "find_arch_by_info: "
2171 "New architecture 0x%08lx (%s) selected\n",
2173 new_gdbarch->bfd_arch_info->printable_name);
2175 /* Insert the new architecture into the front of the architecture
2176 list (keep the list sorted Most Recently Used). */
2178 struct gdbarch_list *this = XMALLOC (struct gdbarch_list);
2179 this->next = rego->arches;
2180 this->gdbarch = new_gdbarch;
2181 rego->arches = this;
2184 /* Check that the newly installed architecture is valid. Plug in
2185 any post init values. */
2186 new_gdbarch->dump_tdep = rego->dump_tdep;
2187 verify_gdbarch (new_gdbarch);
2188 new_gdbarch->initialized_p = 1;
2190 /* Initialize any per-architecture swap areas. This phase requires
2191 a valid global CURRENT_GDBARCH. Set it momentarially, and then
2192 swap the entire architecture out. */
2193 current_gdbarch = new_gdbarch;
2194 current_gdbarch_swap_init_hack ();
2195 current_gdbarch_swap_out_hack ();
2198 gdbarch_dump (new_gdbarch, gdb_stdlog);
2204 gdbarch_find_by_info (struct gdbarch_info info)
2206 /* Save the previously selected architecture, setting the global to
2207 NULL. This stops things like gdbarch->init() trying to use the
2208 previous architecture's configuration. The previous architecture
2209 may not even be of the same architecture family. The most recent
2210 architecture of the same family is found at the head of the
2211 rego->arches list. */
2212 struct gdbarch *old_gdbarch = current_gdbarch_swap_out_hack ();
2214 /* Find the specified architecture. */
2215 struct gdbarch *new_gdbarch = find_arch_by_info (info);
2217 /* Restore the existing architecture. */
2218 gdb_assert (current_gdbarch == NULL);
2219 current_gdbarch_swap_in_hack (old_gdbarch);
2224 /* Make the specified architecture current, swapping the existing one
2228 deprecated_current_gdbarch_select_hack (struct gdbarch *new_gdbarch)
2230 gdb_assert (new_gdbarch != NULL);
2231 gdb_assert (current_gdbarch != NULL);
2232 gdb_assert (new_gdbarch->initialized_p);
2233 current_gdbarch_swap_out_hack ();
2234 current_gdbarch_swap_in_hack (new_gdbarch);
2235 architecture_changed_event ();
2236 reinit_frame_cache ();
2239 extern void _initialize_gdbarch (void);
2242 _initialize_gdbarch (void)
2244 struct cmd_list_element *c;
2246 add_setshow_zinteger_cmd ("arch", class_maintenance, &gdbarch_debug, _("\\
2247 Set architecture debugging."), _("\\
2248 Show architecture debugging."), _("\\
2249 When non-zero, architecture debugging is enabled."),
2252 &setdebuglist, &showdebuglist);
2258 #../move-if-change new-gdbarch.c gdbarch.c
2259 compare_new gdbarch.c