1 /* Dynamic architecture support for GDB, the GNU debugger.
3 Copyright 1998, 1999, 2000, 2001, 2002, 2003, 2004 Free Software
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
);
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
, void *readbuf
,
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_call_trampoline (CORE_ADDR pc
, char *name
)
139 generic_in_solib_return_trampoline (CORE_ADDR pc
, char *name
)
145 generic_in_function_epilogue_p (struct gdbarch
*gdbarch
, CORE_ADDR pc
)
151 generic_remote_translate_xfer_address (struct gdbarch
*gdbarch
,
152 struct regcache
*regcache
,
153 CORE_ADDR gdb_addr
, int gdb_len
,
154 CORE_ADDR
* rem_addr
, int *rem_len
)
156 *rem_addr
= gdb_addr
;
160 /* Helper functions for INNER_THAN */
163 core_addr_lessthan (CORE_ADDR lhs
, CORE_ADDR rhs
)
169 core_addr_greaterthan (CORE_ADDR lhs
, CORE_ADDR rhs
)
175 /* Helper functions for TARGET_{FLOAT,DOUBLE}_FORMAT */
177 const struct floatformat
*
178 default_float_format (struct gdbarch
*gdbarch
)
180 int byte_order
= gdbarch_byte_order (gdbarch
);
184 return &floatformat_ieee_single_big
;
185 case BFD_ENDIAN_LITTLE
:
186 return &floatformat_ieee_single_little
;
188 internal_error (__FILE__
, __LINE__
,
189 "default_float_format: bad byte order");
194 const struct floatformat
*
195 default_double_format (struct gdbarch
*gdbarch
)
197 int byte_order
= gdbarch_byte_order (gdbarch
);
201 return &floatformat_ieee_double_big
;
202 case BFD_ENDIAN_LITTLE
:
203 return &floatformat_ieee_double_little
;
205 internal_error (__FILE__
, __LINE__
,
206 "default_double_format: bad byte order");
210 /* Misc helper functions for targets. */
213 core_addr_identity (CORE_ADDR addr
)
219 convert_from_func_ptr_addr_identity (struct gdbarch
*gdbarch
, CORE_ADDR addr
,
220 struct target_ops
*targ
)
226 no_op_reg_to_regnum (int reg
)
232 deprecated_init_frame_pc_default (int fromleaf
, struct frame_info
*prev
)
234 if (fromleaf
&& DEPRECATED_SAVED_PC_AFTER_CALL_P ())
235 return DEPRECATED_SAVED_PC_AFTER_CALL (get_next_frame (prev
));
236 else if (get_next_frame (prev
) != NULL
)
237 return DEPRECATED_FRAME_SAVED_PC (get_next_frame (prev
));
243 default_elf_make_msymbol_special (asymbol
*sym
, struct minimal_symbol
*msym
)
249 default_coff_make_msymbol_special (int val
, struct minimal_symbol
*msym
)
255 cannot_register_not (int regnum
)
260 /* Legacy version of target_virtual_frame_pointer(). Assumes that
261 there is an DEPRECATED_FP_REGNUM and that it is the same, cooked or
265 legacy_virtual_frame_pointer (CORE_ADDR pc
,
267 LONGEST
*frame_offset
)
269 /* FIXME: cagney/2002-09-13: This code is used when identifying the
270 frame pointer of the current PC. It is assuming that a single
271 register and an offset can determine this. I think it should
272 instead generate a byte code expression as that would work better
273 with things like Dwarf2's CFI. */
274 if (DEPRECATED_FP_REGNUM
>= 0 && DEPRECATED_FP_REGNUM
< NUM_REGS
)
275 *frame_regnum
= DEPRECATED_FP_REGNUM
;
276 else if (SP_REGNUM
>= 0 && SP_REGNUM
< NUM_REGS
)
277 *frame_regnum
= SP_REGNUM
;
279 /* Should this be an internal error? I guess so, it is reflecting
280 an architectural limitation in the current design. */
281 internal_error (__FILE__
, __LINE__
, "No virtual frame pointer available");
285 /* Assume the world is sane, every register's virtual and real size
289 generic_register_size (int regnum
)
291 gdb_assert (regnum
>= 0 && regnum
< NUM_REGS
+ NUM_PSEUDO_REGS
);
292 if (gdbarch_register_type_p (current_gdbarch
))
293 return TYPE_LENGTH (gdbarch_register_type (current_gdbarch
, regnum
));
295 /* FIXME: cagney/2003-03-01: Once all architectures implement
296 gdbarch_register_type(), this entire function can go away. It
297 is made obsolete by register_size(). */
298 return TYPE_LENGTH (DEPRECATED_REGISTER_VIRTUAL_TYPE (regnum
)); /* OK */
301 /* Assume all registers are adjacent. */
304 generic_register_byte (int regnum
)
308 gdb_assert (regnum
>= 0 && regnum
< NUM_REGS
+ NUM_PSEUDO_REGS
);
310 for (i
= 0; i
< regnum
; i
++)
312 byte
+= generic_register_size (i
);
319 legacy_pc_in_sigtramp (CORE_ADDR pc
, char *name
)
321 #if defined (DEPRECATED_IN_SIGTRAMP)
322 return DEPRECATED_IN_SIGTRAMP (pc
, name
);
324 return name
&& strcmp ("_sigtramp", name
) == 0;
329 generic_convert_register_p (int regnum
, struct type
*type
)
335 default_stabs_argument_has_addr (struct gdbarch
*gdbarch
, struct type
*type
)
337 if (DEPRECATED_REG_STRUCT_HAS_ADDR_P ()
338 && DEPRECATED_REG_STRUCT_HAS_ADDR (processing_gcc_compilation
, type
))
340 CHECK_TYPEDEF (type
);
342 return (TYPE_CODE (type
) == TYPE_CODE_STRUCT
343 || TYPE_CODE (type
) == TYPE_CODE_UNION
344 || TYPE_CODE (type
) == TYPE_CODE_SET
345 || TYPE_CODE (type
) == TYPE_CODE_BITSTRING
);
352 /* Functions to manipulate the endianness of the target. */
354 /* ``target_byte_order'' is only used when non- multi-arch.
355 Multi-arch targets obtain the current byte order using the
356 TARGET_BYTE_ORDER gdbarch method.
358 The choice of initial value is entirely arbitrary. During startup,
359 the function initialize_current_architecture() updates this value
360 based on default byte-order information extracted from BFD. */
361 static int target_byte_order
= BFD_ENDIAN_BIG
;
362 static int target_byte_order_auto
= 1;
365 selected_byte_order (void)
367 if (target_byte_order_auto
)
368 return BFD_ENDIAN_UNKNOWN
;
370 return target_byte_order
;
373 static const char endian_big
[] = "big";
374 static const char endian_little
[] = "little";
375 static const char endian_auto
[] = "auto";
376 static const char *endian_enum
[] =
383 static const char *set_endian_string
;
385 /* Called by ``show endian''. */
388 show_endian (char *args
, int from_tty
)
390 if (target_byte_order_auto
)
391 printf_unfiltered ("The target endianness is set automatically (currently %s endian)\n",
392 (TARGET_BYTE_ORDER
== BFD_ENDIAN_BIG
? "big" : "little"));
394 printf_unfiltered ("The target is assumed to be %s endian\n",
395 (TARGET_BYTE_ORDER
== BFD_ENDIAN_BIG
? "big" : "little"));
399 set_endian (char *ignore_args
, int from_tty
, struct cmd_list_element
*c
)
401 if (set_endian_string
== endian_auto
)
403 target_byte_order_auto
= 1;
405 else if (set_endian_string
== endian_little
)
407 struct gdbarch_info info
;
408 target_byte_order_auto
= 0;
409 gdbarch_info_init (&info
);
410 info
.byte_order
= BFD_ENDIAN_LITTLE
;
411 if (! gdbarch_update_p (info
))
412 printf_unfiltered ("Little endian target not supported by GDB\n");
414 else if (set_endian_string
== endian_big
)
416 struct gdbarch_info info
;
417 target_byte_order_auto
= 0;
418 gdbarch_info_init (&info
);
419 info
.byte_order
= BFD_ENDIAN_BIG
;
420 if (! gdbarch_update_p (info
))
421 printf_unfiltered ("Big endian target not supported by GDB\n");
424 internal_error (__FILE__
, __LINE__
,
425 "set_endian: bad value");
426 show_endian (NULL
, from_tty
);
429 /* Functions to manipulate the architecture of the target */
431 enum set_arch
{ set_arch_auto
, set_arch_manual
};
433 static int target_architecture_auto
= 1;
435 static const char *set_architecture_string
;
438 selected_architecture_name (void)
440 if (target_architecture_auto
)
443 return set_architecture_string
;
446 /* Called if the user enters ``show architecture'' without an
450 show_architecture (char *args
, int from_tty
)
453 arch
= TARGET_ARCHITECTURE
->printable_name
;
454 if (target_architecture_auto
)
455 printf_filtered ("The target architecture is set automatically (currently %s)\n", arch
);
457 printf_filtered ("The target architecture is assumed to be %s\n", arch
);
461 /* Called if the user enters ``set architecture'' with or without an
465 set_architecture (char *ignore_args
, int from_tty
, struct cmd_list_element
*c
)
467 if (strcmp (set_architecture_string
, "auto") == 0)
469 target_architecture_auto
= 1;
473 struct gdbarch_info info
;
474 gdbarch_info_init (&info
);
475 info
.bfd_arch_info
= bfd_scan_arch (set_architecture_string
);
476 if (info
.bfd_arch_info
== NULL
)
477 internal_error (__FILE__
, __LINE__
,
478 "set_architecture: bfd_scan_arch failed");
479 if (gdbarch_update_p (info
))
480 target_architecture_auto
= 0;
482 printf_unfiltered ("Architecture `%s' not recognized.\n",
483 set_architecture_string
);
485 show_architecture (NULL
, from_tty
);
488 /* Try to select a global architecture that matches "info". Return
489 non-zero if the attempt succeds. */
491 gdbarch_update_p (struct gdbarch_info info
)
493 struct gdbarch
*new_gdbarch
= gdbarch_find_by_info (info
);
495 /* If there no architecture by that name, reject the request. */
496 if (new_gdbarch
== NULL
)
499 fprintf_unfiltered (gdb_stdlog
, "gdbarch_update_p: "
500 "Architecture not found\n");
504 /* If it is the same old architecture, accept the request (but don't
506 if (new_gdbarch
== current_gdbarch
)
509 fprintf_unfiltered (gdb_stdlog
, "gdbarch_update_p: "
510 "Architecture 0x%08lx (%s) unchanged\n",
512 gdbarch_bfd_arch_info (new_gdbarch
)->printable_name
);
516 /* It's a new architecture, swap it in. */
518 fprintf_unfiltered (gdb_stdlog
, "gdbarch_update_p: "
519 "New architecture 0x%08lx (%s) selected\n",
521 gdbarch_bfd_arch_info (new_gdbarch
)->printable_name
);
522 deprecated_current_gdbarch_select_hack (new_gdbarch
);
527 /* Return the architecture for ABFD. If no suitable architecture
528 could be find, return NULL. */
531 gdbarch_from_bfd (bfd
*abfd
)
533 struct gdbarch
*old_gdbarch
= current_gdbarch
;
534 struct gdbarch
*new_gdbarch
;
535 struct gdbarch_info info
;
537 gdbarch_info_init (&info
);
539 return gdbarch_find_by_info (info
);
542 /* Set the dynamic target-system-dependent parameters (architecture,
543 byte-order) using information found in the BFD */
546 set_gdbarch_from_file (bfd
*abfd
)
548 struct gdbarch
*gdbarch
;
550 gdbarch
= gdbarch_from_bfd (abfd
);
552 error ("Architecture of file not recognized.\n");
553 deprecated_current_gdbarch_select_hack (gdbarch
);
556 /* Initialize the current architecture. Update the ``set
557 architecture'' command so that it specifies a list of valid
560 #ifdef DEFAULT_BFD_ARCH
561 extern const bfd_arch_info_type DEFAULT_BFD_ARCH
;
562 static const bfd_arch_info_type
*default_bfd_arch
= &DEFAULT_BFD_ARCH
;
564 static const bfd_arch_info_type
*default_bfd_arch
;
567 #ifdef DEFAULT_BFD_VEC
568 extern const bfd_target DEFAULT_BFD_VEC
;
569 static const bfd_target
*default_bfd_vec
= &DEFAULT_BFD_VEC
;
571 static const bfd_target
*default_bfd_vec
;
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 (info
.bfd_arch_info
== NULL
585 && default_bfd_arch
!= NULL
)
586 info
.bfd_arch_info
= default_bfd_arch
;
587 if (info
.bfd_arch_info
== NULL
)
589 /* Choose the architecture by taking the first one
591 const char *chosen
= arches
[0];
593 for (arch
= arches
; *arch
!= NULL
; arch
++)
595 if (strcmp (*arch
, chosen
) < 0)
599 internal_error (__FILE__
, __LINE__
,
600 "initialize_current_architecture: No arch");
601 info
.bfd_arch_info
= bfd_scan_arch (chosen
);
602 if (info
.bfd_arch_info
== NULL
)
603 internal_error (__FILE__
, __LINE__
,
604 "initialize_current_architecture: Arch not found");
607 /* Take several guesses at a byte order. */
608 if (info
.byte_order
== BFD_ENDIAN_UNKNOWN
609 && default_bfd_vec
!= NULL
)
611 /* Extract BFD's default vector's byte order. */
612 switch (default_bfd_vec
->byteorder
)
615 info
.byte_order
= BFD_ENDIAN_BIG
;
617 case BFD_ENDIAN_LITTLE
:
618 info
.byte_order
= BFD_ENDIAN_LITTLE
;
624 if (info
.byte_order
== BFD_ENDIAN_UNKNOWN
)
626 /* look for ``*el-*'' in the target name. */
628 chp
= strchr (target_name
, '-');
630 && chp
- 2 >= target_name
631 && strncmp (chp
- 2, "el", 2) == 0)
632 info
.byte_order
= BFD_ENDIAN_LITTLE
;
634 if (info
.byte_order
== BFD_ENDIAN_UNKNOWN
)
636 /* Wire it to big-endian!!! */
637 info
.byte_order
= BFD_ENDIAN_BIG
;
640 if (! gdbarch_update_p (info
))
641 internal_error (__FILE__
, __LINE__
,
642 "initialize_current_architecture: Selection of initial architecture failed");
644 /* Create the ``set architecture'' command appending ``auto'' to the
645 list of architectures. */
647 struct cmd_list_element
*c
;
648 /* Append ``auto''. */
650 for (nr
= 0; arches
[nr
] != NULL
; nr
++);
651 arches
= xrealloc (arches
, sizeof (char*) * (nr
+ 2));
652 arches
[nr
+ 0] = "auto";
653 arches
[nr
+ 1] = NULL
;
654 /* FIXME: add_set_enum_cmd() uses an array of ``char *'' instead
655 of ``const char *''. We just happen to know that the casts are
657 c
= add_set_enum_cmd ("architecture", class_support
,
658 arches
, &set_architecture_string
,
659 "Set architecture of target.",
661 set_cmd_sfunc (c
, set_architecture
);
662 add_alias_cmd ("processor", "architecture", class_support
, 1, &setlist
);
663 /* Don't use set_from_show - need to print both auto/manual and
665 add_cmd ("architecture", class_support
, show_architecture
,
666 "Show the current target architecture", &showlist
);
671 /* Initialize a gdbarch info to values that will be automatically
672 overridden. Note: Originally, this ``struct info'' was initialized
673 using memset(0). Unfortunately, that ran into problems, namely
674 BFD_ENDIAN_BIG is zero. An explicit initialization function that
675 can explicitly set each field to a well defined value is used. */
678 gdbarch_info_init (struct gdbarch_info
*info
)
680 memset (info
, 0, sizeof (struct gdbarch_info
));
681 info
->byte_order
= BFD_ENDIAN_UNKNOWN
;
682 info
->osabi
= GDB_OSABI_UNINITIALIZED
;
685 /* Similar to init, but this time fill in the blanks. Information is
686 obtained from the specified architecture, global "set ..." options,
687 and explicitly initialized INFO fields. */
690 gdbarch_info_fill (struct gdbarch
*gdbarch
, struct gdbarch_info
*info
)
692 /* "(gdb) set architecture ...". */
693 if (info
->bfd_arch_info
== NULL
694 && !target_architecture_auto
696 info
->bfd_arch_info
= gdbarch_bfd_arch_info (gdbarch
);
697 if (info
->bfd_arch_info
== NULL
698 && info
->abfd
!= NULL
699 && bfd_get_arch (info
->abfd
) != bfd_arch_unknown
700 && bfd_get_arch (info
->abfd
) != bfd_arch_obscure
)
701 info
->bfd_arch_info
= bfd_get_arch_info (info
->abfd
);
702 if (info
->bfd_arch_info
== NULL
704 info
->bfd_arch_info
= gdbarch_bfd_arch_info (gdbarch
);
706 /* "(gdb) set byte-order ...". */
707 if (info
->byte_order
== BFD_ENDIAN_UNKNOWN
708 && !target_byte_order_auto
710 info
->byte_order
= gdbarch_byte_order (gdbarch
);
711 /* From the INFO struct. */
712 if (info
->byte_order
== BFD_ENDIAN_UNKNOWN
713 && info
->abfd
!= NULL
)
714 info
->byte_order
= (bfd_big_endian (info
->abfd
) ? BFD_ENDIAN_BIG
715 : bfd_little_endian (info
->abfd
) ? BFD_ENDIAN_LITTLE
716 : BFD_ENDIAN_UNKNOWN
);
717 /* From the current target. */
718 if (info
->byte_order
== BFD_ENDIAN_UNKNOWN
720 info
->byte_order
= gdbarch_byte_order (gdbarch
);
722 /* "(gdb) set osabi ...". Handled by gdbarch_lookup_osabi. */
723 if (info
->osabi
== GDB_OSABI_UNINITIALIZED
)
724 info
->osabi
= gdbarch_lookup_osabi (info
->abfd
);
725 if (info
->osabi
== GDB_OSABI_UNINITIALIZED
727 info
->osabi
= gdbarch_osabi (gdbarch
);
729 /* Must have at least filled in the architecture. */
730 gdb_assert (info
->bfd_arch_info
!= NULL
);
735 extern initialize_file_ftype _initialize_gdbarch_utils
; /* -Wmissing-prototypes */
738 _initialize_gdbarch_utils (void)
740 struct cmd_list_element
*c
;
741 c
= add_set_enum_cmd ("endian", class_support
,
742 endian_enum
, &set_endian_string
,
743 "Set endianness of target.",
745 set_cmd_sfunc (c
, set_endian
);
746 /* Don't use set_from_show - need to print both auto/manual and
748 add_cmd ("endian", class_support
, show_endian
,
749 "Show the current byte-order", &showlist
);