GDB (xrefs)
/tmp/gdb-7.10/gdb/arch-utils.h
Go to the documentation of this file.
1 /* Dynamic architecture support for GDB, the GNU debugger.
2 
3  Copyright (C) 1998-2015 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 3 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, see <http://www.gnu.org/licenses/>. */
19 
20 #ifndef GDBARCH_UTILS_H
21 #define GDBARCH_UTILS_H
22 
23 struct gdbarch;
24 struct frame_info;
25 struct minimal_symbol;
26 struct type;
27 struct gdbarch_info;
28 
29 /* An implementation of gdbarch_displaced_step_copy_insn for
30  processors that don't need to modify the instruction before
31  single-stepping the displaced copy.
32 
33  Simply copy gdbarch_max_insn_length (ARCH) bytes from FROM to TO.
34  The closure is an array of that many bytes containing the
35  instruction's bytes, allocated with xmalloc. */
36 extern struct displaced_step_closure *
39  struct regcache *regs);
40 
41 /* Simple implementation of gdbarch_displaced_step_free_closure: Call
42  xfree.
43  This is appropriate for use with simple_displaced_step_copy_insn. */
44 extern void
46  struct displaced_step_closure *closure);
47 
48 /* Default implementation of gdbarch_displaced_hw_singlestep. */
49 extern int
51  struct displaced_step_closure *);
52 
53 /* Possible value for gdbarch_displaced_step_location:
54  Place displaced instructions at the program's entry point,
55  leaving space for inferior function call return breakpoints. */
57 
58 /* The only possible cases for inner_than. */
59 extern int core_addr_lessthan (CORE_ADDR lhs, CORE_ADDR rhs);
60 extern int core_addr_greaterthan (CORE_ADDR lhs, CORE_ADDR rhs);
61 
62 /* Identity functions on a CORE_ADDR. Just return the "addr". */
63 
66 
67 /* No-op conversion of reg to regnum. */
68 
69 extern int no_op_reg_to_regnum (struct gdbarch *gdbarch, int reg);
70 
71 /* Do nothing version of coff_make_msymbol_special. */
72 
73 void default_coff_make_msymbol_special (int val, struct minimal_symbol *msym);
74 
75 /* Do nothing default implementation of gdbarch_make_symbol_special. */
76 
77 void default_make_symbol_special (struct symbol *sym, struct objfile *objfile);
78 
79 /* Do nothing default implementation of gdbarch_adjust_dwarf2_addr. */
80 
82 
83 /* Do nothing default implementation of gdbarch_adjust_dwarf2_line. */
84 
86 
87 /* Version of cannot_fetch_register() / cannot_store_register() that
88  always fails. */
89 
90 int cannot_register_not (struct gdbarch *gdbarch, int regnum);
91 
92 /* Legacy version of target_virtual_frame_pointer(). Assumes that
93  there is an gdbarch_deprecated_fp_regnum and that it is the same, cooked or
94  raw. */
95 
97 
99  CORE_ADDR pc);
100 
102  CORE_ADDR pc);
103 
105  CORE_ADDR pc, const char *name);
106 
108  CORE_ADDR pc);
109 
110 /* By default, registers are not convertible. */
111 extern int generic_convert_register_p (struct gdbarch *gdbarch, int regnum,
112  struct type *type);
113 
115  struct type *type);
116 
117 extern int generic_instruction_nullified (struct gdbarch *gdbarch,
118  struct regcache *regcache);
119 
121  int regno);
122 
123 /* For compatibility with older architectures, returns
124  (LEGACY_SIM_REGNO_IGNORE) when the register doesn't have a valid
125  name. */
126 
127 extern int legacy_register_sim_regno (struct gdbarch *gdbarch, int regnum);
128 
129 /* Return the selected byte order, or BFD_ENDIAN_UNKNOWN if no byte
130  order was explicitly selected. */
131 extern enum bfd_endian selected_byte_order (void);
132 
133 /* Return the selected architecture's name, or NULL if no architecture
134  was explicitly selected. */
135 extern const char *selected_architecture_name (void);
136 
137 /* Initialize a ``struct info''. Can't use memset(0) since some
138  default values are not zero. "fill" takes all available
139  information and fills in any unspecified fields. */
140 
141 extern void gdbarch_info_init (struct gdbarch_info *info);
142 
143 /* Similar to init, but this time fill in the blanks. Information is
144  obtained from the global "set ..." options and explicitly
145  initialized INFO fields. */
146 extern void gdbarch_info_fill (struct gdbarch_info *info);
147 
148 /* Return the architecture for ABFD. If no suitable architecture
149  could be find, return NULL. */
150 
151 extern struct gdbarch *gdbarch_from_bfd (bfd *abfd);
152 
153 /* Return "current" architecture. If the target is running, this is the
154  architecture of the selected frame. Otherwise, the "current" architecture
155  defaults to the target architecture.
156 
157  This function should normally be called solely by the command interpreter
158  routines to determine the architecture to execute a command in. */
159 extern struct gdbarch *get_current_arch (void);
160 
161 extern int default_has_shared_address_space (struct gdbarch *);
162 
164  CORE_ADDR addr,
165  int *isize, char **msg);
166 
167 extern void default_remote_breakpoint_from_pc (struct gdbarch *,
168  CORE_ADDR *pcptr, int *kindptr);
169 
170 extern void default_gen_return_address (struct gdbarch *gdbarch,
171  struct agent_expr *ax,
172  struct axs_value *value,
173  CORE_ADDR scope);
174 
175 extern const char *default_auto_charset (void);
176 extern const char *default_auto_wide_charset (void);
177 
179  struct type *);
180 
181 extern int default_insn_is_call (struct gdbarch *, CORE_ADDR);
182 extern int default_insn_is_ret (struct gdbarch *, CORE_ADDR);
183 extern int default_insn_is_jump (struct gdbarch *, CORE_ADDR);
184 
185 /* Do-nothing version of vsyscall_range. Returns false. */
186 
187 extern int default_vsyscall_range (struct gdbarch *gdbarch, struct mem_range *range);
188 
189 /* Default way to advance the PC to the next instruction in order to
190  skip a permanent breakpoint. Increments the PC by the size of a
191  software breakpoint instruction, as determined with
192  gdbarch_breakpoint_from_pc. This matches how the breakpoints
193  module determines whether a breakpoint is permanent. */
195 
196 /* Symbols for gdbarch_infcall_mmap; their Linux PROT_* system
197  definitions would be dependent on compilation host. */
198 #define GDB_MMAP_PROT_READ 0x1 /* Page can be read. */
199 #define GDB_MMAP_PROT_WRITE 0x2 /* Page can be written. */
200 #define GDB_MMAP_PROT_EXEC 0x4 /* Page can be executed. */
201 
202 extern CORE_ADDR default_infcall_mmap (CORE_ADDR size, unsigned prot);
203 extern void default_infcall_munmap (CORE_ADDR addr, CORE_ADDR size);
204 extern char *default_gcc_target_options (struct gdbarch *gdbarch);
205 extern const char *default_gnu_triplet_regexp (struct gdbarch *gdbarch);
207 
208 #endif
struct gdbarch * gdbarch_from_bfd(bfd *abfd)
Definition: arch-utils.c:560
int default_vsyscall_range(struct gdbarch *gdbarch, struct mem_range *range)
Definition: arch-utils.c:268
struct gdbarch * get_current_arch(void)
Definition: arch-utils.c:781
void simple_displaced_step_free_closure(struct gdbarch *gdbarch, struct displaced_step_closure *closure)
Definition: arch-utils.c:64
const char * default_auto_charset(void)
Definition: charset.c:934
int default_insn_is_call(struct gdbarch *, CORE_ADDR)
Definition: arch-utils.c:833
struct displaced_step_closure * simple_displaced_step_copy_insn(struct gdbarch *gdbarch, CORE_ADDR from, CORE_ADDR to, struct regcache *regs)
Definition: arch-utils.c:42
void gdbarch_info_fill(struct gdbarch_info *info)
Definition: arch-utils.c:721
void default_make_symbol_special(struct symbol *sym, struct objfile *objfile)
Definition: arch-utils.c:179
bfd_vma CORE_ADDR
Definition: common-types.h:41
Definition: ax.h:95
enum bfd_endian selected_byte_order(void)
Definition: arch-utils.c:291
void gdbarch_info_init(struct gdbarch_info *info)
Definition: arch-utils.c:708
int default_addressable_memory_unit_size(struct gdbarch *gdbarch)
Definition: arch-utils.c:895
int default_fast_tracepoint_valid_at(struct gdbarch *gdbarch, CORE_ADDR addr, int *isize, char **msg)
Definition: arch-utils.c:798
void default_coff_make_msymbol_special(int val, struct minimal_symbol *msym)
Definition: arch-utils.c:171
void default_skip_permanent_breakpoint(struct regcache *regcache)
Definition: arch-utils.c:849
int no_op_reg_to_regnum(struct gdbarch *gdbarch, int reg)
Definition: arch-utils.c:165
const char * default_auto_wide_charset(void)
Definition: charset.c:940
const char *const name
Definition: aarch64-tdep.c:68
int * from
Definition: varobj.h:282
CORE_ADDR default_adjust_dwarf2_line(CORE_ADDR addr, int rel)
Definition: arch-utils.c:195
int default_remote_register_number(struct gdbarch *gdbarch, int regno)
Definition: arch-utils.c:259
Definition: gdbtypes.h:749
void( gdbarch_virtual_frame_pointer_ftype)(struct gdbarch *gdbarch, CORE_ADDR pc, int *frame_regnum, LONGEST *frame_offset)
Definition: gdbarch.h:246
CORE_ADDR default_infcall_mmap(CORE_ADDR size, unsigned prot)
Definition: arch-utils.c:862
int default_stabs_argument_has_addr(struct gdbarch *gdbarch, struct type *type)
Definition: arch-utils.c:246
int generic_instruction_nullified(struct gdbarch *gdbarch, struct regcache *regcache)
Definition: arch-utils.c:252
Definition: value.c:65
int generic_stack_frame_destroyed_p(struct gdbarch *gdbarch, CORE_ADDR pc)
Definition: arch-utils.c:130
int regnum
Definition: aarch64-tdep.c:69
Definition: regdef.h:22
Definition: value.c:172
int cannot_register_not(struct gdbarch *gdbarch, int regnum)
Definition: arch-utils.c:201
void default_remote_breakpoint_from_pc(struct gdbarch *, CORE_ADDR *pcptr, int *kindptr)
Definition: arch-utils.c:809
int core_addr_greaterthan(CORE_ADDR lhs, CORE_ADDR rhs)
Definition: arch-utils.c:144
int default_has_shared_address_space(struct gdbarch *)
Definition: arch-utils.c:790
int legacy_register_sim_regno(struct gdbarch *gdbarch, int regnum)
Definition: arch-utils.c:95
const char * default_gnu_triplet_regexp(struct gdbarch *gdbarch)
Definition: arch-utils.c:886
int default_return_in_first_hidden_param_p(struct gdbarch *, struct type *)
Definition: arch-utils.c:824
gdbarch_virtual_frame_pointer_ftype legacy_virtual_frame_pointer
int default_insn_is_jump(struct gdbarch *, CORE_ADDR)
Definition: arch-utils.c:843
CORE_ADDR displaced_step_at_entry_point(struct gdbarch *gdbarch)
Definition: arch-utils.c:78
CORE_ADDR generic_skip_solib_resolver(struct gdbarch *gdbarch, CORE_ADDR pc)
Definition: arch-utils.c:117
const char * selected_architecture_name(void)
Definition: arch-utils.c:448
Definition: symtab.h:703
int generic_convert_register_p(struct gdbarch *gdbarch, int regnum, struct type *type)
Definition: arch-utils.c:239
int int * to
Definition: varobj.h:282
void default_gen_return_address(struct gdbarch *gdbarch, struct agent_expr *ax, struct axs_value *value, CORE_ADDR scope)
Definition: arch-utils.c:816
char * default_gcc_target_options(struct gdbarch *gdbarch)
Definition: arch-utils.c:877
int generic_in_solib_return_trampoline(struct gdbarch *gdbarch, CORE_ADDR pc, const char *name)
Definition: arch-utils.c:123
int default_displaced_step_hw_singlestep(struct gdbarch *, struct displaced_step_closure *)
Definition: arch-utils.c:71
CORE_ADDR( gdbarch_convert_from_func_ptr_addr_ftype)(struct gdbarch *gdbarch, CORE_ADDR addr, struct target_ops *targ)
Definition: gdbarch.h:614
void default_infcall_munmap(CORE_ADDR addr, CORE_ADDR size)
Definition: arch-utils.c:868
CORE_ADDR default_adjust_dwarf2_addr(CORE_ADDR pc)
Definition: arch-utils.c:187
size_t size
Definition: go32-nat.c:242
CORE_ADDR core_addr_identity(struct gdbarch *gdbarch, CORE_ADDR addr)
Definition: arch-utils.c:152
gdbarch_convert_from_func_ptr_addr_ftype convert_from_func_ptr_addr_identity
int default_insn_is_ret(struct gdbarch *, CORE_ADDR)
Definition: arch-utils.c:838
int core_addr_lessthan(CORE_ADDR lhs, CORE_ADDR rhs)
Definition: arch-utils.c:138
CORE_ADDR generic_skip_trampoline_code(struct frame_info *frame, CORE_ADDR pc)
Definition: arch-utils.c:111