1 /* Dynamic architecture support for GDB, the GNU debugger.
3 Copyright (C) 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005
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"
38 #include "floatformat.h"
40 /* Implementation of extract return value that grubs around in the
43 legacy_extract_return_value (struct type *type, struct regcache *regcache,
46 gdb_byte *registers = deprecated_grub_regcache_for_registers (regcache);
47 gdb_byte *buf = valbuf;
48 DEPRECATED_EXTRACT_RETURN_VALUE (type, registers, buf); /* OK */
51 /* Implementation of store return value that grubs the register cache.
52 Takes a local copy of the buffer to avoid const problems. */
54 legacy_store_return_value (struct type *type, struct regcache *regcache,
57 gdb_byte *b = alloca (TYPE_LENGTH (type));
58 gdb_assert (regcache == current_regcache);
59 memcpy (b, buf, TYPE_LENGTH (type));
60 DEPRECATED_STORE_RETURN_VALUE (type, b);
64 always_use_struct_convention (int gcc_p, struct type *value_type)
69 enum return_value_convention
70 legacy_return_value (struct gdbarch *gdbarch, struct type *valtype,
71 struct regcache *regcache, gdb_byte *readbuf,
72 const gdb_byte *writebuf)
74 /* NOTE: cagney/2004-06-13: The gcc_p parameter to
75 USE_STRUCT_CONVENTION isn't used. */
76 int struct_return = ((TYPE_CODE (valtype) == TYPE_CODE_STRUCT
77 || TYPE_CODE (valtype) == TYPE_CODE_UNION
78 || TYPE_CODE (valtype) == TYPE_CODE_ARRAY)
79 && DEPRECATED_USE_STRUCT_CONVENTION (0, valtype));
83 gdb_assert (!struct_return);
84 /* NOTE: cagney/2004-06-13: See stack.c:return_command. Old
85 architectures don't expect STORE_RETURN_VALUE to handle small
86 structures. Should not be called with such types. */
87 gdb_assert (TYPE_CODE (valtype) != TYPE_CODE_STRUCT
88 && TYPE_CODE (valtype) != TYPE_CODE_UNION);
89 STORE_RETURN_VALUE (valtype, regcache, writebuf);
94 gdb_assert (!struct_return);
95 EXTRACT_RETURN_VALUE (valtype, regcache, readbuf);
99 return RETURN_VALUE_STRUCT_CONVENTION;
101 return RETURN_VALUE_REGISTER_CONVENTION;
105 legacy_register_sim_regno (int regnum)
107 /* Only makes sense to supply raw registers. */
108 gdb_assert (regnum >= 0 && regnum < NUM_REGS);
109 /* NOTE: cagney/2002-05-13: The old code did it this way and it is
110 suspected that some GDB/SIM combinations may rely on this
111 behavour. The default should be one2one_register_sim_regno
113 if (REGISTER_NAME (regnum) != NULL
114 && REGISTER_NAME (regnum)[0] != '\0')
117 return LEGACY_SIM_REGNO_IGNORE;
121 generic_skip_trampoline_code (CORE_ADDR pc)
127 generic_skip_solib_resolver (struct gdbarch *gdbarch, CORE_ADDR pc)
133 generic_in_solib_return_trampoline (CORE_ADDR pc, char *name)
139 generic_in_function_epilogue_p (struct gdbarch *gdbarch, CORE_ADDR pc)
145 generic_remote_translate_xfer_address (struct gdbarch *gdbarch,
146 struct regcache *regcache,
147 CORE_ADDR gdb_addr, int gdb_len,
148 CORE_ADDR * rem_addr, int *rem_len)
150 *rem_addr = gdb_addr;
154 /* Helper functions for INNER_THAN */
157 core_addr_lessthan (CORE_ADDR lhs, CORE_ADDR rhs)
163 core_addr_greaterthan (CORE_ADDR lhs, CORE_ADDR rhs)
169 /* Helper functions for TARGET_{FLOAT,DOUBLE}_FORMAT */
171 const struct floatformat *
172 default_float_format (struct gdbarch *gdbarch)
174 int byte_order = gdbarch_byte_order (gdbarch);
178 return &floatformat_ieee_single_big;
179 case BFD_ENDIAN_LITTLE:
180 return &floatformat_ieee_single_little;
182 internal_error (__FILE__, __LINE__,
183 _("default_float_format: bad byte order"));
188 const struct floatformat *
189 default_double_format (struct gdbarch *gdbarch)
191 int byte_order = gdbarch_byte_order (gdbarch);
195 return &floatformat_ieee_double_big;
196 case BFD_ENDIAN_LITTLE:
197 return &floatformat_ieee_double_little;
199 internal_error (__FILE__, __LINE__,
200 _("default_double_format: bad byte order"));
204 /* Misc helper functions for targets. */
207 core_addr_identity (CORE_ADDR addr)
213 convert_from_func_ptr_addr_identity (struct gdbarch *gdbarch, CORE_ADDR addr,
214 struct target_ops *targ)
220 no_op_reg_to_regnum (int reg)
226 default_elf_make_msymbol_special (asymbol *sym, struct minimal_symbol *msym)
232 default_coff_make_msymbol_special (int val, struct minimal_symbol *msym)
238 cannot_register_not (int regnum)
243 /* Legacy version of target_virtual_frame_pointer(). Assumes that
244 there is an DEPRECATED_FP_REGNUM and that it is the same, cooked or
248 legacy_virtual_frame_pointer (CORE_ADDR pc,
250 LONGEST *frame_offset)
252 /* FIXME: cagney/2002-09-13: This code is used when identifying the
253 frame pointer of the current PC. It is assuming that a single
254 register and an offset can determine this. I think it should
255 instead generate a byte code expression as that would work better
256 with things like Dwarf2's CFI. */
257 if (DEPRECATED_FP_REGNUM >= 0 && DEPRECATED_FP_REGNUM < NUM_REGS)
258 *frame_regnum = DEPRECATED_FP_REGNUM;
259 else if (SP_REGNUM >= 0 && SP_REGNUM < NUM_REGS)
260 *frame_regnum = SP_REGNUM;
262 /* Should this be an internal error? I guess so, it is reflecting
263 an architectural limitation in the current design. */
264 internal_error (__FILE__, __LINE__, _("No virtual frame pointer available"));
268 /* Assume the world is sane, every register's virtual and real size
272 generic_register_size (int regnum)
274 gdb_assert (regnum >= 0 && regnum < NUM_REGS + NUM_PSEUDO_REGS);
275 return TYPE_LENGTH (gdbarch_register_type (current_gdbarch, regnum));
278 /* Assume all registers are adjacent. */
281 generic_register_byte (int regnum)
285 gdb_assert (regnum >= 0 && regnum < NUM_REGS + NUM_PSEUDO_REGS);
287 for (i = 0; i < regnum; i++)
289 byte += generic_register_size (i);
296 legacy_pc_in_sigtramp (CORE_ADDR pc, char *name)
298 #if defined (DEPRECATED_IN_SIGTRAMP)
299 return DEPRECATED_IN_SIGTRAMP (pc, name);
301 return name && strcmp ("_sigtramp", name) == 0;
306 generic_convert_register_p (int regnum, struct type *type)
312 default_stabs_argument_has_addr (struct gdbarch *gdbarch, struct type *type)
314 if (DEPRECATED_REG_STRUCT_HAS_ADDR_P ()
315 && DEPRECATED_REG_STRUCT_HAS_ADDR (processing_gcc_compilation, type))
317 CHECK_TYPEDEF (type);
319 return (TYPE_CODE (type) == TYPE_CODE_STRUCT
320 || TYPE_CODE (type) == TYPE_CODE_UNION
321 || TYPE_CODE (type) == TYPE_CODE_SET
322 || TYPE_CODE (type) == TYPE_CODE_BITSTRING);
329 generic_instruction_nullified (struct gdbarch *gdbarch,
330 struct regcache *regcache)
336 /* Functions to manipulate the endianness of the target. */
338 static int target_byte_order_user = BFD_ENDIAN_UNKNOWN;
340 static const char endian_big[] = "big";
341 static const char endian_little[] = "little";
342 static const char endian_auto[] = "auto";
343 static const char *endian_enum[] =
350 static const char *set_endian_string;
352 /* Called by ``show endian''. */
355 show_endian (struct ui_file *file, int from_tty, struct cmd_list_element *c,
358 if (target_byte_order_user != BFD_ENDIAN_UNKNOWN)
359 if (TARGET_BYTE_ORDER == BFD_ENDIAN_BIG)
360 fprintf_unfiltered (file, _("The target endianness is set automatically "
361 "(currently big endian)\n"));
363 fprintf_unfiltered (file, _("The target endianness is set automatically "
364 "(currently little endian)\n"));
366 if (TARGET_BYTE_ORDER == BFD_ENDIAN_BIG)
367 fprintf_unfiltered (file,
368 _("The target is assumed to be big endian\n"));
370 fprintf_unfiltered (file,
371 _("The target is assumed to be little endian\n"));
375 set_endian (char *ignore_args, int from_tty, struct cmd_list_element *c)
377 struct gdbarch_info info;
379 gdbarch_info_init (&info);
381 if (set_endian_string == endian_auto)
383 target_byte_order_user = BFD_ENDIAN_UNKNOWN;
384 if (! gdbarch_update_p (info))
385 internal_error (__FILE__, __LINE__,
386 _("set_endian: architecture update failed"));
388 else if (set_endian_string == endian_little)
390 info.byte_order = BFD_ENDIAN_LITTLE;
391 if (! gdbarch_update_p (info))
392 printf_unfiltered (_("Little endian target not supported by GDB\n"));
394 target_byte_order_user = BFD_ENDIAN_LITTLE;
396 else if (set_endian_string == endian_big)
398 info.byte_order = BFD_ENDIAN_BIG;
399 if (! gdbarch_update_p (info))
400 printf_unfiltered (_("Big endian target not supported by GDB\n"));
402 target_byte_order_user = BFD_ENDIAN_BIG;
405 internal_error (__FILE__, __LINE__,
406 _("set_endian: bad value"));
408 show_endian (gdb_stdout, from_tty, NULL, NULL);
411 /* Functions to manipulate the architecture of the target */
413 enum set_arch { set_arch_auto, set_arch_manual };
415 static const struct bfd_arch_info *target_architecture_user;
417 static const char *set_architecture_string;
420 selected_architecture_name (void)
422 if (target_architecture_user == NULL)
425 return set_architecture_string;
428 /* Called if the user enters ``show architecture'' without an
432 show_architecture (struct ui_file *file, int from_tty,
433 struct cmd_list_element *c, const char *value)
436 arch = TARGET_ARCHITECTURE->printable_name;
437 if (target_architecture_user == NULL)
438 fprintf_filtered (file, _("\
439 The target architecture is set automatically (currently %s)\n"), arch);
441 fprintf_filtered (file, _("\
442 The target architecture is assumed to be %s\n"), arch);
446 /* Called if the user enters ``set architecture'' with or without an
450 set_architecture (char *ignore_args, int from_tty, struct cmd_list_element *c)
452 struct gdbarch_info info;
454 gdbarch_info_init (&info);
456 if (strcmp (set_architecture_string, "auto") == 0)
458 target_architecture_user = NULL;
459 if (!gdbarch_update_p (info))
460 internal_error (__FILE__, __LINE__,
461 _("could not select an architecture automatically"));
465 info.bfd_arch_info = bfd_scan_arch (set_architecture_string);
466 if (info.bfd_arch_info == NULL)
467 internal_error (__FILE__, __LINE__,
468 _("set_architecture: bfd_scan_arch failed"));
469 if (gdbarch_update_p (info))
470 target_architecture_user = info.bfd_arch_info;
472 printf_unfiltered (_("Architecture `%s' not recognized.\n"),
473 set_architecture_string);
475 show_architecture (gdb_stdout, from_tty, NULL, NULL);
478 /* Try to select a global architecture that matches "info". Return
479 non-zero if the attempt succeds. */
481 gdbarch_update_p (struct gdbarch_info info)
483 struct gdbarch *new_gdbarch = gdbarch_find_by_info (info);
485 /* If there no architecture by that name, reject the request. */
486 if (new_gdbarch == NULL)
489 fprintf_unfiltered (gdb_stdlog, "gdbarch_update_p: "
490 "Architecture not found\n");
494 /* If it is the same old architecture, accept the request (but don't
496 if (new_gdbarch == current_gdbarch)
499 fprintf_unfiltered (gdb_stdlog, "gdbarch_update_p: "
500 "Architecture 0x%08lx (%s) unchanged\n",
502 gdbarch_bfd_arch_info (new_gdbarch)->printable_name);
506 /* It's a new architecture, swap it in. */
508 fprintf_unfiltered (gdb_stdlog, "gdbarch_update_p: "
509 "New architecture 0x%08lx (%s) selected\n",
511 gdbarch_bfd_arch_info (new_gdbarch)->printable_name);
512 deprecated_current_gdbarch_select_hack (new_gdbarch);
517 /* Return the architecture for ABFD. If no suitable architecture
518 could be find, return NULL. */
521 gdbarch_from_bfd (bfd *abfd)
523 struct gdbarch *old_gdbarch = current_gdbarch;
524 struct gdbarch *new_gdbarch;
525 struct gdbarch_info info;
527 /* If we call gdbarch_find_by_info without filling in info.abfd,
528 then it will use the global exec_bfd. That's fine if we don't
529 have one of those either. And that's the only time we should
530 reach here with a NULL ABFD argument - when we are discarding
532 gdb_assert (abfd != NULL || exec_bfd == NULL);
534 gdbarch_info_init (&info);
536 return gdbarch_find_by_info (info);
539 /* Set the dynamic target-system-dependent parameters (architecture,
540 byte-order) using information found in the BFD */
543 set_gdbarch_from_file (bfd *abfd)
545 struct gdbarch *gdbarch;
547 gdbarch = gdbarch_from_bfd (abfd);
549 error (_("Architecture of file not recognized."));
550 deprecated_current_gdbarch_select_hack (gdbarch);
553 /* Initialize the current architecture. Update the ``set
554 architecture'' command so that it specifies a list of valid
557 #ifdef DEFAULT_BFD_ARCH
558 extern const bfd_arch_info_type DEFAULT_BFD_ARCH;
559 static const bfd_arch_info_type *default_bfd_arch = &DEFAULT_BFD_ARCH;
561 static const bfd_arch_info_type *default_bfd_arch;
564 #ifdef DEFAULT_BFD_VEC
565 extern const bfd_target DEFAULT_BFD_VEC;
566 static const bfd_target *default_bfd_vec = &DEFAULT_BFD_VEC;
568 static const bfd_target *default_bfd_vec;
571 static int default_byte_order = BFD_ENDIAN_UNKNOWN;
574 initialize_current_architecture (void)
576 const char **arches = gdbarch_printable_names ();
578 /* determine a default architecture and byte order. */
579 struct gdbarch_info info;
580 gdbarch_info_init (&info);
582 /* Find a default architecture. */
583 if (default_bfd_arch == NULL)
585 /* Choose the architecture by taking the first one
587 const char *chosen = arches[0];
589 for (arch = arches; *arch != NULL; arch++)
591 if (strcmp (*arch, chosen) < 0)
595 internal_error (__FILE__, __LINE__,
596 _("initialize_current_architecture: No arch"));
597 default_bfd_arch = bfd_scan_arch (chosen);
598 if (default_bfd_arch == NULL)
599 internal_error (__FILE__, __LINE__,
600 _("initialize_current_architecture: Arch not found"));
603 info.bfd_arch_info = default_bfd_arch;
605 /* Take several guesses at a byte order. */
606 if (default_byte_order == BFD_ENDIAN_UNKNOWN
607 && default_bfd_vec != NULL)
609 /* Extract BFD's default vector's byte order. */
610 switch (default_bfd_vec->byteorder)
613 default_byte_order = BFD_ENDIAN_BIG;
615 case BFD_ENDIAN_LITTLE:
616 default_byte_order = BFD_ENDIAN_LITTLE;
622 if (default_byte_order == BFD_ENDIAN_UNKNOWN)
624 /* look for ``*el-*'' in the target name. */
626 chp = strchr (target_name, '-');
628 && chp - 2 >= target_name
629 && strncmp (chp - 2, "el", 2) == 0)
630 default_byte_order = BFD_ENDIAN_LITTLE;
632 if (default_byte_order == BFD_ENDIAN_UNKNOWN)
634 /* Wire it to big-endian!!! */
635 default_byte_order = BFD_ENDIAN_BIG;
638 info.byte_order = default_byte_order;
640 if (! gdbarch_update_p (info))
641 internal_error (__FILE__, __LINE__,
642 _("initialize_current_architecture: Selection of "
643 "initial architecture failed"));
645 /* Create the ``set architecture'' command appending ``auto'' to the
646 list of architectures. */
648 struct cmd_list_element *c;
649 /* Append ``auto''. */
651 for (nr = 0; arches[nr] != NULL; nr++);
652 arches = xrealloc (arches, sizeof (char*) * (nr + 2));
653 arches[nr + 0] = "auto";
654 arches[nr + 1] = NULL;
655 add_setshow_enum_cmd ("architecture", class_support,
656 arches, &set_architecture_string, _("\
657 Set architecture of target."), _("\
658 Show architecture of target."), NULL,
659 set_architecture, show_architecture,
660 &setlist, &showlist);
661 add_alias_cmd ("processor", "architecture", class_support, 1, &setlist);
666 /* Initialize a gdbarch info to values that will be automatically
667 overridden. Note: Originally, this ``struct info'' was initialized
668 using memset(0). Unfortunately, that ran into problems, namely
669 BFD_ENDIAN_BIG is zero. An explicit initialization function that
670 can explicitly set each field to a well defined value is used. */
673 gdbarch_info_init (struct gdbarch_info *info)
675 memset (info, 0, sizeof (struct gdbarch_info));
676 info->byte_order = BFD_ENDIAN_UNKNOWN;
677 info->osabi = GDB_OSABI_UNINITIALIZED;
680 /* Similar to init, but this time fill in the blanks. Information is
681 obtained from the global "set ..." options and explicitly
682 initialized INFO fields. */
685 gdbarch_info_fill (struct gdbarch_info *info)
687 /* Check for the current file. */
688 if (info->abfd == NULL)
689 info->abfd = exec_bfd;
691 /* "(gdb) set architecture ...". */
692 if (info->bfd_arch_info == NULL
693 && target_architecture_user)
694 info->bfd_arch_info = target_architecture_user;
695 if (info->bfd_arch_info == NULL
696 && info->abfd != NULL
697 && bfd_get_arch (info->abfd) != bfd_arch_unknown
698 && bfd_get_arch (info->abfd) != bfd_arch_obscure)
699 info->bfd_arch_info = bfd_get_arch_info (info->abfd);
700 /* From the default. */
701 if (info->bfd_arch_info == NULL)
702 info->bfd_arch_info = default_bfd_arch;
704 /* "(gdb) set byte-order ...". */
705 if (info->byte_order == BFD_ENDIAN_UNKNOWN
706 && target_byte_order_user != BFD_ENDIAN_UNKNOWN)
707 info->byte_order = target_byte_order_user;
708 /* From the INFO struct. */
709 if (info->byte_order == BFD_ENDIAN_UNKNOWN
710 && info->abfd != NULL)
711 info->byte_order = (bfd_big_endian (info->abfd) ? BFD_ENDIAN_BIG
712 : bfd_little_endian (info->abfd) ? BFD_ENDIAN_LITTLE
713 : BFD_ENDIAN_UNKNOWN);
714 /* From the default. */
715 if (info->byte_order == BFD_ENDIAN_UNKNOWN)
716 info->byte_order = default_byte_order;
718 /* "(gdb) set osabi ...". Handled by gdbarch_lookup_osabi. */
719 if (info->osabi == GDB_OSABI_UNINITIALIZED)
720 info->osabi = gdbarch_lookup_osabi (info->abfd);
722 /* Must have at least filled in the architecture. */
723 gdb_assert (info->bfd_arch_info != NULL);
728 extern initialize_file_ftype _initialize_gdbarch_utils; /* -Wmissing-prototypes */
731 _initialize_gdbarch_utils (void)
733 struct cmd_list_element *c;
734 add_setshow_enum_cmd ("endian", class_support,
735 endian_enum, &set_endian_string, _("\
736 Set endianness of target."), _("\
737 Show endianness of target."), NULL,
738 set_endian, show_endian,
739 &setlist, &showlist);