gdb/arch-utils.h

   1 /* Dynamic architecture support for GDB, the GNU debugger.
   2
   3    Copyright 1998, 1999, 2000, 2002 Free Software Foundation, Inc.
   4
   5    This file is part of GDB.
   6
   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.
  11
  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.
  16
  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.  */
  21
  22 #ifndef GDBARCH_UTILS_H
  23 #define GDBARCH_UTILS_H
  24
  25 /* gdbarch trace variable */
  26 extern int gdbarch_debug;
  27
  28 /* Fallback for register convertible. */
  29 extern gdbarch_register_convertible_ftype generic_register_convertible_not;
  30
  31 extern CORE_ADDR generic_cannot_extract_struct_value_address (char *dummy);
  32
  33 /* Helper function for targets that don't know how my arguments are
  34    being passed */
  35 extern gdbarch_frame_num_args_ftype frame_num_args_unknown;
  36
  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;
  41
  42 /* Implementation of extract return value that grubs around in the
  43    register cache.  */
  44 extern gdbarch_extract_return_value_ftype legacy_extract_return_value;
  45
  46 /* Frameless functions not identifable. */
  47 extern gdbarch_frameless_function_invocation_ftype generic_frameless_function_invocation_not;
  48
  49 /* Only structures, unions, and arrays are returned using the struct
  50    convention.  Note that arrays are never passed by value in the C
  51    language family, so that case is irrelevant for C.  */
  52 extern gdbarch_return_value_on_stack_ftype generic_return_value_on_stack_not;
  53
  54 /* Map onto old REGISTER_NAMES. */
  55 extern const char *legacy_register_name (int i);
  56
  57 /* Accessor for old global function pointer for disassembly. */
  58 extern int legacy_print_insn (bfd_vma vma, disassemble_info *info);
  59
  60 /* Backward compatible call_dummy_words. */
  61 extern LONGEST legacy_call_dummy_words[];
  62 extern int legacy_sizeof_call_dummy_words;
  63
  64 /* Typical remote_translate_xfer_address */
  65 extern gdbarch_remote_translate_xfer_address_ftype generic_remote_translate_xfer_address;
  66
  67 /* Generic implementation of prologue_frameless_p.  Just calls
  68    SKIP_PROLOG and checks the return value to see if it actually
  69    changed. */
  70 extern gdbarch_prologue_frameless_p_ftype generic_prologue_frameless_p;
  71
  72 /* The only possible cases for inner_than. */
  73 extern int core_addr_lessthan (CORE_ADDR lhs, CORE_ADDR rhs);
  74 extern int core_addr_greaterthan (CORE_ADDR lhs, CORE_ADDR rhs);
  75
  76 /* Floating point values. */
  77 extern const struct floatformat *default_float_format (struct gdbarch *gdbarch);
  78 extern const struct floatformat *default_double_format (struct gdbarch *gdbarch);
  79
  80 /* Helper function for targets that don't know how my arguments are
  81    being passed */
  82 extern int frame_num_args_unknown (struct frame_info *fi);
  83
  84
  85 /* The following DEPRECATED interfaces are for pre- multi-arch legacy
  86    targets. */
  87
  88 /* DEPRECATED pre- multi-arch interface.  Explicitly set the dynamic
  89    target-system-dependent parameters based on bfd_architecture and
  90    machine.  This function is deprecated, use
  91    set_gdbarch_from_arch_machine(). */
  92
  93 extern void set_architecture_from_arch_mach (enum bfd_architecture, unsigned long);
  94
  95 /* DEPRECATED pre- multi-arch interface.  Notify the target dependent
  96    backend of a change to the selected architecture. A zero return
  97    status indicates that the target did not like the change. */
  98
  99 extern int (*target_architecture_hook) (const struct bfd_arch_info *);
 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 /* Do nothing version of elf_make_msymbol_special. */
 126
 127 void default_elf_make_msymbol_special (asymbol *sym, struct minimal_symbol *msym);
 128
 129 /* Do nothing version of coff_make_msymbol_special. */
 130
 131 void default_coff_make_msymbol_special (int val, struct minimal_symbol *msym);
 132
 133 /* Version of cannot_fetch_register() / cannot_store_register() that
 134    always fails. */
 135
 136 int cannot_register_not (int regnum);
 137
 138 /* Legacy version of target_virtual_frame_pointer().  Assumes that
 139    there is an FP_REGNUM and that it is the same, cooked or raw.  */
 140
 141 extern gdbarch_virtual_frame_pointer_ftype legacy_virtual_frame_pointer;
 142
 143 extern CORE_ADDR generic_skip_trampoline_code (CORE_ADDR pc);
 144
 145 extern int generic_in_solib_call_trampoline (CORE_ADDR pc, char *name);
 146
 147 extern int generic_in_function_epilogue_p (struct gdbarch *gdbarch, CORE_ADDR pc);
 148
 149 extern void default_print_float_info (struct gdbarch *gdbarch,
 150                                       struct ui_file *file,
 151                                       struct frame_info *frame);
 152
 153 /* Assume that the world is sane, a registers raw and virtual size
 154    both match its type.  */
 155
 156 extern int generic_register_size (int regnum);
 157
 158 /* Prop up old targets that use various IN_SIGTRAMP() macros.  */
 159 extern int legacy_pc_in_sigtramp (CORE_ADDR pc, char *name);
 160
 161 /* The orginal register_convert*() functions were overloaded.  They
 162    were used to both: convert between virtual and raw register formats
 163    (something that is discouraged); and to convert a register to the
 164    type of a corresponding variable.  These legacy functions preserve
 165    that overloaded behavour in existing targets.  */
 166 extern int legacy_convert_register_p (int regnum);
 167 extern void legacy_register_to_value (int regnum, struct type *type, char *from, char *to);
 168 extern void legacy_value_to_register (struct type *type, int regnum, char *from, char *to);
 169
 170 /* For compatibility with older architectures, returns
 171    (LEGACY_SIM_REGNO_IGNORE) when the register doesn't have a valid
 172    name.  */
 173
 174 extern int legacy_register_sim_regno (int regnum);
 175
 176 /* Initialize a ``struct info''.  Can't use memset(0) since some
 177    default values are not zero.  */
 178 extern void gdbarch_info_init (struct gdbarch_info *info);
 179
 180 #endif