]> git.ipfire.org Git - thirdparty/binutils-gdb.git/blame - gdb/i386-tdep.h
Bump GDB version number to 8.1.1.DATE-git.
[thirdparty/binutils-gdb.git] / gdb / i386-tdep.h
CommitLineData
5716833c
MK
1/* Target-dependent code for the i386.
2
e2882c85 3 Copyright (C) 2001-2018 Free Software Foundation, Inc.
9a82579f
JS
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
a9762ec7 9 the Free Software Foundation; either version 3 of the License, or
9a82579f
JS
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
a9762ec7 18 along with this program. If not, see <http://www.gnu.org/licenses/>. */
9a82579f
JS
19
20#ifndef I386_TDEP_H
21#define I386_TDEP_H
22
cfba9872
SM
23#include "infrun.h"
24
da3331ec 25struct frame_info;
5716833c
MK
26struct gdbarch;
27struct reggroup;
c783cbd6 28struct regset;
5439edaa 29struct regcache;
da3331ec 30
96297dab
MK
31/* GDB's i386 target supports both the 32-bit Intel Architecture
32 (IA-32) and the 64-bit AMD x86-64 architecture. Internally it uses
33 a similar register layout for both.
34
35 - General purpose registers
36 - FPU data registers
37 - FPU control registers
38 - SSE data registers
39 - SSE control register
40
41 The general purpose registers for the x86-64 architecture are quite
3e8c568d 42 different from IA-32. Therefore, gdbarch_fp0_regnum
96297dab
MK
43 determines the register number at which the FPU data registers
44 start. The number of FPU data and control registers is the same
45 for both architectures. The number of SSE registers however,
46 differs and is determined by the num_xmm_regs member of `struct
47 gdbarch_tdep'. */
48
8201327c 49/* Convention for returning structures. */
3ce1502b 50
8201327c
MK
51enum struct_return
52{
53 pcc_struct_return, /* Return "short" structures in memory. */
54 reg_struct_return /* Return "short" structures in registers. */
3ce1502b
MK
55};
56
96297dab
MK
57/* i386 architecture specific information. */
58struct gdbarch_tdep
59{
473f17b0 60 /* General-purpose registers. */
473f17b0
MK
61 int *gregset_reg_offset;
62 int gregset_num_regs;
63 size_t sizeof_gregset;
64
65 /* Floating-point registers. */
473f17b0
MK
66 size_t sizeof_fpregset;
67
5716833c
MK
68 /* Register number for %st(0). The register numbers for the other
69 registers follow from this one. Set this to -1 to indicate the
70 absence of an FPU. */
71 int st0_regnum;
72
1ba53b71
L
73 /* Number of MMX registers. */
74 int num_mmx_regs;
75
5716833c
MK
76 /* Register number for %mm0. Set this to -1 to indicate the absence
77 of MMX support. */
78 int mm0_regnum;
79
c131fcee
L
80 /* Number of pseudo YMM registers. */
81 int num_ymm_regs;
82
83 /* Register number for %ymm0. Set this to -1 to indicate the absence
84 of pseudo YMM register support. */
85 int ymm0_regnum;
86
01f9f808
MS
87 /* Number of AVX512 OpMask registers (K-registers) */
88 int num_k_regs;
89
90 /* Register number for %k0. Set this to -1 to indicate the absence
91 of AVX512 OpMask register support. */
92 int k0_regnum;
93
94 /* Number of pseudo ZMM registers ($zmm0-$zmm31). */
95 int num_zmm_regs;
96
97 /* Register number for %zmm0. Set this to -1 to indicate the absence
98 of pseudo ZMM register support. */
99 int zmm0_regnum;
100
1ba53b71
L
101 /* Number of byte registers. */
102 int num_byte_regs;
103
104 /* Register pseudo number for %al. */
105 int al_regnum;
106
107 /* Number of pseudo word registers. */
108 int num_word_regs;
109
110 /* Register number for %ax. */
111 int ax_regnum;
112
113 /* Number of pseudo dword registers. */
114 int num_dword_regs;
115
116 /* Register number for %eax. Set this to -1 to indicate the absence
117 of pseudo dword register support. */
118 int eax_regnum;
119
90884b2b
L
120 /* Number of core registers. */
121 int num_core_regs;
122
96297dab
MK
123 /* Number of SSE registers. */
124 int num_xmm_regs;
8201327c 125
01f9f808
MS
126 /* Number of SSE registers added in AVX512. */
127 int num_xmm_avx512_regs;
128
129 /* Register number of XMM16, the first XMM register added in AVX512. */
130 int xmm16_regnum;
131
132 /* Number of YMM registers added in AVX512. */
133 int num_ymm_avx512_regs;
134
135 /* Register number of YMM16, the first YMM register added in AVX512. */
136 int ymm16_regnum;
137
c131fcee 138 /* Bits of the extended control register 0 (the XFEATURE_ENABLED_MASK
1777feb0
MS
139 register), excluding the x87 bit, which are supported by this GDB. */
140
c131fcee
L
141 uint64_t xcr0;
142
143 /* Offset of XCR0 in XSAVE extended state. */
144 int xsave_xcr0_offset;
145
90884b2b
L
146 /* Register names. */
147 const char **register_names;
148
c131fcee
L
149 /* Register number for %ymm0h. Set this to -1 to indicate the absence
150 of upper YMM register support. */
151 int ymm0h_regnum;
152
153 /* Upper YMM register names. Only used for tdesc_numbered_register. */
154 const char **ymmh_register_names;
155
01f9f808
MS
156 /* Register number for %ymm16h. Set this to -1 to indicate the absence
157 of support for YMM16-31. */
158 int ymm16h_regnum;
159
160 /* YMM16-31 register names. Only used for tdesc_numbered_register. */
161 const char **ymm16h_register_names;
162
1dbcd68c
WT
163 /* Register number for %bnd0r. Set this to -1 to indicate the absence
164 bound registers. */
165 int bnd0r_regnum;
166
167 /* Register number for pseudo register %bnd0. Set this to -1 to indicate the absence
168 bound registers. */
169 int bnd0_regnum;
170
171 /* Register number for %bndcfgu. Set this to -1 to indicate the absence
172 bound control registers. */
173 int bndcfgu_regnum;
174
175 /* MPX register names. Only used for tdesc_numbered_register. */
176 const char **mpx_register_names;
177
01f9f808
MS
178 /* Register number for %zmm0h. Set this to -1 to indicate the absence
179 of ZMM_HI256 register support. */
180 int zmm0h_regnum;
181
182 /* OpMask register names. */
183 const char **k_register_names;
184
185 /* ZMM register names. Only used for tdesc_numbered_register. */
186 const char **zmmh_register_names;
187
188 /* XMM16-31 register names. Only used for tdesc_numbered_register. */
189 const char **xmm_avx512_register_names;
190
191 /* YMM16-31 register names. Only used for tdesc_numbered_register. */
192 const char **ymm_avx512_register_names;
193
51547df6
MS
194 /* Number of PKEYS registers. */
195 int num_pkeys_regs;
196
197 /* Register number for PKRU register. */
198 int pkru_regnum;
199
200 /* PKEYS register names. */
201 const char **pkeys_register_names;
202
90884b2b
L
203 /* Target description. */
204 const struct target_desc *tdesc;
205
206 /* Register group function. */
c5bcd278 207 gdbarch_register_reggroup_p_ftype *register_reggroup_p;
90884b2b 208
8201327c
MK
209 /* Offset of saved PC in jmp_buf. */
210 int jb_pc_offset;
211
212 /* Convention for returning structures. */
213 enum struct_return struct_return;
214
8201327c
MK
215 /* Address range where sigtramp lives. */
216 CORE_ADDR sigtramp_start;
217 CORE_ADDR sigtramp_end;
218
911bc6ee
MK
219 /* Detect sigtramp. */
220 int (*sigtramp_p) (struct frame_info *);
221
21d0e8a4
MK
222 /* Get address of sigcontext for sigtramp. */
223 CORE_ADDR (*sigcontext_addr) (struct frame_info *);
224
a3386186
MK
225 /* Offset of registers in `struct sigcontext'. */
226 int *sc_reg_offset;
227 int sc_num_regs;
228
229 /* Offset of saved PC and SP in `struct sigcontext'. Usage of these
230 is deprecated, please use `sc_reg_offset' instead. */
8201327c 231 int sc_pc_offset;
21d0e8a4 232 int sc_sp_offset;
794ac428
UW
233
234 /* ISA-specific data types. */
235 struct type *i386_mmx_type;
c131fcee 236 struct type *i386_ymm_type;
01f9f808 237 struct type *i386_zmm_type;
27067745 238 struct type *i387_ext_type;
1dbcd68c 239 struct type *i386_bnd_type;
7ad10968
HZ
240
241 /* Process record/replay target. */
cf648174
HZ
242 /* The map for registers because the AMD64's registers order
243 in GDB is not same as I386 instructions. */
244 const int *record_regmap;
7ad10968
HZ
245 /* Parse intx80 args. */
246 int (*i386_intx80_record) (struct regcache *regcache);
247 /* Parse sysenter args. */
248 int (*i386_sysenter_record) (struct regcache *regcache);
cf648174
HZ
249 /* Parse syscall args. */
250 int (*i386_syscall_record) (struct regcache *regcache);
8f0435f7
AA
251
252 /* Regsets. */
253 const struct regset *fpregset;
96297dab
MK
254};
255
256/* Floating-point registers. */
257
96297dab
MK
258/* All FPU control regusters (except for FIOFF and FOOFF) are 16-bit
259 (at most) in the FPU, but are zero-extended to 32 bits in GDB's
260 register cache. */
261
23a34459
AC
262/* Return non-zero if REGNUM matches the FP register and the FP
263 register set is active. */
20a6ec49
MD
264extern int i386_fp_regnum_p (struct gdbarch *, int);
265extern int i386_fpc_regnum_p (struct gdbarch *, int);
96297dab 266
a3386186
MK
267/* Register numbers of various important registers. */
268
bcf48cc7
MK
269enum i386_regnum
270{
271 I386_EAX_REGNUM, /* %eax */
272 I386_ECX_REGNUM, /* %ecx */
273 I386_EDX_REGNUM, /* %edx */
274 I386_EBX_REGNUM, /* %ebx */
275 I386_ESP_REGNUM, /* %esp */
276 I386_EBP_REGNUM, /* %ebp */
277 I386_ESI_REGNUM, /* %esi */
278 I386_EDI_REGNUM, /* %edi */
279 I386_EIP_REGNUM, /* %eip */
280 I386_EFLAGS_REGNUM, /* %eflags */
2666fb59
MK
281 I386_CS_REGNUM, /* %cs */
282 I386_SS_REGNUM, /* %ss */
e9ff708b
AC
283 I386_DS_REGNUM, /* %ds */
284 I386_ES_REGNUM, /* %es */
285 I386_FS_REGNUM, /* %fs */
286 I386_GS_REGNUM, /* %gs */
90884b2b 287 I386_ST0_REGNUM, /* %st(0) */
c131fcee
L
288 I386_MXCSR_REGNUM = 40, /* %mxcsr */
289 I386_YMM0H_REGNUM, /* %ymm0h */
1dbcd68c
WT
290 I386_YMM7H_REGNUM = I386_YMM0H_REGNUM + 7,
291 I386_BND0R_REGNUM,
292 I386_BND3R_REGNUM = I386_BND0R_REGNUM + 3,
293 I386_BNDCFGU_REGNUM,
01f9f808
MS
294 I386_BNDSTATUS_REGNUM,
295 I386_K0_REGNUM, /* %k0 */
296 I386_K7_REGNUM = I386_K0_REGNUM + 7,
297 I386_ZMM0H_REGNUM, /* %zmm0h */
51547df6
MS
298 I386_ZMM7H_REGNUM = I386_ZMM0H_REGNUM + 7,
299 I386_PKRU_REGNUM
bcf48cc7 300};
a3386186 301
cf648174
HZ
302/* Register numbers of RECORD_REGMAP. */
303
304enum record_i386_regnum
305{
306 X86_RECORD_REAX_REGNUM,
307 X86_RECORD_RECX_REGNUM,
308 X86_RECORD_REDX_REGNUM,
309 X86_RECORD_REBX_REGNUM,
310 X86_RECORD_RESP_REGNUM,
311 X86_RECORD_REBP_REGNUM,
312 X86_RECORD_RESI_REGNUM,
313 X86_RECORD_REDI_REGNUM,
314 X86_RECORD_R8_REGNUM,
315 X86_RECORD_R9_REGNUM,
316 X86_RECORD_R10_REGNUM,
317 X86_RECORD_R11_REGNUM,
318 X86_RECORD_R12_REGNUM,
319 X86_RECORD_R13_REGNUM,
320 X86_RECORD_R14_REGNUM,
321 X86_RECORD_R15_REGNUM,
322 X86_RECORD_REIP_REGNUM,
323 X86_RECORD_EFLAGS_REGNUM,
324 X86_RECORD_CS_REGNUM,
325 X86_RECORD_SS_REGNUM,
326 X86_RECORD_DS_REGNUM,
327 X86_RECORD_ES_REGNUM,
328 X86_RECORD_FS_REGNUM,
329 X86_RECORD_GS_REGNUM,
330};
331
8201327c 332#define I386_NUM_GREGS 16
8201327c
MK
333#define I386_NUM_XREGS 9
334
90884b2b 335#define I386_SSE_NUM_REGS (I386_MXCSR_REGNUM + 1)
c131fcee 336#define I386_AVX_NUM_REGS (I386_YMM7H_REGNUM + 1)
1dbcd68c 337#define I386_MPX_NUM_REGS (I386_BNDSTATUS_REGNUM + 1)
01f9f808 338#define I386_AVX512_NUM_REGS (I386_ZMM7H_REGNUM + 1)
51547df6 339#define I386_PKEYS_NUM_REGS (I386_PKRU_REGNUM + 1)
8201327c 340
00f8375e 341/* Size of the largest register. */
01f9f808 342#define I386_MAX_REGISTER_SIZE 64
00f8375e 343
5ae96ec1 344/* Types for i386-specific registers. */
27067745 345extern struct type *i387_ext_type (struct gdbarch *gdbarch);
794ac428 346
1ba53b71
L
347/* Checks of different pseudo-registers. */
348extern int i386_byte_regnum_p (struct gdbarch *gdbarch, int regnum);
349extern int i386_word_regnum_p (struct gdbarch *gdbarch, int regnum);
350extern int i386_dword_regnum_p (struct gdbarch *gdbarch, int regnum);
c131fcee 351extern int i386_xmm_regnum_p (struct gdbarch *gdbarch, int regnum);
01f9f808 352extern int i386_xmm_avx512_regnum_p (struct gdbarch * gdbarch, int regnum);
c131fcee 353extern int i386_ymm_regnum_p (struct gdbarch *gdbarch, int regnum);
01f9f808 354extern int i386_ymm_avx512_regnum_p (struct gdbarch *gdbarch, int regnum);
1dbcd68c 355extern int i386_bnd_regnum_p (struct gdbarch *gdbarch, int regnum);
01f9f808
MS
356extern int i386_k_regnum_p (struct gdbarch *gdbarch, int regnum);
357extern int i386_zmm_regnum_p (struct gdbarch *gdbarch, int regnum);
358extern int i386_zmmh_regnum_p (struct gdbarch *gdbarch, int regnum);
51547df6 359extern bool i386_pkru_regnum_p (struct gdbarch *gdbarch, int regnum);
1ba53b71
L
360
361extern const char *i386_pseudo_register_name (struct gdbarch *gdbarch,
362 int regnum);
fff4548b
MK
363extern struct type *i386_pseudo_register_type (struct gdbarch *gdbarch,
364 int regnum);
1ba53b71 365
3543a589
TT
366extern void i386_pseudo_register_read_into_value (struct gdbarch *gdbarch,
367 struct regcache *regcache,
368 int regnum,
369 struct value *result);
370
1ba53b71
L
371extern void i386_pseudo_register_write (struct gdbarch *gdbarch,
372 struct regcache *regcache,
373 int regnum, const gdb_byte *buf);
374
62e5fd57
MK
375extern int i386_ax_pseudo_register_collect (struct gdbarch *gdbarch,
376 struct agent_expr *ax,
377 int regnum);
378
508fbfea
MK
379/* Segment selectors. */
380#define I386_SEL_RPL 0x0003 /* Requester's Privilege Level mask. */
1777feb0
MS
381#define I386_SEL_UPL 0x0003 /* User Privilige Level. */
382#define I386_SEL_KPL 0x0000 /* Kernel Privilige Level. */
508fbfea 383
237fc4c9
PA
384/* The length of the longest i386 instruction (according to
385 include/asm-i386/kprobes.h in Linux 2.6. */
386#define I386_MAX_INSN_LEN (16)
387
1cce71eb 388/* Functions exported from i386-tdep.c. */
e17a4113
UW
389extern CORE_ADDR i386_pe_skip_trampoline_code (struct frame_info *frame,
390 CORE_ADDR pc, char *name);
1777feb0
MS
391extern CORE_ADDR i386_skip_main_prologue (struct gdbarch *gdbarch,
392 CORE_ADDR pc);
1cce71eb 393
4bd207ef
TG
394/* Return whether the THIS_FRAME corresponds to a sigtramp routine. */
395extern int i386_sigtramp_p (struct frame_info *this_frame);
396
38c968cf
AC
397/* Return non-zero if REGNUM is a member of the specified group. */
398extern int i386_register_reggroup_p (struct gdbarch *gdbarch, int regnum,
399 struct reggroup *group);
400
20187ed5
MK
401/* Supply register REGNUM from the general-purpose register set REGSET
402 to register cache REGCACHE. If REGNUM is -1, do this for all
403 registers in REGSET. */
404extern void i386_supply_gregset (const struct regset *regset,
405 struct regcache *regcache, int regnum,
406 const void *gregs, size_t len);
3d171c85 407
ecc37a5a
AA
408/* General-purpose register set. */
409extern const struct regset i386_gregset;
20187ed5 410
8f0435f7
AA
411/* Floating-point register set. */
412extern const struct regset i386_fpregset;
413
490496c3
AA
414/* Default iterator over core file register note sections. */
415extern void
416 i386_iterate_over_regset_sections (struct gdbarch *gdbarch,
417 iterate_over_regset_sections_cb *cb,
418 void *cb_data,
419 const struct regcache *regcache);
237fc4c9 420
cfba9872
SM
421typedef buf_displaced_step_closure i386_displaced_step_closure;
422
b55078be
DE
423extern struct displaced_step_closure *i386_displaced_step_copy_insn
424 (struct gdbarch *gdbarch, CORE_ADDR from, CORE_ADDR to,
425 struct regcache *regs);
237fc4c9
PA
426extern void i386_displaced_step_fixup (struct gdbarch *gdbarch,
427 struct displaced_step_closure *closure,
428 CORE_ADDR from, CORE_ADDR to,
429 struct regcache *regs);
430
8201327c
MK
431/* Initialize a basic ELF architecture variant. */
432extern void i386_elf_init_abi (struct gdbarch_info, struct gdbarch *);
433
434/* Initialize a SVR4 architecture variant. */
435extern void i386_svr4_init_abi (struct gdbarch_info, struct gdbarch *);
a6b808b4 436
8f10c932
PA
437/* Convert SVR4 register number REG to the appropriate register number
438 used by GDB. */
439extern int i386_svr4_reg_to_regnum (struct gdbarch *gdbarch, int reg);
440
a6b808b4
HZ
441extern int i386_process_record (struct gdbarch *gdbarch,
442 struct regcache *regcache, CORE_ADDR addr);
97de3545 443extern const struct target_desc *i386_target_description (uint64_t xcr0);
55aa24fb 444
012b3a21
WT
445/* Return true iff the current target is MPX enabled. */
446extern int i386_mpx_enabled (void);
de0b6abb 447\f
8201327c 448
03b62bbb 449/* Functions and variables exported from i386-bsd-tdep.c. */
8201327c 450
3cac699e 451extern void i386bsd_init_abi (struct gdbarch_info, struct gdbarch *);
5d93ae8c
MK
452extern CORE_ADDR i386fbsd_sigtramp_start_addr;
453extern CORE_ADDR i386fbsd_sigtramp_end_addr;
454extern CORE_ADDR i386obsd_sigtramp_start_addr;
455extern CORE_ADDR i386obsd_sigtramp_end_addr;
de0b6abb
MK
456extern int i386fbsd4_sc_reg_offset[];
457extern int i386fbsd_sc_reg_offset[];
458extern int i386nbsd_sc_reg_offset[];
459extern int i386obsd_sc_reg_offset[];
460extern int i386bsd_sc_reg_offset[];
3ce1502b 461
55aa24fb
SDJ
462/* SystemTap related functions. */
463
464extern int i386_stap_is_single_operand (struct gdbarch *gdbarch,
465 const char *s);
466
467extern int i386_stap_parse_special_token (struct gdbarch *gdbarch,
468 struct stap_parse_info *p);
469
96297dab 470#endif /* i386-tdep.h */