4fbe042fb5cc067b8f01c8bef1a757b7f3227f30
[external/binutils.git] / gdb / arch-utils.h
1 /* Dynamic architecture support for GDB, the GNU debugger.
2    Copyright 1998, 1999, 2000 Free Software Foundation, Inc.
3
4    This file is part of GDB.
5
6    This program is free software; you can redistribute it and/or modify
7    it under the terms of the GNU General Public License as published by
8    the Free Software Foundation; either version 2 of the License, or
9    (at your option) any later version.
10
11    This program is distributed in the hope that it will be useful,
12    but WITHOUT ANY WARRANTY; without even the implied warranty of
13    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
14    GNU General Public License for more details.
15
16    You should have received a copy of the GNU General Public License
17    along with this program; if not, write to the Free Software
18    Foundation, Inc., 59 Temple Place - Suite 330,
19    Boston, MA 02111-1307, USA.  */
20
21 #ifndef GDBARCH_UTILS_H
22 #define GDBARCH_UTILS_H
23
24 /* gdbarch trace variable */
25 extern int gdbarch_debug;
26
27 /* Fallback for register convertible. */
28 extern gdbarch_register_convertible_ftype generic_register_convertible_not;
29
30 extern CORE_ADDR generic_cannot_extract_struct_value_address (char *dummy);
31
32 /* Helper function for targets that don't know how my arguments are
33    being passed */
34 extern gdbarch_frame_num_args_ftype frame_num_args_unknown;
35
36 /* Implementation of breakpoint from PC using any of the deprecated
37    macros BREAKPOINT, LITTLE_BREAKPOINT, BIG_BREAPOINT.  For legacy
38    targets that don't yet implement their own breakpoint_from_pc(). */
39 extern gdbarch_breakpoint_from_pc_ftype legacy_breakpoint_from_pc;
40
41 /* Frameless functions not identifable. */
42 extern gdbarch_frameless_function_invocation_ftype generic_frameless_function_invocation_not;
43
44 /* Only structures, unions, and arrays are returned using the struct
45    convention.  Note that arrays are never passed by value in the C
46    language family, so that case is irrelevant for C.  */
47 extern gdbarch_return_value_on_stack_ftype generic_return_value_on_stack_not;
48
49 /* Map onto old REGISTER_NAMES. */
50 extern char *legacy_register_name (int i);
51
52 /* Accessor for old global function pointer for disassembly. */
53 extern int legacy_print_insn (bfd_vma vma, disassemble_info *info);
54
55 /* Backward compatible call_dummy_words. */
56 extern LONGEST legacy_call_dummy_words[];
57 extern int legacy_sizeof_call_dummy_words;
58
59 /* Typical remote_translate_xfer_address */
60 extern gdbarch_remote_translate_xfer_address_ftype generic_remote_translate_xfer_address;
61
62 /* Generic implementation of prologue_frameless_p.  Just calls
63    SKIP_PROLOG and checks the return value to see if it actually
64    changed. */
65 extern gdbarch_prologue_frameless_p_ftype generic_prologue_frameless_p;
66
67 /* The only possible cases for inner_than. */
68 extern int core_addr_lessthan (CORE_ADDR lhs, CORE_ADDR rhs);
69 extern int core_addr_greaterthan (CORE_ADDR lhs, CORE_ADDR rhs);
70
71 /* Floating point values. */
72 extern const struct floatformat *default_float_format (struct gdbarch *gdbarch);
73 extern const struct floatformat *default_double_format (struct gdbarch *gdbarch);
74
75 /* Helper function for targets that don't know how my arguments are
76    being passed */
77 extern int frame_num_args_unknown (struct frame_info *fi);
78
79
80 /* The following DEPRECATED interfaces are for pre- multi-arch legacy
81    targets. */
82
83 /* DEPRECATED pre- multi-arch interface.  Explicitly set the dynamic
84    target-system-dependent parameters based on bfd_architecture and
85    machine.  This function is deprecated, use
86    set_gdbarch_from_arch_machine(). */
87
88 extern void set_architecture_from_arch_mach (enum bfd_architecture, unsigned long);
89
90 /* DEPRECATED pre- multi-arch interface.  Notify the target dependent
91    backend of a change to the selected architecture. A zero return
92    status indicates that the target did not like the change. */
93
94 extern int (*target_architecture_hook) (const struct bfd_arch_info *);
95
96
97 /* Default raw->sim register re-numbering - does nothing. */
98
99 extern int default_register_sim_regno (int reg_nr);
100
101 /* Identity function on a CORE_ADDR.  Just returns its parameter.  */
102
103 extern CORE_ADDR core_addr_identity (CORE_ADDR addr);
104
105 /* No-op conversion of reg to regnum. */
106
107 extern int no_op_reg_to_regnum (int reg);
108
109 /* Default frame_args_address and frame_locals_address.  */
110
111 extern CORE_ADDR default_frame_address (struct frame_info *);
112
113 /* Default prepare_to_procced. */
114
115 extern int default_prepare_to_proceed (int select_it);
116
117 extern int generic_prepare_to_proceed (int select_it);
118
119 /* Versions of init_frame_pc().  Do nothing; do the default. */
120
121 void init_frame_pc_noop (int fromleaf, struct frame_info *prev);
122
123 void init_frame_pc_default (int fromleaf, struct frame_info *prev);
124
125 /* Version of cannot_fetch_register() / cannot_store_register() that
126    always fails. */
127
128 int cannot_register_not (int regnum);
129
130 /* Legacy version of target_virtual_frame_pointer().  Assumes that
131    there is an FP_REGNUM and that it is the same, cooked or raw.  */
132
133 extern gdbarch_virtual_frame_pointer_ftype legacy_virtual_frame_pointer;
134
135 extern CORE_ADDR generic_skip_trampoline_code (CORE_ADDR pc);
136
137 extern int generic_in_solib_call_trampoline (CORE_ADDR pc, char *name);
138
139 extern int generic_in_function_epilogue_p (struct gdbarch *gdbarch, CORE_ADDR pc);
140
141 /* Assume all registers are the same size and a size identical to that
142    of the integer type.  */
143 extern int generic_register_raw_size (int regnum);
144
145 /* Assume the virtual size of registers corresponds to the virtual type.  */
146
147 extern int generic_register_virtual_size (int regnum);
148
149 /* Initialize a ``struct info''.  Can't use memset(0) since some
150    default values are not zero.  */
151 extern void gdbarch_info_init (struct gdbarch_info *info);
152
153 #endif