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. */
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 char *registers = deprecated_grub_regcache_for_registers (regcache);
47 bfd_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 bfd_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);
65 always_use_struct_convention (int gcc_p, struct type *value_type)
72 legacy_register_sim_regno (int regnum)
74 /* Only makes sense to supply raw registers. */
75 gdb_assert (regnum >= 0 && regnum < NUM_REGS);
76 /* NOTE: cagney/2002-05-13: The old code did it this way and it is
77 suspected that some GDB/SIM combinations may rely on this
78 behavour. The default should be one2one_register_sim_regno
80 if (REGISTER_NAME (regnum) != NULL
81 && REGISTER_NAME (regnum)[0] != '\0')
84 return LEGACY_SIM_REGNO_IGNORE;
88 generic_return_value_on_stack_not (struct type *type)
94 generic_skip_trampoline_code (CORE_ADDR pc)
100 generic_skip_solib_resolver (struct gdbarch *gdbarch, CORE_ADDR pc)
106 generic_in_solib_call_trampoline (CORE_ADDR pc, char *name)
112 generic_in_solib_return_trampoline (CORE_ADDR pc, char *name)
118 generic_in_function_epilogue_p (struct gdbarch *gdbarch, CORE_ADDR pc)
124 generic_remote_translate_xfer_address (struct gdbarch *gdbarch,
125 struct regcache *regcache,
126 CORE_ADDR gdb_addr, int gdb_len,
127 CORE_ADDR * rem_addr, int *rem_len)
129 *rem_addr = gdb_addr;
133 /* Helper functions for INNER_THAN */
136 core_addr_lessthan (CORE_ADDR lhs, CORE_ADDR rhs)
142 core_addr_greaterthan (CORE_ADDR lhs, CORE_ADDR rhs)
148 /* Helper functions for TARGET_{FLOAT,DOUBLE}_FORMAT */
150 const struct floatformat *
151 default_float_format (struct gdbarch *gdbarch)
153 int byte_order = gdbarch_byte_order (gdbarch);
157 return &floatformat_ieee_single_big;
158 case BFD_ENDIAN_LITTLE:
159 return &floatformat_ieee_single_little;
161 internal_error (__FILE__, __LINE__,
162 "default_float_format: bad byte order");
167 const struct floatformat *
168 default_double_format (struct gdbarch *gdbarch)
170 int byte_order = gdbarch_byte_order (gdbarch);
174 return &floatformat_ieee_double_big;
175 case BFD_ENDIAN_LITTLE:
176 return &floatformat_ieee_double_little;
178 internal_error (__FILE__, __LINE__,
179 "default_double_format: bad byte order");
183 /* Misc helper functions for targets. */
186 core_addr_identity (CORE_ADDR addr)
192 convert_from_func_ptr_addr_identity (struct gdbarch *gdbarch, CORE_ADDR addr,
193 struct target_ops *targ)
199 no_op_reg_to_regnum (int reg)
205 deprecated_init_frame_pc_default (int fromleaf, struct frame_info *prev)
207 if (fromleaf && DEPRECATED_SAVED_PC_AFTER_CALL_P ())
208 return DEPRECATED_SAVED_PC_AFTER_CALL (get_next_frame (prev));
209 else if (get_next_frame (prev) != NULL)
210 return DEPRECATED_FRAME_SAVED_PC (get_next_frame (prev));
216 default_elf_make_msymbol_special (asymbol *sym, struct minimal_symbol *msym)
222 default_coff_make_msymbol_special (int val, struct minimal_symbol *msym)
228 cannot_register_not (int regnum)
233 /* Legacy version of target_virtual_frame_pointer(). Assumes that
234 there is an DEPRECATED_FP_REGNUM and that it is the same, cooked or
238 legacy_virtual_frame_pointer (CORE_ADDR pc,
240 LONGEST *frame_offset)
242 /* FIXME: cagney/2002-09-13: This code is used when identifying the
243 frame pointer of the current PC. It is assuming that a single
244 register and an offset can determine this. I think it should
245 instead generate a byte code expression as that would work better
246 with things like Dwarf2's CFI. */
247 if (DEPRECATED_FP_REGNUM >= 0 && DEPRECATED_FP_REGNUM < NUM_REGS)
248 *frame_regnum = DEPRECATED_FP_REGNUM;
249 else if (SP_REGNUM >= 0 && SP_REGNUM < NUM_REGS)
250 *frame_regnum = SP_REGNUM;
252 /* Should this be an internal error? I guess so, it is reflecting
253 an architectural limitation in the current design. */
254 internal_error (__FILE__, __LINE__, "No virtual frame pointer available");
258 /* Assume the world is sane, every register's virtual and real size
262 generic_register_size (int regnum)
264 gdb_assert (regnum >= 0 && regnum < NUM_REGS + NUM_PSEUDO_REGS);
265 if (gdbarch_register_type_p (current_gdbarch))
266 return TYPE_LENGTH (gdbarch_register_type (current_gdbarch, regnum));
268 /* FIXME: cagney/2003-03-01: Once all architectures implement
269 gdbarch_register_type(), this entire function can go away. It
270 is made obsolete by register_size(). */
271 return TYPE_LENGTH (DEPRECATED_REGISTER_VIRTUAL_TYPE (regnum)); /* OK */
274 /* Assume all registers are adjacent. */
277 generic_register_byte (int regnum)
281 gdb_assert (regnum >= 0 && regnum < NUM_REGS + NUM_PSEUDO_REGS);
283 for (i = 0; i < regnum; i++)
285 byte += generic_register_size (i);
292 legacy_pc_in_sigtramp (CORE_ADDR pc, char *name)
294 #if defined (DEPRECATED_IN_SIGTRAMP)
295 return DEPRECATED_IN_SIGTRAMP (pc, name);
297 return name && strcmp ("_sigtramp", name) == 0;
302 legacy_convert_register_p (int regnum, struct type *type)
308 legacy_register_to_value (struct frame_info *frame, int regnum,
309 struct type *type, void *to)
311 internal_error (__FILE__, __LINE__, "legacy_register_to_value called");
315 legacy_value_to_register (struct frame_info *frame, int regnum,
316 struct type *type, const void *tmp)
318 internal_error (__FILE__, __LINE__, "legacy_value_to_register called");
322 default_stabs_argument_has_addr (struct gdbarch *gdbarch, struct type *type)
324 if (DEPRECATED_REG_STRUCT_HAS_ADDR_P ()
325 && DEPRECATED_REG_STRUCT_HAS_ADDR (processing_gcc_compilation, type))
327 CHECK_TYPEDEF (type);
329 return (TYPE_CODE (type) == TYPE_CODE_STRUCT
330 || TYPE_CODE (type) == TYPE_CODE_UNION
331 || TYPE_CODE (type) == TYPE_CODE_SET
332 || TYPE_CODE (type) == TYPE_CODE_BITSTRING);
339 /* Functions to manipulate the endianness of the target. */
341 /* ``target_byte_order'' is only used when non- multi-arch.
342 Multi-arch targets obtain the current byte order using the
343 TARGET_BYTE_ORDER gdbarch method.
345 The choice of initial value is entirely arbitrary. During startup,
346 the function initialize_current_architecture() updates this value
347 based on default byte-order information extracted from BFD. */
348 static int target_byte_order = BFD_ENDIAN_BIG;
349 static int target_byte_order_auto = 1;
352 selected_byte_order (void)
354 if (target_byte_order_auto)
355 return BFD_ENDIAN_UNKNOWN;
357 return target_byte_order;
360 static const char endian_big[] = "big";
361 static const char endian_little[] = "little";
362 static const char endian_auto[] = "auto";
363 static const char *endian_enum[] =
370 static const char *set_endian_string;
372 /* Called by ``show endian''. */
375 show_endian (char *args, int from_tty)
377 if (target_byte_order_auto)
378 printf_unfiltered ("The target endianness is set automatically (currently %s endian)\n",
379 (TARGET_BYTE_ORDER == BFD_ENDIAN_BIG ? "big" : "little"));
381 printf_unfiltered ("The target is assumed to be %s endian\n",
382 (TARGET_BYTE_ORDER == BFD_ENDIAN_BIG ? "big" : "little"));
386 set_endian (char *ignore_args, int from_tty, struct cmd_list_element *c)
388 if (set_endian_string == endian_auto)
390 target_byte_order_auto = 1;
392 else if (set_endian_string == endian_little)
394 struct gdbarch_info info;
395 target_byte_order_auto = 0;
396 gdbarch_info_init (&info);
397 info.byte_order = BFD_ENDIAN_LITTLE;
398 if (! gdbarch_update_p (info))
399 printf_unfiltered ("Little endian target not supported by GDB\n");
401 else if (set_endian_string == endian_big)
403 struct gdbarch_info info;
404 target_byte_order_auto = 0;
405 gdbarch_info_init (&info);
406 info.byte_order = BFD_ENDIAN_BIG;
407 if (! gdbarch_update_p (info))
408 printf_unfiltered ("Big endian target not supported by GDB\n");
411 internal_error (__FILE__, __LINE__,
412 "set_endian: bad value");
413 show_endian (NULL, from_tty);
416 /* Functions to manipulate the architecture of the target */
418 enum set_arch { set_arch_auto, set_arch_manual };
420 static int target_architecture_auto = 1;
422 static const char *set_architecture_string;
425 selected_architecture_name (void)
427 if (target_architecture_auto)
430 return set_architecture_string;
433 /* Called if the user enters ``show architecture'' without an
437 show_architecture (char *args, int from_tty)
440 arch = TARGET_ARCHITECTURE->printable_name;
441 if (target_architecture_auto)
442 printf_filtered ("The target architecture is set automatically (currently %s)\n", arch);
444 printf_filtered ("The target architecture is assumed to be %s\n", arch);
448 /* Called if the user enters ``set architecture'' with or without an
452 set_architecture (char *ignore_args, int from_tty, struct cmd_list_element *c)
454 if (strcmp (set_architecture_string, "auto") == 0)
456 target_architecture_auto = 1;
460 struct gdbarch_info info;
461 gdbarch_info_init (&info);
462 info.bfd_arch_info = bfd_scan_arch (set_architecture_string);
463 if (info.bfd_arch_info == NULL)
464 internal_error (__FILE__, __LINE__,
465 "set_architecture: bfd_scan_arch failed");
466 if (gdbarch_update_p (info))
467 target_architecture_auto = 0;
469 printf_unfiltered ("Architecture `%s' not recognized.\n",
470 set_architecture_string);
472 show_architecture (NULL, from_tty);
475 /* Try to select a global architecture that matches "info". Return
476 non-zero if the attempt succeds. */
478 gdbarch_update_p (struct gdbarch_info info)
480 struct gdbarch *new_gdbarch = gdbarch_find_by_info (info);
482 /* If there no architecture by that name, reject the request. */
483 if (new_gdbarch == NULL)
486 fprintf_unfiltered (gdb_stdlog, "gdbarch_update_p: "
487 "Architecture not found\n");
491 /* If it is the same old architecture, accept the request (but don't
493 if (new_gdbarch == current_gdbarch)
496 fprintf_unfiltered (gdb_stdlog, "gdbarch_update_p: "
497 "Architecture 0x%08lx (%s) unchanged\n",
499 gdbarch_bfd_arch_info (new_gdbarch)->printable_name);
503 /* It's a new architecture, swap it in. */
505 fprintf_unfiltered (gdb_stdlog, "gdbarch_update_p: "
506 "New architecture 0x%08lx (%s) selected\n",
508 gdbarch_bfd_arch_info (new_gdbarch)->printable_name);
509 deprecated_current_gdbarch_select_hack (new_gdbarch);
514 /* Return the architecture for ABFD. If no suitable architecture
515 could be find, return NULL. */
518 gdbarch_from_bfd (bfd *abfd)
520 struct gdbarch *old_gdbarch = current_gdbarch;
521 struct gdbarch *new_gdbarch;
522 struct gdbarch_info info;
524 gdbarch_info_init (&info);
526 return gdbarch_find_by_info (info);
529 /* Set the dynamic target-system-dependent parameters (architecture,
530 byte-order) using information found in the BFD */
533 set_gdbarch_from_file (bfd *abfd)
535 struct gdbarch *gdbarch;
537 gdbarch = gdbarch_from_bfd (abfd);
539 error ("Architecture of file not recognized.\n");
540 deprecated_current_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;
562 initialize_current_architecture (void)
564 const char **arches = gdbarch_printable_names ();
566 /* determine a default architecture and byte order. */
567 struct gdbarch_info info;
568 gdbarch_info_init (&info);
570 /* Find a default architecture. */
571 if (info.bfd_arch_info == NULL
572 && default_bfd_arch != NULL)
573 info.bfd_arch_info = default_bfd_arch;
574 if (info.bfd_arch_info == NULL)
576 /* Choose the architecture by taking the first one
578 const char *chosen = arches[0];
580 for (arch = arches; *arch != NULL; arch++)
582 if (strcmp (*arch, chosen) < 0)
586 internal_error (__FILE__, __LINE__,
587 "initialize_current_architecture: No arch");
588 info.bfd_arch_info = bfd_scan_arch (chosen);
589 if (info.bfd_arch_info == NULL)
590 internal_error (__FILE__, __LINE__,
591 "initialize_current_architecture: Arch not found");
594 /* Take several guesses at a byte order. */
595 if (info.byte_order == BFD_ENDIAN_UNKNOWN
596 && default_bfd_vec != NULL)
598 /* Extract BFD's default vector's byte order. */
599 switch (default_bfd_vec->byteorder)
602 info.byte_order = BFD_ENDIAN_BIG;
604 case BFD_ENDIAN_LITTLE:
605 info.byte_order = BFD_ENDIAN_LITTLE;
611 if (info.byte_order == BFD_ENDIAN_UNKNOWN)
613 /* look for ``*el-*'' in the target name. */
615 chp = strchr (target_name, '-');
617 && chp - 2 >= target_name
618 && strncmp (chp - 2, "el", 2) == 0)
619 info.byte_order = BFD_ENDIAN_LITTLE;
621 if (info.byte_order == BFD_ENDIAN_UNKNOWN)
623 /* Wire it to big-endian!!! */
624 info.byte_order = BFD_ENDIAN_BIG;
627 if (! gdbarch_update_p (info))
628 internal_error (__FILE__, __LINE__,
629 "initialize_current_architecture: Selection of initial architecture failed");
631 /* Create the ``set architecture'' command appending ``auto'' to the
632 list of architectures. */
634 struct cmd_list_element *c;
635 /* Append ``auto''. */
637 for (nr = 0; arches[nr] != NULL; nr++);
638 arches = xrealloc (arches, sizeof (char*) * (nr + 2));
639 arches[nr + 0] = "auto";
640 arches[nr + 1] = NULL;
641 /* FIXME: add_set_enum_cmd() uses an array of ``char *'' instead
642 of ``const char *''. We just happen to know that the casts are
644 c = add_set_enum_cmd ("architecture", class_support,
645 arches, &set_architecture_string,
646 "Set architecture of target.",
648 set_cmd_sfunc (c, set_architecture);
649 add_alias_cmd ("processor", "architecture", class_support, 1, &setlist);
650 /* Don't use set_from_show - need to print both auto/manual and
652 add_cmd ("architecture", class_support, show_architecture,
653 "Show the current target architecture", &showlist);
658 /* Initialize a gdbarch info to values that will be automatically
659 overridden. Note: Originally, this ``struct info'' was initialized
660 using memset(0). Unfortunately, that ran into problems, namely
661 BFD_ENDIAN_BIG is zero. An explicit initialization function that
662 can explicitly set each field to a well defined value is used. */
665 gdbarch_info_init (struct gdbarch_info *info)
667 memset (info, 0, sizeof (struct gdbarch_info));
668 info->byte_order = BFD_ENDIAN_UNKNOWN;
669 info->osabi = GDB_OSABI_UNINITIALIZED;
672 /* Similar to init, but this time fill in the blanks. Information is
673 obtained from the specified architecture, global "set ..." options,
674 and explicitly initialized INFO fields. */
677 gdbarch_info_fill (struct gdbarch *gdbarch, struct gdbarch_info *info)
679 /* "(gdb) set architecture ...". */
680 if (info->bfd_arch_info == NULL
681 && !target_architecture_auto
683 info->bfd_arch_info = gdbarch_bfd_arch_info (gdbarch);
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 if (info->bfd_arch_info == NULL
691 info->bfd_arch_info = gdbarch_bfd_arch_info (gdbarch);
693 /* "(gdb) set byte-order ...". */
694 if (info->byte_order == BFD_ENDIAN_UNKNOWN
695 && !target_byte_order_auto
697 info->byte_order = gdbarch_byte_order (gdbarch);
698 /* From the INFO struct. */
699 if (info->byte_order == BFD_ENDIAN_UNKNOWN
700 && info->abfd != NULL)
701 info->byte_order = (bfd_big_endian (info->abfd) ? BFD_ENDIAN_BIG
702 : bfd_little_endian (info->abfd) ? BFD_ENDIAN_LITTLE
703 : BFD_ENDIAN_UNKNOWN);
704 /* From the current target. */
705 if (info->byte_order == BFD_ENDIAN_UNKNOWN
707 info->byte_order = gdbarch_byte_order (gdbarch);
709 /* "(gdb) set osabi ...". Handled by gdbarch_lookup_osabi. */
710 if (info->osabi == GDB_OSABI_UNINITIALIZED)
711 info->osabi = gdbarch_lookup_osabi (info->abfd);
712 if (info->osabi == GDB_OSABI_UNINITIALIZED
714 info->osabi = gdbarch_osabi (gdbarch);
716 /* Must have at least filled in the architecture. */
717 gdb_assert (info->bfd_arch_info != NULL);
722 extern initialize_file_ftype _initialize_gdbarch_utils; /* -Wmissing-prototypes */
725 _initialize_gdbarch_utils (void)
727 struct cmd_list_element *c;
728 c = add_set_enum_cmd ("endian", class_support,
729 endian_enum, &set_endian_string,
730 "Set endianness of target.",
732 set_cmd_sfunc (c, set_endian);
733 /* Don't use set_from_show - need to print both auto/manual and
735 add_cmd ("endian", class_support, show_endian,
736 "Show the current byte-order", &showlist);