/* Dynamic architecture support for GDB, the GNU debugger.
- Copyright 1998, 1999, 2000 Free Software Foundation, Inc.
+
+ Copyright 1998, 1999, 2000, 2002 Free Software Foundation, Inc.
This file is part of GDB.
#ifndef GDBARCH_UTILS_H
#define GDBARCH_UTILS_H
+struct gdbarch;
+struct frame_info;
+struct minimal_symbol;
+struct type;
+struct gdbarch_info;
+
/* gdbarch trace variable */
extern int gdbarch_debug;
/* Fallback for register convertible. */
-extern gdbarch_register_convertible_ftype generic_register_convertible_not;
+extern gdbarch_deprecated_register_convertible_ftype deprecated_register_convertible_not;
+
+extern CORE_ADDR generic_cannot_extract_struct_value_address (char *dummy);
+
+/* Implementation of extract return value that grubs around in the
+ register cache. */
+extern gdbarch_extract_return_value_ftype legacy_extract_return_value;
-/* Helper function for targets that don't know how my arguments are
- being passed */
-extern gdbarch_frame_num_args_ftype frame_num_args_unknown;
+/* Implementation of store return value that grubs the register cache. */
+extern gdbarch_store_return_value_ftype legacy_store_return_value;
-/* Implementation of breakpoint from PC using any of the deprecated
- macros BREAKPOINT, LITTLE_BREAKPOINT, BIG_BREAPOINT. For legacy
- targets that don't yet implement their own breakpoint_from_pc(). */
-extern gdbarch_breakpoint_from_pc_ftype legacy_breakpoint_from_pc;
+/* To return any structure or union type by value, store it at the
+ address passed as an invisible first argument to the function. */
+extern gdbarch_use_struct_convention_ftype always_use_struct_convention;
/* Frameless functions not identifable. */
extern gdbarch_frameless_function_invocation_ftype generic_frameless_function_invocation_not;
language family, so that case is irrelevant for C. */
extern gdbarch_return_value_on_stack_ftype generic_return_value_on_stack_not;
-/* Map onto old REGISTER_NAMES. */
-extern char *legacy_register_name (int i);
-
/* Accessor for old global function pointer for disassembly. */
extern int legacy_print_insn (bfd_vma vma, disassemble_info *info);
extern const struct floatformat *default_float_format (struct gdbarch *gdbarch);
extern const struct floatformat *default_double_format (struct gdbarch *gdbarch);
-/* Helper function for targets that don't know how my arguments are
- being passed */
-extern int frame_num_args_unknown (struct frame_info *fi);
+/* Identity function on a CORE_ADDR. Just returns its parameter. */
+extern CORE_ADDR core_addr_identity (CORE_ADDR addr);
-/* The following DEPRECATED interfaces are for pre- multi-arch legacy
- targets. */
+/* No-op conversion of reg to regnum. */
-/* DEPRECATED pre- multi-arch interface. Explicitly set the dynamic
- target-system-dependent parameters based on bfd_architecture and
- machine. This function is deprecated, use
- set_gdbarch_from_arch_machine(). */
+extern int no_op_reg_to_regnum (int reg);
-extern void set_architecture_from_arch_mach (enum bfd_architecture, unsigned long);
+/* Versions of init_frame_pc(). Do nothing; do the default. */
-/* DEPRECATED pre- multi-arch interface. Notify the target dependent
- backend of a change to the selected architecture. A zero return
- status indicates that the target did not like the change. */
+extern CORE_ADDR init_frame_pc_noop (int fromleaf, struct frame_info *prev);
-extern int (*target_architecture_hook) (const struct bfd_arch_info *);
+extern CORE_ADDR init_frame_pc_default (int fromleaf, struct frame_info *prev);
+/* Do nothing version of elf_make_msymbol_special. */
-/* Default raw->sim register re-numbering - does nothing. */
+void default_elf_make_msymbol_special (asymbol *sym, struct minimal_symbol *msym);
-extern int default_register_sim_regno (int reg_nr);
+/* Do nothing version of coff_make_msymbol_special. */
-/* Identity function on a CORE_ADDR. Just returns its parameter. */
+void default_coff_make_msymbol_special (int val, struct minimal_symbol *msym);
-extern CORE_ADDR core_addr_identity (CORE_ADDR addr);
+/* Version of cannot_fetch_register() / cannot_store_register() that
+ always fails. */
-/* No-op conversion of reg to regnum. */
+int cannot_register_not (int regnum);
-extern int no_op_reg_to_regnum (int reg);
+/* Legacy version of target_virtual_frame_pointer(). Assumes that
+ there is an DEPRECATED_FP_REGNUM and that it is the same, cooked or
+ raw. */
-/* Default frame_args_address and frame_locals_address. */
+extern gdbarch_virtual_frame_pointer_ftype legacy_virtual_frame_pointer;
-extern CORE_ADDR default_frame_address (struct frame_info *);
+extern CORE_ADDR generic_skip_trampoline_code (CORE_ADDR pc);
-/* Default prepare_to_procced. */
+extern int generic_in_solib_call_trampoline (CORE_ADDR pc, char *name);
-extern int default_prepare_to_proceed (int select_it);
+extern int generic_in_solib_return_trampoline (CORE_ADDR pc, char *name);
-extern int generic_prepare_to_proceed (int select_it);
+extern int generic_in_function_epilogue_p (struct gdbarch *gdbarch, CORE_ADDR pc);
-/* Versions of init_frame_pc(). Do nothing; do the default. */
+/* Assume that the world is sane, a registers raw and virtual size
+ both match its type. */
-void init_frame_pc_noop (int fromleaf, struct frame_info *prev);
+extern int generic_register_size (int regnum);
-void init_frame_pc_default (int fromleaf, struct frame_info *prev);
+/* Assume that the world is sane, the registers are all adjacent. */
+extern int generic_register_byte (int regnum);
-/* Version of cannot_fetch_register() / cannot_store_register() that
- always fails. */
+/* Prop up old targets that use various IN_SIGTRAMP() macros. */
+extern int legacy_pc_in_sigtramp (CORE_ADDR pc, char *name);
-int cannot_register_not (int regnum);
+/* The orginal register_convert*() functions were overloaded. They
+ were used to both: convert between virtual and raw register formats
+ (something that is discouraged); and to convert a register to the
+ type of a corresponding variable. These legacy functions preserve
+ that overloaded behavour in existing targets. */
+extern int legacy_convert_register_p (int regnum, struct type *type);
+extern void legacy_register_to_value (struct frame_info *frame, int regnum,
+ struct type *type, void *to);
+extern void legacy_value_to_register (struct frame_info *frame, int regnum,
+ struct type *type, const void *from);
-/* Legacy version of target_virtual_frame_pointer(). Assumes that
- there is an FP_REGNUM and that it is the same, cooked or raw. */
+/* For compatibility with older architectures, returns
+ (LEGACY_SIM_REGNO_IGNORE) when the register doesn't have a valid
+ name. */
-extern gdbarch_virtual_frame_pointer_ftype legacy_virtual_frame_pointer;
+extern int legacy_register_sim_regno (int regnum);
-extern CORE_ADDR generic_skip_trampoline_code (CORE_ADDR pc);
+/* Initialize a ``struct info''. Can't use memset(0) since some
+ default values are not zero. */
+extern void gdbarch_info_init (struct gdbarch_info *info);
#endif