1 /* Dynamic architecture support for GDB, the GNU debugger.
3 Copyright (C) 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007,
4 2008, 2009 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 3 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, see <http://www.gnu.org/licenses/>. */
23 #include "arch-utils.h"
26 #include "inferior.h" /* enum CALL_DUMMY_LOCATION et.al. */
27 #include "gdb_string.h"
29 #include "gdb_assert.h"
30 #include "sim-regno.h"
33 #include "target-descriptions.h"
38 #include "floatformat.h"
41 struct displaced_step_closure *
42 simple_displaced_step_copy_insn (struct gdbarch *gdbarch,
43 CORE_ADDR from, CORE_ADDR to,
44 struct regcache *regs)
46 size_t len = gdbarch_max_insn_length (gdbarch);
47 gdb_byte *buf = xmalloc (len);
49 read_memory (from, buf, len);
50 write_memory (to, buf, len);
54 fprintf_unfiltered (gdb_stdlog, "displaced: copy %s->%s: ",
55 paddress (gdbarch, from), paddress (gdbarch, to));
56 displaced_step_dump_bytes (gdb_stdlog, buf, len);
59 return (struct displaced_step_closure *) buf;
64 simple_displaced_step_free_closure (struct gdbarch *gdbarch,
65 struct displaced_step_closure *closure)
72 displaced_step_at_entry_point (struct gdbarch *gdbarch)
77 addr = entry_point_address ();
79 /* Make certain that the address points at real code, and not a
80 function descriptor. */
81 addr = gdbarch_convert_from_func_ptr_addr (gdbarch, addr, ¤t_target);
83 /* Inferior calls also use the entry point as a breakpoint location.
84 We don't want displaced stepping to interfere with those
85 breakpoints, so leave space. */
86 gdbarch_breakpoint_from_pc (gdbarch, &addr, &bp_len);
93 legacy_register_sim_regno (struct gdbarch *gdbarch, int regnum)
95 /* Only makes sense to supply raw registers. */
96 gdb_assert (regnum >= 0 && regnum < gdbarch_num_regs (gdbarch));
97 /* NOTE: cagney/2002-05-13: The old code did it this way and it is
98 suspected that some GDB/SIM combinations may rely on this
99 behavour. The default should be one2one_register_sim_regno
101 if (gdbarch_register_name (gdbarch, regnum) != NULL
102 && gdbarch_register_name (gdbarch, regnum)[0] != '\0')
105 return LEGACY_SIM_REGNO_IGNORE;
109 generic_skip_trampoline_code (struct frame_info *frame, CORE_ADDR pc)
115 generic_skip_solib_resolver (struct gdbarch *gdbarch, CORE_ADDR pc)
121 generic_in_solib_return_trampoline (struct gdbarch *gdbarch,
122 CORE_ADDR pc, char *name)
128 generic_in_function_epilogue_p (struct gdbarch *gdbarch, CORE_ADDR pc)
133 /* Helper functions for gdbarch_inner_than */
136 core_addr_lessthan (CORE_ADDR lhs, CORE_ADDR rhs)
142 core_addr_greaterthan (CORE_ADDR lhs, CORE_ADDR rhs)
147 /* Misc helper functions for targets. */
150 core_addr_identity (struct gdbarch *gdbarch, CORE_ADDR addr)
156 convert_from_func_ptr_addr_identity (struct gdbarch *gdbarch, CORE_ADDR addr,
157 struct target_ops *targ)
163 no_op_reg_to_regnum (struct gdbarch *gdbarch, int reg)
169 default_elf_make_msymbol_special (asymbol *sym, struct minimal_symbol *msym)
175 default_coff_make_msymbol_special (int val, struct minimal_symbol *msym)
181 cannot_register_not (struct gdbarch *gdbarch, int regnum)
186 /* Legacy version of target_virtual_frame_pointer(). Assumes that
187 there is an gdbarch_deprecated_fp_regnum and that it is the same, cooked or
191 legacy_virtual_frame_pointer (struct gdbarch *gdbarch,
194 LONGEST *frame_offset)
196 /* FIXME: cagney/2002-09-13: This code is used when identifying the
197 frame pointer of the current PC. It is assuming that a single
198 register and an offset can determine this. I think it should
199 instead generate a byte code expression as that would work better
200 with things like Dwarf2's CFI. */
201 if (gdbarch_deprecated_fp_regnum (gdbarch) >= 0
202 && gdbarch_deprecated_fp_regnum (gdbarch)
203 < gdbarch_num_regs (gdbarch))
204 *frame_regnum = gdbarch_deprecated_fp_regnum (gdbarch);
205 else if (gdbarch_sp_regnum (gdbarch) >= 0
206 && gdbarch_sp_regnum (gdbarch)
207 < gdbarch_num_regs (gdbarch))
208 *frame_regnum = gdbarch_sp_regnum (gdbarch);
210 /* Should this be an internal error? I guess so, it is reflecting
211 an architectural limitation in the current design. */
212 internal_error (__FILE__, __LINE__, _("No virtual frame pointer available"));
218 generic_convert_register_p (struct gdbarch *gdbarch, int regnum,
225 default_stabs_argument_has_addr (struct gdbarch *gdbarch, struct type *type)
231 generic_instruction_nullified (struct gdbarch *gdbarch,
232 struct regcache *regcache)
238 default_remote_register_number (struct gdbarch *gdbarch,
245 /* Functions to manipulate the endianness of the target. */
247 static int target_byte_order_user = BFD_ENDIAN_UNKNOWN;
249 static const char endian_big[] = "big";
250 static const char endian_little[] = "little";
251 static const char endian_auto[] = "auto";
252 static const char *endian_enum[] =
259 static const char *set_endian_string;
262 selected_byte_order (void)
264 return target_byte_order_user;
267 /* Called by ``show endian''. */
270 show_endian (struct ui_file *file, int from_tty, struct cmd_list_element *c,
273 if (target_byte_order_user == BFD_ENDIAN_UNKNOWN)
274 if (gdbarch_byte_order (get_current_arch ()) == BFD_ENDIAN_BIG)
275 fprintf_unfiltered (file, _("The target endianness is set automatically "
276 "(currently big endian)\n"));
278 fprintf_unfiltered (file, _("The target endianness is set automatically "
279 "(currently little endian)\n"));
281 if (target_byte_order_user == BFD_ENDIAN_BIG)
282 fprintf_unfiltered (file,
283 _("The target is assumed to be big endian\n"));
285 fprintf_unfiltered (file,
286 _("The target is assumed to be little endian\n"));
290 set_endian (char *ignore_args, int from_tty, struct cmd_list_element *c)
292 struct gdbarch_info info;
294 gdbarch_info_init (&info);
296 if (set_endian_string == endian_auto)
298 target_byte_order_user = BFD_ENDIAN_UNKNOWN;
299 if (! gdbarch_update_p (info))
300 internal_error (__FILE__, __LINE__,
301 _("set_endian: architecture update failed"));
303 else if (set_endian_string == endian_little)
305 info.byte_order = BFD_ENDIAN_LITTLE;
306 if (! gdbarch_update_p (info))
307 printf_unfiltered (_("Little endian target not supported by GDB\n"));
309 target_byte_order_user = BFD_ENDIAN_LITTLE;
311 else if (set_endian_string == endian_big)
313 info.byte_order = BFD_ENDIAN_BIG;
314 if (! gdbarch_update_p (info))
315 printf_unfiltered (_("Big endian target not supported by GDB\n"));
317 target_byte_order_user = BFD_ENDIAN_BIG;
320 internal_error (__FILE__, __LINE__,
321 _("set_endian: bad value"));
323 show_endian (gdb_stdout, from_tty, NULL, NULL);
326 /* Given SELECTED, a currently selected BFD architecture, and
327 FROM_TARGET, a BFD architecture reported by the target description,
328 return what architecture to use. Either may be NULL; if both are
329 specified, we use the more specific. If the two are obviously
330 incompatible, warn the user. */
332 static const struct bfd_arch_info *
333 choose_architecture_for_target (const struct bfd_arch_info *selected,
334 const struct bfd_arch_info *from_target)
336 const struct bfd_arch_info *compat1, *compat2;
338 if (selected == NULL)
341 if (from_target == NULL)
344 /* struct bfd_arch_info objects are singletons: that is, there's
345 supposed to be exactly one instance for a given machine. So you
346 can tell whether two are equivalent by comparing pointers. */
347 if (from_target == selected)
350 /* BFD's 'A->compatible (A, B)' functions return zero if A and B are
351 incompatible. But if they are compatible, it returns the 'more
352 featureful' of the two arches. That is, if A can run code
353 written for B, but B can't run code written for A, then it'll
356 Some targets (e.g. MIPS as of 2006-12-04) don't fully
357 implement this, instead always returning NULL or the first
358 argument. We detect that case by checking both directions. */
360 compat1 = selected->compatible (selected, from_target);
361 compat2 = from_target->compatible (from_target, selected);
363 if (compat1 == NULL && compat2 == NULL)
365 warning (_("Selected architecture %s is not compatible "
366 "with reported target architecture %s"),
367 selected->printable_name, from_target->printable_name);
375 if (compat1 == compat2)
378 /* If the two didn't match, but one of them was a default architecture,
379 assume the more specific one is correct. This handles the case
380 where an executable or target description just says "mips", but
381 the other knows which MIPS variant. */
382 if (compat1->the_default)
384 if (compat2->the_default)
387 /* We have no idea which one is better. This is a bug, but not
388 a critical problem; warn the user. */
389 warning (_("Selected architecture %s is ambiguous with "
390 "reported target architecture %s"),
391 selected->printable_name, from_target->printable_name);
395 /* Functions to manipulate the architecture of the target */
397 enum set_arch { set_arch_auto, set_arch_manual };
399 static const struct bfd_arch_info *target_architecture_user;
401 static const char *set_architecture_string;
404 selected_architecture_name (void)
406 if (target_architecture_user == NULL)
409 return set_architecture_string;
412 /* Called if the user enters ``show architecture'' without an
416 show_architecture (struct ui_file *file, int from_tty,
417 struct cmd_list_element *c, const char *value)
419 if (target_architecture_user == NULL)
420 fprintf_filtered (file, _("\
421 The target architecture is set automatically (currently %s)\n"),
422 gdbarch_bfd_arch_info (get_current_arch ())->printable_name);
424 fprintf_filtered (file, _("\
425 The target architecture is assumed to be %s\n"), set_architecture_string);
429 /* Called if the user enters ``set architecture'' with or without an
433 set_architecture (char *ignore_args, int from_tty, struct cmd_list_element *c)
435 struct gdbarch_info info;
437 gdbarch_info_init (&info);
439 if (strcmp (set_architecture_string, "auto") == 0)
441 target_architecture_user = NULL;
442 if (!gdbarch_update_p (info))
443 internal_error (__FILE__, __LINE__,
444 _("could not select an architecture automatically"));
448 info.bfd_arch_info = bfd_scan_arch (set_architecture_string);
449 if (info.bfd_arch_info == NULL)
450 internal_error (__FILE__, __LINE__,
451 _("set_architecture: bfd_scan_arch failed"));
452 if (gdbarch_update_p (info))
453 target_architecture_user = info.bfd_arch_info;
455 printf_unfiltered (_("Architecture `%s' not recognized.\n"),
456 set_architecture_string);
458 show_architecture (gdb_stdout, from_tty, NULL, NULL);
461 /* Try to select a global architecture that matches "info". Return
462 non-zero if the attempt succeds. */
464 gdbarch_update_p (struct gdbarch_info info)
466 struct gdbarch *new_gdbarch;
468 /* Check for the current file. */
469 if (info.abfd == NULL)
470 info.abfd = exec_bfd;
471 if (info.abfd == NULL)
472 info.abfd = core_bfd;
474 /* Check for the current target description. */
475 if (info.target_desc == NULL)
476 info.target_desc = target_current_description ();
478 new_gdbarch = gdbarch_find_by_info (info);
480 /* If there no architecture by that name, reject the request. */
481 if (new_gdbarch == NULL)
484 fprintf_unfiltered (gdb_stdlog, "gdbarch_update_p: "
485 "Architecture not found\n");
489 /* If it is the same old architecture, accept the request (but don't
491 if (new_gdbarch == target_gdbarch)
494 fprintf_unfiltered (gdb_stdlog, "gdbarch_update_p: "
495 "Architecture %s (%s) unchanged\n",
496 host_address_to_string (new_gdbarch),
497 gdbarch_bfd_arch_info (new_gdbarch)->printable_name);
501 /* It's a new architecture, swap it in. */
503 fprintf_unfiltered (gdb_stdlog, "gdbarch_update_p: "
504 "New architecture %s (%s) selected\n",
505 host_address_to_string (new_gdbarch),
506 gdbarch_bfd_arch_info (new_gdbarch)->printable_name);
507 deprecated_target_gdbarch_select_hack (new_gdbarch);
512 /* Return the architecture for ABFD. If no suitable architecture
513 could be find, return NULL. */
516 gdbarch_from_bfd (bfd *abfd)
518 struct gdbarch_info info;
519 gdbarch_info_init (&info);
521 return gdbarch_find_by_info (info);
524 /* Set the dynamic target-system-dependent parameters (architecture,
525 byte-order) using information found in the BFD */
528 set_gdbarch_from_file (bfd *abfd)
530 struct gdbarch_info info;
531 struct gdbarch *gdbarch;
533 gdbarch_info_init (&info);
535 info.target_desc = target_current_description ();
536 gdbarch = gdbarch_find_by_info (info);
539 error (_("Architecture of file not recognized."));
540 deprecated_target_gdbarch_select_hack (gdbarch);
543 /* Initialize the current architecture. Update the ``set
544 architecture'' command so that it specifies a list of valid
547 #ifdef DEFAULT_BFD_ARCH
548 extern const bfd_arch_info_type DEFAULT_BFD_ARCH;
549 static const bfd_arch_info_type *default_bfd_arch = &DEFAULT_BFD_ARCH;
551 static const bfd_arch_info_type *default_bfd_arch;
554 #ifdef DEFAULT_BFD_VEC
555 extern const bfd_target DEFAULT_BFD_VEC;
556 static const bfd_target *default_bfd_vec = &DEFAULT_BFD_VEC;
558 static const bfd_target *default_bfd_vec;
561 static int default_byte_order = BFD_ENDIAN_UNKNOWN;
564 initialize_current_architecture (void)
566 const char **arches = gdbarch_printable_names ();
568 /* determine a default architecture and byte order. */
569 struct gdbarch_info info;
570 gdbarch_info_init (&info);
572 /* Find a default architecture. */
573 if (default_bfd_arch == NULL)
575 /* Choose the architecture by taking the first one
577 const char *chosen = arches[0];
579 for (arch = arches; *arch != NULL; arch++)
581 if (strcmp (*arch, chosen) < 0)
585 internal_error (__FILE__, __LINE__,
586 _("initialize_current_architecture: No arch"));
587 default_bfd_arch = bfd_scan_arch (chosen);
588 if (default_bfd_arch == NULL)
589 internal_error (__FILE__, __LINE__,
590 _("initialize_current_architecture: Arch not found"));
593 info.bfd_arch_info = default_bfd_arch;
595 /* Take several guesses at a byte order. */
596 if (default_byte_order == BFD_ENDIAN_UNKNOWN
597 && default_bfd_vec != NULL)
599 /* Extract BFD's default vector's byte order. */
600 switch (default_bfd_vec->byteorder)
603 default_byte_order = BFD_ENDIAN_BIG;
605 case BFD_ENDIAN_LITTLE:
606 default_byte_order = BFD_ENDIAN_LITTLE;
612 if (default_byte_order == BFD_ENDIAN_UNKNOWN)
614 /* look for ``*el-*'' in the target name. */
616 chp = strchr (target_name, '-');
618 && chp - 2 >= target_name
619 && strncmp (chp - 2, "el", 2) == 0)
620 default_byte_order = BFD_ENDIAN_LITTLE;
622 if (default_byte_order == BFD_ENDIAN_UNKNOWN)
624 /* Wire it to big-endian!!! */
625 default_byte_order = BFD_ENDIAN_BIG;
628 info.byte_order = default_byte_order;
629 info.byte_order_for_code = info.byte_order;
631 if (! gdbarch_update_p (info))
632 internal_error (__FILE__, __LINE__,
633 _("initialize_current_architecture: Selection of "
634 "initial architecture failed"));
636 /* Create the ``set architecture'' command appending ``auto'' to the
637 list of architectures. */
639 struct cmd_list_element *c;
640 /* Append ``auto''. */
642 for (nr = 0; arches[nr] != NULL; nr++);
643 arches = xrealloc (arches, sizeof (char*) * (nr + 2));
644 arches[nr + 0] = "auto";
645 arches[nr + 1] = NULL;
646 add_setshow_enum_cmd ("architecture", class_support,
647 arches, &set_architecture_string, _("\
648 Set architecture of target."), _("\
649 Show architecture of target."), NULL,
650 set_architecture, show_architecture,
651 &setlist, &showlist);
652 add_alias_cmd ("processor", "architecture", class_support, 1, &setlist);
657 /* Initialize a gdbarch info to values that will be automatically
658 overridden. Note: Originally, this ``struct info'' was initialized
659 using memset(0). Unfortunately, that ran into problems, namely
660 BFD_ENDIAN_BIG is zero. An explicit initialization function that
661 can explicitly set each field to a well defined value is used. */
664 gdbarch_info_init (struct gdbarch_info *info)
666 memset (info, 0, sizeof (struct gdbarch_info));
667 info->byte_order = BFD_ENDIAN_UNKNOWN;
668 info->byte_order_for_code = info->byte_order;
669 info->osabi = GDB_OSABI_UNINITIALIZED;
672 /* Similar to init, but this time fill in the blanks. Information is
673 obtained from the global "set ..." options and explicitly
674 initialized INFO fields. */
677 gdbarch_info_fill (struct gdbarch_info *info)
679 /* "(gdb) set architecture ...". */
680 if (info->bfd_arch_info == NULL
681 && target_architecture_user)
682 info->bfd_arch_info = target_architecture_user;
684 if (info->bfd_arch_info == NULL
685 && info->abfd != NULL
686 && bfd_get_arch (info->abfd) != bfd_arch_unknown
687 && bfd_get_arch (info->abfd) != bfd_arch_obscure)
688 info->bfd_arch_info = bfd_get_arch_info (info->abfd);
689 /* From the target. */
690 if (info->target_desc != NULL)
691 info->bfd_arch_info = choose_architecture_for_target
692 (info->bfd_arch_info, tdesc_architecture (info->target_desc));
693 /* From the default. */
694 if (info->bfd_arch_info == NULL)
695 info->bfd_arch_info = default_bfd_arch;
697 /* "(gdb) set byte-order ...". */
698 if (info->byte_order == BFD_ENDIAN_UNKNOWN
699 && target_byte_order_user != BFD_ENDIAN_UNKNOWN)
700 info->byte_order = target_byte_order_user;
701 /* From the INFO struct. */
702 if (info->byte_order == BFD_ENDIAN_UNKNOWN
703 && info->abfd != NULL)
704 info->byte_order = (bfd_big_endian (info->abfd) ? BFD_ENDIAN_BIG
705 : bfd_little_endian (info->abfd) ? BFD_ENDIAN_LITTLE
706 : BFD_ENDIAN_UNKNOWN);
707 /* From the default. */
708 if (info->byte_order == BFD_ENDIAN_UNKNOWN)
709 info->byte_order = default_byte_order;
710 info->byte_order_for_code = info->byte_order;
712 /* "(gdb) set osabi ...". Handled by gdbarch_lookup_osabi. */
713 /* From the manual override, or from file. */
714 if (info->osabi == GDB_OSABI_UNINITIALIZED)
715 info->osabi = gdbarch_lookup_osabi (info->abfd);
716 /* From the target. */
717 if (info->osabi == GDB_OSABI_UNKNOWN && info->target_desc != NULL)
718 info->osabi = tdesc_osabi (info->target_desc);
719 /* From the configured default. */
720 #ifdef GDB_OSABI_DEFAULT
721 if (info->osabi == GDB_OSABI_UNKNOWN)
722 info->osabi = GDB_OSABI_DEFAULT;
725 /* Must have at least filled in the architecture. */
726 gdb_assert (info->bfd_arch_info != NULL);
729 /* Return "current" architecture. If the target is running, this is the
730 architecture of the selected frame. Otherwise, the "current" architecture
731 defaults to the target architecture.
733 This function should normally be called solely by the command interpreter
734 routines to determine the architecture to execute a command in. */
736 get_current_arch (void)
738 if (has_stack_frames ())
739 return get_frame_arch (get_selected_frame (NULL));
741 return target_gdbarch;
746 extern initialize_file_ftype _initialize_gdbarch_utils; /* -Wmissing-prototypes */
749 _initialize_gdbarch_utils (void)
751 struct cmd_list_element *c;
752 add_setshow_enum_cmd ("endian", class_support,
753 endian_enum, &set_endian_string, _("\
754 Set endianness of target."), _("\
755 Show endianness of target."), NULL,
756 set_endian, show_endian,
757 &setlist, &showlist);