1 /* Dynamic architecture support for GDB, the GNU debugger.
3 Copyright 1998, 1999, 2000, 2002 Free Software Foundation, Inc.
5 This file is part of GDB.
7 This program is free software; you can redistribute it and/or modify
8 it under the terms of the GNU General Public License as published by
9 the Free Software Foundation; either version 2 of the License, or
10 (at your option) any later version.
12 This program is distributed in the hope that it will be useful,
13 but WITHOUT ANY WARRANTY; without even the implied warranty of
14 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 GNU General Public License for more details.
17 You should have received a copy of the GNU General Public License
18 along with this program; if not, write to the Free Software
19 Foundation, Inc., 59 Temple Place - Suite 330,
20 Boston, MA 02111-1307, USA. */
22 #ifndef GDBARCH_UTILS_H
23 #define GDBARCH_UTILS_H
25 /* gdbarch trace variable */
26 extern int gdbarch_debug
;
28 /* Fallback for register convertible. */
29 extern gdbarch_register_convertible_ftype generic_register_convertible_not
;
31 extern CORE_ADDR
generic_cannot_extract_struct_value_address (char *dummy
);
33 /* Helper function for targets that don't know how my arguments are
35 extern gdbarch_frame_num_args_ftype frame_num_args_unknown
;
37 /* Implementation of breakpoint from PC using any of the deprecated
38 macros BREAKPOINT, LITTLE_BREAKPOINT, BIG_BREAPOINT. For legacy
39 targets that don't yet implement their own breakpoint_from_pc(). */
40 extern gdbarch_breakpoint_from_pc_ftype legacy_breakpoint_from_pc
;
42 /* Implementation of extract return value that grubs around in the
44 extern gdbarch_extract_return_value_ftype legacy_extract_return_value
;
46 /* Implementation of store return value that grubs the register cache. */
47 extern gdbarch_store_return_value_ftype legacy_store_return_value
;
49 /* Frameless functions not identifable. */
50 extern gdbarch_frameless_function_invocation_ftype generic_frameless_function_invocation_not
;
52 /* Only structures, unions, and arrays are returned using the struct
53 convention. Note that arrays are never passed by value in the C
54 language family, so that case is irrelevant for C. */
55 extern gdbarch_return_value_on_stack_ftype generic_return_value_on_stack_not
;
57 /* Map onto old REGISTER_NAMES. */
58 extern const char *legacy_register_name (int i
);
60 /* Accessor for old global function pointer for disassembly. */
61 extern int legacy_print_insn (bfd_vma vma
, disassemble_info
*info
);
63 /* Backward compatible call_dummy_words. */
64 extern LONGEST legacy_call_dummy_words
[];
65 extern int legacy_sizeof_call_dummy_words
;
67 /* Typical remote_translate_xfer_address */
68 extern gdbarch_remote_translate_xfer_address_ftype generic_remote_translate_xfer_address
;
70 /* Generic implementation of prologue_frameless_p. Just calls
71 SKIP_PROLOG and checks the return value to see if it actually
73 extern gdbarch_prologue_frameless_p_ftype generic_prologue_frameless_p
;
75 /* The only possible cases for inner_than. */
76 extern int core_addr_lessthan (CORE_ADDR lhs
, CORE_ADDR rhs
);
77 extern int core_addr_greaterthan (CORE_ADDR lhs
, CORE_ADDR rhs
);
79 /* Floating point values. */
80 extern const struct floatformat
*default_float_format (struct gdbarch
*gdbarch
);
81 extern const struct floatformat
*default_double_format (struct gdbarch
*gdbarch
);
83 /* Helper function for targets that don't know how my arguments are
85 extern int frame_num_args_unknown (struct frame_info
*fi
);
88 /* The following DEPRECATED interfaces are for pre- multi-arch legacy
91 /* DEPRECATED pre- multi-arch interface. Explicitly set the dynamic
92 target-system-dependent parameters based on bfd_architecture and
93 machine. This function is deprecated, use
94 set_gdbarch_from_arch_machine(). */
96 extern void set_architecture_from_arch_mach (enum bfd_architecture
, unsigned long);
98 /* DEPRECATED pre- multi-arch interface. Notify the target dependent
99 backend of a change to the selected architecture. A zero return
100 status indicates that the target did not like the change. */
102 extern int (*target_architecture_hook
) (const struct bfd_arch_info
*);
104 /* Identity function on a CORE_ADDR. Just returns its parameter. */
106 extern CORE_ADDR
core_addr_identity (CORE_ADDR addr
);
108 /* No-op conversion of reg to regnum. */
110 extern int no_op_reg_to_regnum (int reg
);
112 /* Default frame_args_address and frame_locals_address. */
114 extern CORE_ADDR
default_frame_address (struct frame_info
*);
116 /* Default prepare_to_procced. */
118 extern int default_prepare_to_proceed (int select_it
);
120 extern int generic_prepare_to_proceed (int select_it
);
122 /* Versions of init_frame_pc(). Do nothing; do the default. */
124 void init_frame_pc_noop (int fromleaf
, struct frame_info
*prev
);
126 void init_frame_pc_default (int fromleaf
, struct frame_info
*prev
);
128 /* Do nothing version of elf_make_msymbol_special. */
130 void default_elf_make_msymbol_special (asymbol
*sym
, struct minimal_symbol
*msym
);
132 /* Do nothing version of coff_make_msymbol_special. */
134 void default_coff_make_msymbol_special (int val
, struct minimal_symbol
*msym
);
136 /* Version of cannot_fetch_register() / cannot_store_register() that
139 int cannot_register_not (int regnum
);
141 /* Legacy version of target_virtual_frame_pointer(). Assumes that
142 there is an FP_REGNUM and that it is the same, cooked or raw. */
144 extern gdbarch_virtual_frame_pointer_ftype legacy_virtual_frame_pointer
;
146 extern CORE_ADDR
generic_skip_trampoline_code (CORE_ADDR pc
);
148 extern int generic_in_solib_call_trampoline (CORE_ADDR pc
, char *name
);
150 extern int generic_in_solib_return_trampoline (CORE_ADDR pc
, char *name
);
152 extern int generic_in_function_epilogue_p (struct gdbarch
*gdbarch
, CORE_ADDR pc
);
154 /* Assume that the world is sane, a registers raw and virtual size
155 both match its type. */
157 extern int generic_register_size (int regnum
);
159 /* Assume that the world is sane, the registers are all adjacent. */
160 extern int generic_register_byte (int regnum
);
162 /* Prop up old targets that use various IN_SIGTRAMP() macros. */
163 extern int legacy_pc_in_sigtramp (CORE_ADDR pc
, char *name
);
165 /* The orginal register_convert*() functions were overloaded. They
166 were used to both: convert between virtual and raw register formats
167 (something that is discouraged); and to convert a register to the
168 type of a corresponding variable. These legacy functions preserve
169 that overloaded behavour in existing targets. */
170 extern int legacy_convert_register_p (int regnum
);
171 extern void legacy_register_to_value (int regnum
, struct type
*type
, char *from
, char *to
);
172 extern void legacy_value_to_register (struct type
*type
, int regnum
, char *from
, char *to
);
174 /* For compatibility with older architectures, returns
175 (LEGACY_SIM_REGNO_IGNORE) when the register doesn't have a valid
178 extern int legacy_register_sim_regno (int regnum
);
180 /* Initialize a ``struct info''. Can't use memset(0) since some
181 default values are not zero. */
182 extern void gdbarch_info_init (struct gdbarch_info
*info
);