1 /* Dynamic architecture support for GDB, the GNU debugger.
3 Copyright (C) 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006
4 Free Software Foundation, Inc.
6 This file is part of GDB.
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.
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.
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., 51 Franklin Street, Fifth Floor,
21 Boston, MA 02110-1301, USA. */
25 #include "arch-utils.h"
28 #include "inferior.h" /* enum CALL_DUMMY_LOCATION et.al. */
29 #include "gdb_string.h"
31 #include "gdb_assert.h"
32 #include "sim-regno.h"
35 #include "target-descriptions.h"
39 #include "floatformat.h"
41 /* Implementation of extract return value that grubs around in the
44 legacy_extract_return_value (struct type
*type
, struct regcache
*regcache
,
47 gdb_byte
*registers
= deprecated_grub_regcache_for_registers (regcache
);
48 gdb_byte
*buf
= valbuf
;
49 DEPRECATED_EXTRACT_RETURN_VALUE (type
, registers
, buf
); /* OK */
52 /* Implementation of store return value that grubs the register cache.
53 Takes a local copy of the buffer to avoid const problems. */
55 legacy_store_return_value (struct type
*type
, struct regcache
*regcache
,
58 gdb_byte
*b
= alloca (TYPE_LENGTH (type
));
59 gdb_assert (regcache
== current_regcache
);
60 memcpy (b
, buf
, TYPE_LENGTH (type
));
61 DEPRECATED_STORE_RETURN_VALUE (type
, b
);
65 always_use_struct_convention (int gcc_p
, struct type
*value_type
)
70 enum return_value_convention
71 legacy_return_value (struct gdbarch
*gdbarch
, struct type
*valtype
,
72 struct regcache
*regcache
, gdb_byte
*readbuf
,
73 const gdb_byte
*writebuf
)
75 /* NOTE: cagney/2004-06-13: The gcc_p parameter to
76 USE_STRUCT_CONVENTION isn't used. */
77 int struct_return
= ((TYPE_CODE (valtype
) == TYPE_CODE_STRUCT
78 || TYPE_CODE (valtype
) == TYPE_CODE_UNION
79 || TYPE_CODE (valtype
) == TYPE_CODE_ARRAY
)
80 && DEPRECATED_USE_STRUCT_CONVENTION (0, valtype
));
84 gdb_assert (!struct_return
);
85 /* NOTE: cagney/2004-06-13: See stack.c:return_command. Old
86 architectures don't expect STORE_RETURN_VALUE to handle small
87 structures. Should not be called with such types. */
88 gdb_assert (TYPE_CODE (valtype
) != TYPE_CODE_STRUCT
89 && TYPE_CODE (valtype
) != TYPE_CODE_UNION
);
90 STORE_RETURN_VALUE (valtype
, regcache
, writebuf
);
95 gdb_assert (!struct_return
);
96 EXTRACT_RETURN_VALUE (valtype
, regcache
, readbuf
);
100 return RETURN_VALUE_STRUCT_CONVENTION
;
102 return RETURN_VALUE_REGISTER_CONVENTION
;
106 legacy_register_sim_regno (int regnum
)
108 /* Only makes sense to supply raw registers. */
109 gdb_assert (regnum
>= 0 && regnum
< NUM_REGS
);
110 /* NOTE: cagney/2002-05-13: The old code did it this way and it is
111 suspected that some GDB/SIM combinations may rely on this
112 behavour. The default should be one2one_register_sim_regno
114 if (REGISTER_NAME (regnum
) != NULL
115 && REGISTER_NAME (regnum
)[0] != '\0')
118 return LEGACY_SIM_REGNO_IGNORE
;
122 generic_skip_trampoline_code (CORE_ADDR pc
)
128 generic_skip_solib_resolver (struct gdbarch
*gdbarch
, CORE_ADDR pc
)
134 generic_in_solib_return_trampoline (CORE_ADDR pc
, char *name
)
140 generic_in_function_epilogue_p (struct gdbarch
*gdbarch
, CORE_ADDR pc
)
146 generic_remote_translate_xfer_address (struct gdbarch
*gdbarch
,
147 struct regcache
*regcache
,
148 CORE_ADDR gdb_addr
, int gdb_len
,
149 CORE_ADDR
* rem_addr
, int *rem_len
)
151 *rem_addr
= gdb_addr
;
155 /* Helper functions for INNER_THAN */
158 core_addr_lessthan (CORE_ADDR lhs
, CORE_ADDR rhs
)
164 core_addr_greaterthan (CORE_ADDR lhs
, CORE_ADDR rhs
)
170 /* Helper functions for TARGET_{FLOAT,DOUBLE}_FORMAT */
172 const struct floatformat
*
173 default_float_format (struct gdbarch
*gdbarch
)
175 int byte_order
= gdbarch_byte_order (gdbarch
);
179 return &floatformat_ieee_single_big
;
180 case BFD_ENDIAN_LITTLE
:
181 return &floatformat_ieee_single_little
;
183 internal_error (__FILE__
, __LINE__
,
184 _("default_float_format: bad byte order"));
189 const struct floatformat
*
190 default_double_format (struct gdbarch
*gdbarch
)
192 int byte_order
= gdbarch_byte_order (gdbarch
);
196 return &floatformat_ieee_double_big
;
197 case BFD_ENDIAN_LITTLE
:
198 return &floatformat_ieee_double_little
;
200 internal_error (__FILE__
, __LINE__
,
201 _("default_double_format: bad byte order"));
205 /* Misc helper functions for targets. */
208 core_addr_identity (CORE_ADDR addr
)
214 convert_from_func_ptr_addr_identity (struct gdbarch
*gdbarch
, CORE_ADDR addr
,
215 struct target_ops
*targ
)
221 no_op_reg_to_regnum (int reg
)
227 default_elf_make_msymbol_special (asymbol
*sym
, struct minimal_symbol
*msym
)
233 default_coff_make_msymbol_special (int val
, struct minimal_symbol
*msym
)
239 cannot_register_not (int regnum
)
244 /* Legacy version of target_virtual_frame_pointer(). Assumes that
245 there is an DEPRECATED_FP_REGNUM and that it is the same, cooked or
249 legacy_virtual_frame_pointer (CORE_ADDR pc
,
251 LONGEST
*frame_offset
)
253 /* FIXME: cagney/2002-09-13: This code is used when identifying the
254 frame pointer of the current PC. It is assuming that a single
255 register and an offset can determine this. I think it should
256 instead generate a byte code expression as that would work better
257 with things like Dwarf2's CFI. */
258 if (DEPRECATED_FP_REGNUM
>= 0 && DEPRECATED_FP_REGNUM
< NUM_REGS
)
259 *frame_regnum
= DEPRECATED_FP_REGNUM
;
260 else if (SP_REGNUM
>= 0 && SP_REGNUM
< NUM_REGS
)
261 *frame_regnum
= SP_REGNUM
;
263 /* Should this be an internal error? I guess so, it is reflecting
264 an architectural limitation in the current design. */
265 internal_error (__FILE__
, __LINE__
, _("No virtual frame pointer available"));
269 /* Assume the world is sane, every register's virtual and real size
273 generic_register_size (int regnum
)
275 gdb_assert (regnum
>= 0 && regnum
< NUM_REGS
+ NUM_PSEUDO_REGS
);
276 return TYPE_LENGTH (gdbarch_register_type (current_gdbarch
, regnum
));
279 /* Assume all registers are adjacent. */
282 generic_register_byte (int regnum
)
286 gdb_assert (regnum
>= 0 && regnum
< NUM_REGS
+ NUM_PSEUDO_REGS
);
288 for (i
= 0; i
< regnum
; i
++)
290 byte
+= generic_register_size (i
);
297 legacy_pc_in_sigtramp (CORE_ADDR pc
, char *name
)
299 #if defined (DEPRECATED_IN_SIGTRAMP)
300 return DEPRECATED_IN_SIGTRAMP (pc
, name
);
302 return name
&& strcmp ("_sigtramp", name
) == 0;
307 generic_convert_register_p (int regnum
, struct type
*type
)
313 default_stabs_argument_has_addr (struct gdbarch
*gdbarch
, struct type
*type
)
315 if (DEPRECATED_REG_STRUCT_HAS_ADDR_P ()
316 && DEPRECATED_REG_STRUCT_HAS_ADDR (processing_gcc_compilation
, type
))
318 CHECK_TYPEDEF (type
);
320 return (TYPE_CODE (type
) == TYPE_CODE_STRUCT
321 || TYPE_CODE (type
) == TYPE_CODE_UNION
322 || TYPE_CODE (type
) == TYPE_CODE_SET
323 || TYPE_CODE (type
) == TYPE_CODE_BITSTRING
);
330 generic_instruction_nullified (struct gdbarch
*gdbarch
,
331 struct regcache
*regcache
)
337 /* Functions to manipulate the endianness of the target. */
339 static int target_byte_order_user
= BFD_ENDIAN_UNKNOWN
;
341 static const char endian_big
[] = "big";
342 static const char endian_little
[] = "little";
343 static const char endian_auto
[] = "auto";
344 static const char *endian_enum
[] =
351 static const char *set_endian_string
;
353 /* Called by ``show endian''. */
356 show_endian (struct ui_file
*file
, int from_tty
, struct cmd_list_element
*c
,
359 if (target_byte_order_user
!= BFD_ENDIAN_UNKNOWN
)
360 if (TARGET_BYTE_ORDER
== BFD_ENDIAN_BIG
)
361 fprintf_unfiltered (file
, _("The target endianness is set automatically "
362 "(currently big endian)\n"));
364 fprintf_unfiltered (file
, _("The target endianness is set automatically "
365 "(currently little endian)\n"));
367 if (TARGET_BYTE_ORDER
== BFD_ENDIAN_BIG
)
368 fprintf_unfiltered (file
,
369 _("The target is assumed to be big endian\n"));
371 fprintf_unfiltered (file
,
372 _("The target is assumed to be little endian\n"));
376 set_endian (char *ignore_args
, int from_tty
, struct cmd_list_element
*c
)
378 struct gdbarch_info info
;
380 gdbarch_info_init (&info
);
382 if (set_endian_string
== endian_auto
)
384 target_byte_order_user
= BFD_ENDIAN_UNKNOWN
;
385 if (! gdbarch_update_p (info
))
386 internal_error (__FILE__
, __LINE__
,
387 _("set_endian: architecture update failed"));
389 else if (set_endian_string
== endian_little
)
391 info
.byte_order
= BFD_ENDIAN_LITTLE
;
392 if (! gdbarch_update_p (info
))
393 printf_unfiltered (_("Little endian target not supported by GDB\n"));
395 target_byte_order_user
= BFD_ENDIAN_LITTLE
;
397 else if (set_endian_string
== endian_big
)
399 info
.byte_order
= BFD_ENDIAN_BIG
;
400 if (! gdbarch_update_p (info
))
401 printf_unfiltered (_("Big endian target not supported by GDB\n"));
403 target_byte_order_user
= BFD_ENDIAN_BIG
;
406 internal_error (__FILE__
, __LINE__
,
407 _("set_endian: bad value"));
409 show_endian (gdb_stdout
, from_tty
, NULL
, NULL
);
412 /* Functions to manipulate the architecture of the target */
414 enum set_arch
{ set_arch_auto
, set_arch_manual
};
416 static const struct bfd_arch_info
*target_architecture_user
;
418 static const char *set_architecture_string
;
421 selected_architecture_name (void)
423 if (target_architecture_user
== NULL
)
426 return set_architecture_string
;
429 /* Called if the user enters ``show architecture'' without an
433 show_architecture (struct ui_file
*file
, int from_tty
,
434 struct cmd_list_element
*c
, const char *value
)
437 arch
= TARGET_ARCHITECTURE
->printable_name
;
438 if (target_architecture_user
== NULL
)
439 fprintf_filtered (file
, _("\
440 The target architecture is set automatically (currently %s)\n"), arch
);
442 fprintf_filtered (file
, _("\
443 The target architecture is assumed to be %s\n"), arch
);
447 /* Called if the user enters ``set architecture'' with or without an
451 set_architecture (char *ignore_args
, int from_tty
, struct cmd_list_element
*c
)
453 struct gdbarch_info info
;
455 gdbarch_info_init (&info
);
457 if (strcmp (set_architecture_string
, "auto") == 0)
459 target_architecture_user
= NULL
;
460 if (!gdbarch_update_p (info
))
461 internal_error (__FILE__
, __LINE__
,
462 _("could not select an architecture automatically"));
466 info
.bfd_arch_info
= bfd_scan_arch (set_architecture_string
);
467 if (info
.bfd_arch_info
== NULL
)
468 internal_error (__FILE__
, __LINE__
,
469 _("set_architecture: bfd_scan_arch failed"));
470 if (gdbarch_update_p (info
))
471 target_architecture_user
= info
.bfd_arch_info
;
473 printf_unfiltered (_("Architecture `%s' not recognized.\n"),
474 set_architecture_string
);
476 show_architecture (gdb_stdout
, from_tty
, NULL
, NULL
);
479 /* Try to select a global architecture that matches "info". Return
480 non-zero if the attempt succeds. */
482 gdbarch_update_p (struct gdbarch_info info
)
484 struct gdbarch
*new_gdbarch
= gdbarch_find_by_info (info
);
486 /* If there no architecture by that name, reject the request. */
487 if (new_gdbarch
== NULL
)
490 fprintf_unfiltered (gdb_stdlog
, "gdbarch_update_p: "
491 "Architecture not found\n");
495 /* If it is the same old architecture, accept the request (but don't
497 if (new_gdbarch
== current_gdbarch
)
500 fprintf_unfiltered (gdb_stdlog
, "gdbarch_update_p: "
501 "Architecture 0x%08lx (%s) unchanged\n",
503 gdbarch_bfd_arch_info (new_gdbarch
)->printable_name
);
507 /* It's a new architecture, swap it in. */
509 fprintf_unfiltered (gdb_stdlog
, "gdbarch_update_p: "
510 "New architecture 0x%08lx (%s) selected\n",
512 gdbarch_bfd_arch_info (new_gdbarch
)->printable_name
);
513 deprecated_current_gdbarch_select_hack (new_gdbarch
);
518 /* Return the architecture for ABFD. If no suitable architecture
519 could be find, return NULL. */
522 gdbarch_from_bfd (bfd
*abfd
)
524 struct gdbarch
*old_gdbarch
= current_gdbarch
;
525 struct gdbarch
*new_gdbarch
;
526 struct gdbarch_info info
;
528 /* If we call gdbarch_find_by_info without filling in info.abfd,
529 then it will use the global exec_bfd. That's fine if we don't
530 have one of those either. And that's the only time we should
531 reach here with a NULL ABFD argument - when we are discarding
533 gdb_assert (abfd
!= NULL
|| exec_bfd
== NULL
);
535 gdbarch_info_init (&info
);
537 return gdbarch_find_by_info (info
);
540 /* Set the dynamic target-system-dependent parameters (architecture,
541 byte-order) using information found in the BFD */
544 set_gdbarch_from_file (bfd
*abfd
)
546 struct gdbarch
*gdbarch
;
548 gdbarch
= gdbarch_from_bfd (abfd
);
550 error (_("Architecture of file not recognized."));
551 deprecated_current_gdbarch_select_hack (gdbarch
);
554 /* Initialize the current architecture. Update the ``set
555 architecture'' command so that it specifies a list of valid
558 #ifdef DEFAULT_BFD_ARCH
559 extern const bfd_arch_info_type DEFAULT_BFD_ARCH
;
560 static const bfd_arch_info_type
*default_bfd_arch
= &DEFAULT_BFD_ARCH
;
562 static const bfd_arch_info_type
*default_bfd_arch
;
565 #ifdef DEFAULT_BFD_VEC
566 extern const bfd_target DEFAULT_BFD_VEC
;
567 static const bfd_target
*default_bfd_vec
= &DEFAULT_BFD_VEC
;
569 static const bfd_target
*default_bfd_vec
;
572 static int default_byte_order
= BFD_ENDIAN_UNKNOWN
;
575 initialize_current_architecture (void)
577 const char **arches
= gdbarch_printable_names ();
579 /* determine a default architecture and byte order. */
580 struct gdbarch_info info
;
581 gdbarch_info_init (&info
);
583 /* Find a default architecture. */
584 if (default_bfd_arch
== NULL
)
586 /* Choose the architecture by taking the first one
588 const char *chosen
= arches
[0];
590 for (arch
= arches
; *arch
!= NULL
; arch
++)
592 if (strcmp (*arch
, chosen
) < 0)
596 internal_error (__FILE__
, __LINE__
,
597 _("initialize_current_architecture: No arch"));
598 default_bfd_arch
= bfd_scan_arch (chosen
);
599 if (default_bfd_arch
== NULL
)
600 internal_error (__FILE__
, __LINE__
,
601 _("initialize_current_architecture: Arch not found"));
604 info
.bfd_arch_info
= default_bfd_arch
;
606 /* Take several guesses at a byte order. */
607 if (default_byte_order
== BFD_ENDIAN_UNKNOWN
608 && default_bfd_vec
!= NULL
)
610 /* Extract BFD's default vector's byte order. */
611 switch (default_bfd_vec
->byteorder
)
614 default_byte_order
= BFD_ENDIAN_BIG
;
616 case BFD_ENDIAN_LITTLE
:
617 default_byte_order
= BFD_ENDIAN_LITTLE
;
623 if (default_byte_order
== BFD_ENDIAN_UNKNOWN
)
625 /* look for ``*el-*'' in the target name. */
627 chp
= strchr (target_name
, '-');
629 && chp
- 2 >= target_name
630 && strncmp (chp
- 2, "el", 2) == 0)
631 default_byte_order
= BFD_ENDIAN_LITTLE
;
633 if (default_byte_order
== BFD_ENDIAN_UNKNOWN
)
635 /* Wire it to big-endian!!! */
636 default_byte_order
= BFD_ENDIAN_BIG
;
639 info
.byte_order
= default_byte_order
;
641 if (! gdbarch_update_p (info
))
642 internal_error (__FILE__
, __LINE__
,
643 _("initialize_current_architecture: Selection of "
644 "initial architecture failed"));
646 /* Create the ``set architecture'' command appending ``auto'' to the
647 list of architectures. */
649 struct cmd_list_element
*c
;
650 /* Append ``auto''. */
652 for (nr
= 0; arches
[nr
] != NULL
; nr
++);
653 arches
= xrealloc (arches
, sizeof (char*) * (nr
+ 2));
654 arches
[nr
+ 0] = "auto";
655 arches
[nr
+ 1] = NULL
;
656 add_setshow_enum_cmd ("architecture", class_support
,
657 arches
, &set_architecture_string
, _("\
658 Set architecture of target."), _("\
659 Show architecture of target."), NULL
,
660 set_architecture
, show_architecture
,
661 &setlist
, &showlist
);
662 add_alias_cmd ("processor", "architecture", class_support
, 1, &setlist
);
667 /* Initialize a gdbarch info to values that will be automatically
668 overridden. Note: Originally, this ``struct info'' was initialized
669 using memset(0). Unfortunately, that ran into problems, namely
670 BFD_ENDIAN_BIG is zero. An explicit initialization function that
671 can explicitly set each field to a well defined value is used. */
674 gdbarch_info_init (struct gdbarch_info
*info
)
676 memset (info
, 0, sizeof (struct gdbarch_info
));
677 info
->byte_order
= BFD_ENDIAN_UNKNOWN
;
678 info
->osabi
= GDB_OSABI_UNINITIALIZED
;
681 /* Similar to init, but this time fill in the blanks. Information is
682 obtained from the global "set ..." options and explicitly
683 initialized INFO fields. */
686 gdbarch_info_fill (struct gdbarch_info
*info
)
688 /* Check for the current file. */
689 if (info
->abfd
== NULL
)
690 info
->abfd
= exec_bfd
;
692 /* Check for the current target description. */
693 if (info
->target_desc
== NULL
)
694 info
->target_desc
= target_current_description ();
696 /* "(gdb) set architecture ...". */
697 if (info
->bfd_arch_info
== NULL
698 && target_architecture_user
)
699 info
->bfd_arch_info
= target_architecture_user
;
701 if (info
->bfd_arch_info
== NULL
702 && info
->abfd
!= NULL
703 && bfd_get_arch (info
->abfd
) != bfd_arch_unknown
704 && bfd_get_arch (info
->abfd
) != bfd_arch_obscure
)
705 info
->bfd_arch_info
= bfd_get_arch_info (info
->abfd
);
706 /* From the default. */
707 if (info
->bfd_arch_info
== NULL
)
708 info
->bfd_arch_info
= default_bfd_arch
;
710 /* "(gdb) set byte-order ...". */
711 if (info
->byte_order
== BFD_ENDIAN_UNKNOWN
712 && target_byte_order_user
!= BFD_ENDIAN_UNKNOWN
)
713 info
->byte_order
= target_byte_order_user
;
714 /* From the INFO struct. */
715 if (info
->byte_order
== BFD_ENDIAN_UNKNOWN
716 && info
->abfd
!= NULL
)
717 info
->byte_order
= (bfd_big_endian (info
->abfd
) ? BFD_ENDIAN_BIG
718 : bfd_little_endian (info
->abfd
) ? BFD_ENDIAN_LITTLE
719 : BFD_ENDIAN_UNKNOWN
);
720 /* From the default. */
721 if (info
->byte_order
== BFD_ENDIAN_UNKNOWN
)
722 info
->byte_order
= default_byte_order
;
724 /* "(gdb) set osabi ...". Handled by gdbarch_lookup_osabi. */
725 if (info
->osabi
== GDB_OSABI_UNINITIALIZED
)
726 info
->osabi
= gdbarch_lookup_osabi (info
->abfd
);
728 /* Must have at least filled in the architecture. */
729 gdb_assert (info
->bfd_arch_info
!= NULL
);
734 extern initialize_file_ftype _initialize_gdbarch_utils
; /* -Wmissing-prototypes */
737 _initialize_gdbarch_utils (void)
739 struct cmd_list_element
*c
;
740 add_setshow_enum_cmd ("endian", class_support
,
741 endian_enum
, &set_endian_string
, _("\
742 Set endianness of target."), _("\
743 Show endianness of target."), NULL
,
744 set_endian
, show_endian
,
745 &setlist
, &showlist
);