1 /* Dynamic architecture support for GDB, the GNU debugger.
3 Copyright 1998, 1999, 2000, 2001, 2002, 2003 Free Software Foundation,
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., 59 Temple Place - Suite 330,
21 Boston, MA 02111-1307, USA. */
26 #include "arch-utils.h"
28 #include "inferior.h" /* enum CALL_DUMMY_LOCATION et.al. */
30 /* Just include everything in sight so that the every old definition
31 of macro is visible. */
35 #include "breakpoint.h"
42 #include "gdb_string.h"
44 #include "gdb_assert.h"
45 #include "sim-regno.h"
49 #include "floatformat.h"
51 /* Use the program counter to determine the contents and size
52 of a breakpoint instruction. If no target-dependent macro
53 BREAKPOINT_FROM_PC has been defined to implement this function,
54 assume that the breakpoint doesn't depend on the PC, and
55 use the values of the BIG_BREAKPOINT and LITTLE_BREAKPOINT macros.
56 Return a pointer to a string of bytes that encode a breakpoint
57 instruction, stores the length of the string to *lenptr,
58 and optionally adjust the pc to point to the correct memory location
59 for inserting the breakpoint. */
62 legacy_breakpoint_from_pc (CORE_ADDR * pcptr, int *lenptr)
64 /* {BIG_,LITTLE_}BREAKPOINT is the sequence of bytes we insert for a
65 breakpoint. On some machines, breakpoints are handled by the
66 target environment and we don't have to worry about them here. */
68 if (TARGET_BYTE_ORDER == BFD_ENDIAN_BIG)
70 static unsigned char big_break_insn[] = BIG_BREAKPOINT;
71 *lenptr = sizeof (big_break_insn);
72 return big_break_insn;
75 #ifdef LITTLE_BREAKPOINT
76 if (TARGET_BYTE_ORDER != BFD_ENDIAN_BIG)
78 static unsigned char little_break_insn[] = LITTLE_BREAKPOINT;
79 *lenptr = sizeof (little_break_insn);
80 return little_break_insn;
85 static unsigned char break_insn[] = BREAKPOINT;
86 *lenptr = sizeof (break_insn);
94 /* Implementation of extract return value that grubs around in the
97 legacy_extract_return_value (struct type *type, struct regcache *regcache,
100 char *registers = deprecated_grub_regcache_for_registers (regcache);
101 bfd_byte *buf = valbuf;
102 DEPRECATED_EXTRACT_RETURN_VALUE (type, registers, buf); /* OK */
105 /* Implementation of store return value that grubs the register cache.
106 Takes a local copy of the buffer to avoid const problems. */
108 legacy_store_return_value (struct type *type, struct regcache *regcache,
111 bfd_byte *b = alloca (TYPE_LENGTH (type));
112 gdb_assert (regcache == current_regcache);
113 memcpy (b, buf, TYPE_LENGTH (type));
114 DEPRECATED_STORE_RETURN_VALUE (type, b);
119 legacy_register_sim_regno (int regnum)
121 /* Only makes sense to supply raw registers. */
122 gdb_assert (regnum >= 0 && regnum < NUM_REGS);
123 /* NOTE: cagney/2002-05-13: The old code did it this way and it is
124 suspected that some GDB/SIM combinations may rely on this
125 behavour. The default should be one2one_register_sim_regno
127 if (REGISTER_NAME (regnum) != NULL
128 && REGISTER_NAME (regnum)[0] != '\0')
131 return LEGACY_SIM_REGNO_IGNORE;
135 generic_frameless_function_invocation_not (struct frame_info *fi)
141 generic_return_value_on_stack_not (struct type *type)
147 generic_skip_trampoline_code (CORE_ADDR pc)
153 generic_in_solib_call_trampoline (CORE_ADDR pc, char *name)
159 generic_in_solib_return_trampoline (CORE_ADDR pc, char *name)
165 generic_in_function_epilogue_p (struct gdbarch *gdbarch, CORE_ADDR pc)
171 legacy_register_name (int i)
173 #ifdef REGISTER_NAMES
174 static char *names[] = REGISTER_NAMES;
175 if (i < 0 || i >= (sizeof (names) / sizeof (*names)))
180 internal_error (__FILE__, __LINE__,
181 "legacy_register_name: called.");
186 #if defined (CALL_DUMMY)
187 LONGEST legacy_call_dummy_words[] = CALL_DUMMY;
189 LONGEST legacy_call_dummy_words[1];
191 int legacy_sizeof_call_dummy_words = sizeof (legacy_call_dummy_words);
194 generic_remote_translate_xfer_address (CORE_ADDR gdb_addr, int gdb_len,
195 CORE_ADDR * rem_addr, int *rem_len)
197 *rem_addr = gdb_addr;
202 generic_prologue_frameless_p (CORE_ADDR ip)
204 return ip == SKIP_PROLOGUE (ip);
207 /* New/multi-arched targets should use the correct gdbarch field
208 instead of using this global pointer. */
210 legacy_print_insn (bfd_vma vma, disassemble_info *info)
212 return (*deprecated_tm_print_insn) (vma, info);
215 /* Helper functions for INNER_THAN */
218 core_addr_lessthan (CORE_ADDR lhs, CORE_ADDR rhs)
224 core_addr_greaterthan (CORE_ADDR lhs, CORE_ADDR rhs)
230 /* Helper functions for TARGET_{FLOAT,DOUBLE}_FORMAT */
232 const struct floatformat *
233 default_float_format (struct gdbarch *gdbarch)
236 int byte_order = gdbarch_byte_order (gdbarch);
238 int byte_order = TARGET_BYTE_ORDER;
243 return &floatformat_ieee_single_big;
244 case BFD_ENDIAN_LITTLE:
245 return &floatformat_ieee_single_little;
247 internal_error (__FILE__, __LINE__,
248 "default_float_format: bad byte order");
253 const struct floatformat *
254 default_double_format (struct gdbarch *gdbarch)
257 int byte_order = gdbarch_byte_order (gdbarch);
259 int byte_order = TARGET_BYTE_ORDER;
264 return &floatformat_ieee_double_big;
265 case BFD_ENDIAN_LITTLE:
266 return &floatformat_ieee_double_little;
268 internal_error (__FILE__, __LINE__,
269 "default_double_format: bad byte order");
273 /* Misc helper functions for targets. */
276 frame_num_args_unknown (struct frame_info *fi)
283 generic_register_convertible_not (int num)
289 /* Under some ABI's that specify the `struct convention' for returning
290 structures by value, by the time we've returned from the function,
291 the return value is sitting there in the caller's buffer, but GDB
292 has no way to find the address of that buffer.
294 On such architectures, use this function as your
295 extract_struct_value_address method. When asked to a struct
296 returned by value in this fashion, GDB will print a nice error
297 message, instead of garbage. */
299 generic_cannot_extract_struct_value_address (char *dummy)
305 core_addr_identity (CORE_ADDR addr)
311 no_op_reg_to_regnum (int reg)
316 /* Default prepare_to_procced(). */
318 default_prepare_to_proceed (int select_it)
323 /* Generic prepare_to_proceed(). This one should be suitable for most
324 targets that support threads. */
326 generic_prepare_to_proceed (int select_it)
329 struct target_waitstatus wait_status;
331 /* Get the last target status returned by target_wait(). */
332 get_last_target_status (&wait_ptid, &wait_status);
334 /* Make sure we were stopped either at a breakpoint, or because
336 if (wait_status.kind != TARGET_WAITKIND_STOPPED
337 || (wait_status.value.sig != TARGET_SIGNAL_TRAP &&
338 wait_status.value.sig != TARGET_SIGNAL_INT))
343 if (!ptid_equal (wait_ptid, minus_one_ptid)
344 && !ptid_equal (inferior_ptid, wait_ptid))
346 /* Switched over from WAIT_PID. */
347 CORE_ADDR wait_pc = read_pc_pid (wait_ptid);
349 if (wait_pc != read_pc ())
353 /* Switch back to WAIT_PID thread. */
354 inferior_ptid = wait_ptid;
356 /* FIXME: This stuff came from switch_to_thread() in
357 thread.c (which should probably be a public function). */
358 flush_cached_frames ();
359 registers_changed ();
361 select_frame (get_current_frame ());
363 /* We return 1 to indicate that there is a breakpoint here,
364 so we need to step over it before continuing to avoid
365 hitting it straight away. */
366 if (breakpoint_here_p (wait_pc))
377 init_frame_pc_noop (int fromleaf, struct frame_info *prev)
379 /* Do nothing, implies return the same PC value. */
380 return get_frame_pc (prev);
384 init_frame_pc_default (int fromleaf, struct frame_info *prev)
386 if (fromleaf && DEPRECATED_SAVED_PC_AFTER_CALL_P ())
387 return DEPRECATED_SAVED_PC_AFTER_CALL (get_next_frame (prev));
388 else if (get_next_frame (prev) != NULL)
389 return DEPRECATED_FRAME_SAVED_PC (get_next_frame (prev));
395 default_elf_make_msymbol_special (asymbol *sym, struct minimal_symbol *msym)
401 default_coff_make_msymbol_special (int val, struct minimal_symbol *msym)
407 cannot_register_not (int regnum)
412 /* Legacy version of target_virtual_frame_pointer(). Assumes that
413 there is an DEPRECATED_FP_REGNUM and that it is the same, cooked or
417 legacy_virtual_frame_pointer (CORE_ADDR pc,
419 LONGEST *frame_offset)
421 /* FIXME: cagney/2002-09-13: This code is used when identifying the
422 frame pointer of the current PC. It is assuming that a single
423 register and an offset can determine this. I think it should
424 instead generate a byte code expression as that would work better
425 with things like Dwarf2's CFI. */
426 if (DEPRECATED_FP_REGNUM >= 0 && DEPRECATED_FP_REGNUM < NUM_REGS)
427 *frame_regnum = DEPRECATED_FP_REGNUM;
428 else if (SP_REGNUM >= 0 && SP_REGNUM < NUM_REGS)
429 *frame_regnum = SP_REGNUM;
431 /* Should this be an internal error? I guess so, it is reflecting
432 an architectural limitation in the current design. */
433 internal_error (__FILE__, __LINE__, "No virtual frame pointer available");
437 /* Assume the world is sane, every register's virtual and real size
441 generic_register_size (int regnum)
443 gdb_assert (regnum >= 0 && regnum < NUM_REGS + NUM_PSEUDO_REGS);
444 if (gdbarch_register_type_p (current_gdbarch))
445 return TYPE_LENGTH (gdbarch_register_type (current_gdbarch, regnum));
447 /* FIXME: cagney/2003-03-01: Once all architectures implement
448 gdbarch_register_type(), this entire function can go away. It
449 is made obsolete by register_size(). */
450 return TYPE_LENGTH (REGISTER_VIRTUAL_TYPE (regnum)); /* OK */
453 /* Assume all registers are adjacent. */
456 generic_register_byte (int regnum)
460 gdb_assert (regnum >= 0 && regnum < NUM_REGS + NUM_PSEUDO_REGS);
462 for (i = 0; i < regnum; i++)
464 byte += generic_register_size (i);
471 legacy_pc_in_sigtramp (CORE_ADDR pc, char *name)
473 #if !defined (IN_SIGTRAMP)
474 if (SIGTRAMP_START_P ())
475 return (pc) >= SIGTRAMP_START (pc) && (pc) < SIGTRAMP_END (pc);
477 return name && strcmp ("_sigtramp", name) == 0;
479 return IN_SIGTRAMP (pc, name);
484 legacy_convert_register_p (int regnum)
486 return REGISTER_CONVERTIBLE (regnum);
490 legacy_register_to_value (int regnum, struct type *type,
491 char *from, char *to)
493 REGISTER_CONVERT_TO_VIRTUAL (regnum, type, from, to);
497 legacy_value_to_register (struct type *type, int regnum,
498 char *from, char *to)
500 REGISTER_CONVERT_TO_RAW (type, regnum, from, to);
504 /* Functions to manipulate the endianness of the target. */
506 /* ``target_byte_order'' is only used when non- multi-arch.
507 Multi-arch targets obtain the current byte order using the
508 TARGET_BYTE_ORDER gdbarch method.
510 The choice of initial value is entirely arbitrary. During startup,
511 the function initialize_current_architecture() updates this value
512 based on default byte-order information extracted from BFD. */
513 int target_byte_order = BFD_ENDIAN_BIG;
514 int target_byte_order_auto = 1;
516 static const char endian_big[] = "big";
517 static const char endian_little[] = "little";
518 static const char endian_auto[] = "auto";
519 static const char *endian_enum[] =
526 static const char *set_endian_string;
528 /* Called by ``show endian''. */
531 show_endian (char *args, int from_tty)
533 if (TARGET_BYTE_ORDER_AUTO)
534 printf_unfiltered ("The target endianness is set automatically (currently %s endian)\n",
535 (TARGET_BYTE_ORDER == BFD_ENDIAN_BIG ? "big" : "little"));
537 printf_unfiltered ("The target is assumed to be %s endian\n",
538 (TARGET_BYTE_ORDER == BFD_ENDIAN_BIG ? "big" : "little"));
542 set_endian (char *ignore_args, int from_tty, struct cmd_list_element *c)
544 if (set_endian_string == endian_auto)
546 target_byte_order_auto = 1;
548 else if (set_endian_string == endian_little)
550 target_byte_order_auto = 0;
553 struct gdbarch_info info;
554 gdbarch_info_init (&info);
555 info.byte_order = BFD_ENDIAN_LITTLE;
556 if (! gdbarch_update_p (info))
558 printf_unfiltered ("Little endian target not supported by GDB\n");
563 target_byte_order = BFD_ENDIAN_LITTLE;
566 else if (set_endian_string == endian_big)
568 target_byte_order_auto = 0;
571 struct gdbarch_info info;
572 gdbarch_info_init (&info);
573 info.byte_order = BFD_ENDIAN_BIG;
574 if (! gdbarch_update_p (info))
576 printf_unfiltered ("Big endian target not supported by GDB\n");
581 target_byte_order = BFD_ENDIAN_BIG;
585 internal_error (__FILE__, __LINE__,
586 "set_endian: bad value");
587 show_endian (NULL, from_tty);
590 /* Set the endianness from a BFD. */
593 set_endian_from_file (bfd *abfd)
597 internal_error (__FILE__, __LINE__,
598 "set_endian_from_file: not for multi-arch");
599 if (bfd_big_endian (abfd))
600 want = BFD_ENDIAN_BIG;
602 want = BFD_ENDIAN_LITTLE;
603 if (TARGET_BYTE_ORDER_AUTO)
604 target_byte_order = want;
605 else if (TARGET_BYTE_ORDER != want)
606 warning ("%s endian file does not match %s endian target.",
607 want == BFD_ENDIAN_BIG ? "big" : "little",
608 TARGET_BYTE_ORDER == BFD_ENDIAN_BIG ? "big" : "little");
612 /* Functions to manipulate the architecture of the target */
614 enum set_arch { set_arch_auto, set_arch_manual };
616 int target_architecture_auto = 1;
618 const char *set_architecture_string;
620 /* Old way of changing the current architecture. */
622 extern const struct bfd_arch_info bfd_default_arch_struct;
623 const struct bfd_arch_info *target_architecture = &bfd_default_arch_struct;
624 int (*target_architecture_hook) (const struct bfd_arch_info *ap);
627 arch_ok (const struct bfd_arch_info *arch)
630 internal_error (__FILE__, __LINE__,
631 "arch_ok: not multi-arched");
632 /* Should be performing the more basic check that the binary is
633 compatible with GDB. */
634 /* Check with the target that the architecture is valid. */
635 return (target_architecture_hook == NULL
636 || target_architecture_hook (arch));
640 set_arch (const struct bfd_arch_info *arch,
644 internal_error (__FILE__, __LINE__,
645 "set_arch: not multi-arched");
650 warning ("Target may not support %s architecture",
651 arch->printable_name);
652 target_architecture = arch;
654 case set_arch_manual:
657 printf_unfiltered ("Target does not support `%s' architecture.\n",
658 arch->printable_name);
662 target_architecture_auto = 0;
663 target_architecture = arch;
668 gdbarch_dump (current_gdbarch, gdb_stdlog);
671 /* Set the architecture from arch/machine (deprecated) */
674 set_architecture_from_arch_mach (enum bfd_architecture arch,
677 const struct bfd_arch_info *wanted = bfd_lookup_arch (arch, mach);
679 internal_error (__FILE__, __LINE__,
680 "set_architecture_from_arch_mach: not multi-arched");
682 set_arch (wanted, set_arch_manual);
684 internal_error (__FILE__, __LINE__,
685 "gdbarch: hardwired architecture/machine not recognized");
688 /* Set the architecture from a BFD (deprecated) */
691 set_architecture_from_file (bfd *abfd)
693 const struct bfd_arch_info *wanted = bfd_get_arch_info (abfd);
695 internal_error (__FILE__, __LINE__,
696 "set_architecture_from_file: not multi-arched");
697 if (target_architecture_auto)
699 set_arch (wanted, set_arch_auto);
701 else if (wanted != target_architecture)
703 warning ("%s architecture file may be incompatible with %s target.",
704 wanted->printable_name,
705 target_architecture->printable_name);
710 /* Called if the user enters ``show architecture'' without an
714 show_architecture (char *args, int from_tty)
717 arch = TARGET_ARCHITECTURE->printable_name;
718 if (target_architecture_auto)
719 printf_filtered ("The target architecture is set automatically (currently %s)\n", arch);
721 printf_filtered ("The target architecture is assumed to be %s\n", arch);
725 /* Called if the user enters ``set architecture'' with or without an
729 set_architecture (char *ignore_args, int from_tty, struct cmd_list_element *c)
731 if (strcmp (set_architecture_string, "auto") == 0)
733 target_architecture_auto = 1;
735 else if (GDB_MULTI_ARCH)
737 struct gdbarch_info info;
738 gdbarch_info_init (&info);
739 info.bfd_arch_info = bfd_scan_arch (set_architecture_string);
740 if (info.bfd_arch_info == NULL)
741 internal_error (__FILE__, __LINE__,
742 "set_architecture: bfd_scan_arch failed");
743 if (gdbarch_update_p (info))
744 target_architecture_auto = 0;
746 printf_unfiltered ("Architecture `%s' not recognized.\n",
747 set_architecture_string);
751 const struct bfd_arch_info *arch
752 = bfd_scan_arch (set_architecture_string);
754 internal_error (__FILE__, __LINE__,
755 "set_architecture: bfd_scan_arch failed");
756 set_arch (arch, set_arch_manual);
758 show_architecture (NULL, from_tty);
761 /* Set the dynamic target-system-dependent parameters (architecture,
762 byte-order) using information found in the BFD */
765 set_gdbarch_from_file (bfd *abfd)
769 struct gdbarch_info info;
770 gdbarch_info_init (&info);
772 if (! gdbarch_update_p (info))
773 error ("Architecture of file not recognized.\n");
777 set_architecture_from_file (abfd);
778 set_endian_from_file (abfd);
782 /* Initialize the current architecture. Update the ``set
783 architecture'' command so that it specifies a list of valid
786 #ifdef DEFAULT_BFD_ARCH
787 extern const bfd_arch_info_type DEFAULT_BFD_ARCH;
788 static const bfd_arch_info_type *default_bfd_arch = &DEFAULT_BFD_ARCH;
790 static const bfd_arch_info_type *default_bfd_arch;
793 #ifdef DEFAULT_BFD_VEC
794 extern const bfd_target DEFAULT_BFD_VEC;
795 static const bfd_target *default_bfd_vec = &DEFAULT_BFD_VEC;
797 static const bfd_target *default_bfd_vec;
801 initialize_current_architecture (void)
803 const char **arches = gdbarch_printable_names ();
805 /* determine a default architecture and byte order. */
806 struct gdbarch_info info;
807 gdbarch_info_init (&info);
809 /* Find a default architecture. */
810 if (info.bfd_arch_info == NULL
811 && default_bfd_arch != NULL)
812 info.bfd_arch_info = default_bfd_arch;
813 if (info.bfd_arch_info == NULL)
815 /* Choose the architecture by taking the first one
817 const char *chosen = arches[0];
819 for (arch = arches; *arch != NULL; arch++)
821 if (strcmp (*arch, chosen) < 0)
825 internal_error (__FILE__, __LINE__,
826 "initialize_current_architecture: No arch");
827 info.bfd_arch_info = bfd_scan_arch (chosen);
828 if (info.bfd_arch_info == NULL)
829 internal_error (__FILE__, __LINE__,
830 "initialize_current_architecture: Arch not found");
833 /* Take several guesses at a byte order. */
834 if (info.byte_order == BFD_ENDIAN_UNKNOWN
835 && default_bfd_vec != NULL)
837 /* Extract BFD's default vector's byte order. */
838 switch (default_bfd_vec->byteorder)
841 info.byte_order = BFD_ENDIAN_BIG;
843 case BFD_ENDIAN_LITTLE:
844 info.byte_order = BFD_ENDIAN_LITTLE;
850 if (info.byte_order == BFD_ENDIAN_UNKNOWN)
852 /* look for ``*el-*'' in the target name. */
854 chp = strchr (target_name, '-');
856 && chp - 2 >= target_name
857 && strncmp (chp - 2, "el", 2) == 0)
858 info.byte_order = BFD_ENDIAN_LITTLE;
860 if (info.byte_order == BFD_ENDIAN_UNKNOWN)
862 /* Wire it to big-endian!!! */
863 info.byte_order = BFD_ENDIAN_BIG;
868 if (! gdbarch_update_p (info))
870 internal_error (__FILE__, __LINE__,
871 "initialize_current_architecture: Selection of initial architecture failed");
876 /* If the multi-arch logic comes up with a byte-order (from BFD)
877 use it for the non-multi-arch case. */
878 if (info.byte_order != BFD_ENDIAN_UNKNOWN)
879 target_byte_order = info.byte_order;
880 initialize_non_multiarch ();
883 /* Create the ``set architecture'' command appending ``auto'' to the
884 list of architectures. */
886 struct cmd_list_element *c;
887 /* Append ``auto''. */
889 for (nr = 0; arches[nr] != NULL; nr++);
890 arches = xrealloc (arches, sizeof (char*) * (nr + 2));
891 arches[nr + 0] = "auto";
892 arches[nr + 1] = NULL;
893 /* FIXME: add_set_enum_cmd() uses an array of ``char *'' instead
894 of ``const char *''. We just happen to know that the casts are
896 c = add_set_enum_cmd ("architecture", class_support,
897 arches, &set_architecture_string,
898 "Set architecture of target.",
900 set_cmd_sfunc (c, set_architecture);
901 add_alias_cmd ("processor", "architecture", class_support, 1, &setlist);
902 /* Don't use set_from_show - need to print both auto/manual and
904 add_cmd ("architecture", class_support, show_architecture,
905 "Show the current target architecture", &showlist);
910 /* Initialize a gdbarch info to values that will be automatically
911 overridden. Note: Originally, this ``struct info'' was initialized
912 using memset(0). Unfortunatly, that ran into problems, namely
913 BFD_ENDIAN_BIG is zero. An explicit initialization function that
914 can explicitly set each field to a well defined value is used. */
917 gdbarch_info_init (struct gdbarch_info *info)
919 memset (info, 0, sizeof (struct gdbarch_info));
920 info->byte_order = BFD_ENDIAN_UNKNOWN;
921 info->osabi = GDB_OSABI_UNINITIALIZED;
926 extern initialize_file_ftype _initialize_gdbarch_utils;
929 _initialize_gdbarch_utils (void)
931 struct cmd_list_element *c;
932 c = add_set_enum_cmd ("endian", class_support,
933 endian_enum, &set_endian_string,
934 "Set endianness of target.",
936 set_cmd_sfunc (c, set_endian);
937 /* Don't use set_from_show - need to print both auto/manual and
939 add_cmd ("endian", class_support, show_endian,
940 "Show the current byte-order", &showlist);