1 /* Copyright (C) 2009-2015 Free Software Foundation, Inc.
2 Contributed by ARM Ltd.
4 This file is part of GDB.
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 3 of the License, or
9 (at your option) any later version.
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.
16 You should have received a copy of the GNU General Public License
17 along with this program. If not, see <http://www.gnu.org/licenses/>. */
19 #ifndef AARCH64_INSN_H
20 #define AARCH64_INSN_H 1
22 extern int aarch64_debug;
24 /* List of opcodes that we need for building the jump pad and relocating
29 /* B 0001 01ii iiii iiii iiii iiii iiii iiii */
30 /* BL 1001 01ii iiii iiii iiii iiii iiii iiii */
31 /* B.COND 0101 0100 iiii iiii iiii iiii iii0 cccc */
32 /* CBZ s011 0100 iiii iiii iiii iiii iiir rrrr */
33 /* CBNZ s011 0101 iiii iiii iiii iiii iiir rrrr */
34 /* TBZ b011 0110 bbbb biii iiii iiii iiir rrrr */
35 /* TBNZ b011 0111 bbbb biii iiii iiii iiir rrrr */
38 BCOND = 0x40000000 | B,
40 CBNZ = 0x21000000 | B,
42 TBNZ = 0x37000000 | B,
43 /* BLR 1101 0110 0011 1111 0000 00rr rrr0 0000 */
45 /* RET 1101 0110 0101 1111 0000 00rr rrr0 0000 */
47 /* STP s010 100o o0ii iiii irrr rrrr rrrr rrrr */
48 /* LDP s010 100o o1ii iiii irrr rrrr rrrr rrrr */
49 /* STP (SIMD&VFP) ss10 110o o0ii iiii irrr rrrr rrrr rrrr */
50 /* LDP (SIMD&VFP) ss10 110o o1ii iiii irrr rrrr rrrr rrrr */
53 STP_SIMD_VFP = 0x04000000 | STP,
54 LDP_SIMD_VFP = 0x04000000 | LDP,
55 /* STR ss11 100o 00xi iiii iiii xxrr rrrr rrrr */
56 /* LDR ss11 100o 01xi iiii iiii xxrr rrrr rrrr */
57 /* LDRSW 1011 100o 10xi iiii iiii xxrr rrrr rrrr */
59 LDR = 0x00400000 | STR,
60 LDRSW = 0x80800000 | STR,
61 /* LDAXR ss00 1000 0101 1111 1111 11rr rrrr rrrr */
63 /* STXR ss00 1000 000r rrrr 0111 11rr rrrr rrrr */
65 /* STLR ss00 1000 1001 1111 1111 11rr rrrr rrrr */
67 /* MOV s101 0010 1xxi iiii iiii iiii iiir rrrr */
68 /* MOVK s111 0010 1xxi iiii iiii iiii iiir rrrr */
70 MOVK = 0x20000000 | MOV,
71 /* ADD s00o ooo1 xxxx xxxx xxxx xxxx xxxx xxxx */
72 /* SUB s10o ooo1 xxxx xxxx xxxx xxxx xxxx xxxx */
73 /* SUBS s11o ooo1 xxxx xxxx xxxx xxxx xxxx xxxx */
75 SUB = 0x40000000 | ADD,
76 SUBS = 0x20000000 | SUB,
77 /* AND s000 1010 xx0x xxxx xxxx xxxx xxxx xxxx */
78 /* ORR s010 1010 xx0x xxxx xxxx xxxx xxxx xxxx */
79 /* ORN s010 1010 xx1x xxxx xxxx xxxx xxxx xxxx */
80 /* EOR s100 1010 xx0x xxxx xxxx xxxx xxxx xxxx */
82 ORR = 0x20000000 | AND,
83 ORN = 0x00200000 | ORR,
84 EOR = 0x40000000 | AND,
85 /* LSLV s001 1010 110r rrrr 0010 00rr rrrr rrrr */
86 /* LSRV s001 1010 110r rrrr 0010 01rr rrrr rrrr */
87 /* ASRV s001 1010 110r rrrr 0010 10rr rrrr rrrr */
89 LSRV = 0x00000400 | LSLV,
90 ASRV = 0x00000800 | LSLV,
91 /* SBFM s001 0011 0nii iiii iiii iirr rrrr rrrr */
93 /* UBFM s101 0011 0nii iiii iiii iirr rrrr rrrr */
94 UBFM = 0x40000000 | SBFM,
95 /* CSINC s001 1010 100r rrrr cccc 01rr rrrr rrrr */
97 /* MUL s001 1011 000r rrrr 0111 11rr rrrr rrrr */
99 /* MSR (register) 1101 0101 0001 oooo oooo oooo ooor rrrr */
100 /* MRS 1101 0101 0011 oooo oooo oooo ooor rrrr */
102 MRS = 0x00200000 | MSR,
103 /* HINT 1101 0101 0000 0011 0010 oooo ooo1 1111 */
105 SEVL = (5 << 5) | HINT,
106 WFE = (2 << 5) | HINT,
107 NOP = (0 << 5) | HINT,
110 /* Representation of a general purpose register of the form xN or wN.
112 This type is used by emitting functions that take registers as operands. */
114 struct aarch64_register
120 /* Representation of a memory operand, used for load and store
123 The types correspond to the following variants:
125 MEMORY_OPERAND_OFFSET: LDR rt, [rn, #offset]
126 MEMORY_OPERAND_PREINDEX: LDR rt, [rn, #index]!
127 MEMORY_OPERAND_POSTINDEX: LDR rt, [rn], #index */
129 struct aarch64_memory_operand
131 /* Type of the operand. */
134 MEMORY_OPERAND_OFFSET,
135 MEMORY_OPERAND_PREINDEX,
136 MEMORY_OPERAND_POSTINDEX,
138 /* Index from the base register. */
142 /* Helper macro to mask and shift a value into a bitfield. */
144 #define ENCODE(val, size, offset) \
145 ((uint32_t) ((val & ((1ULL << size) - 1)) << offset))
147 int aarch64_decode_adr (CORE_ADDR addr, uint32_t insn, int *is_adrp,
148 unsigned *rd, int32_t *offset);
150 int aarch64_decode_b (CORE_ADDR addr, uint32_t insn, int *is_bl,
153 int aarch64_decode_bcond (CORE_ADDR addr, uint32_t insn, unsigned *cond,
156 int aarch64_decode_cb (CORE_ADDR addr, uint32_t insn, int *is64,
157 int *is_cbnz, unsigned *rn, int32_t *offset);
159 int aarch64_decode_tb (CORE_ADDR addr, uint32_t insn, int *is_tbnz,
160 unsigned *bit, unsigned *rt, int32_t *imm);
162 int aarch64_decode_ldr_literal (CORE_ADDR addr, uint32_t insn, int *is_w,
163 int *is64, unsigned *rt, int32_t *offset);
165 /* Data passed to each method of aarch64_insn_visitor. */
167 struct aarch64_insn_data
169 /* The instruction address. */
173 /* Visit different instructions by different methods. */
175 struct aarch64_insn_visitor
177 /* Visit instruction B/BL OFFSET. */
178 void (*b) (const int is_bl, const int32_t offset,
179 struct aarch64_insn_data *data);
181 /* Visit instruction B.COND OFFSET. */
182 void (*b_cond) (const unsigned cond, const int32_t offset,
183 struct aarch64_insn_data *data);
185 /* Visit instruction CBZ/CBNZ Rn, OFFSET. */
186 void (*cb) (const int32_t offset, const int is_cbnz,
187 const unsigned rn, int is64,
188 struct aarch64_insn_data *data);
190 /* Visit instruction TBZ/TBNZ Rt, #BIT, OFFSET. */
191 void (*tb) (const int32_t offset, int is_tbnz,
192 const unsigned rt, unsigned bit,
193 struct aarch64_insn_data *data);
195 /* Visit instruction ADR/ADRP Rd, OFFSET. */
196 void (*adr) (const int32_t offset, const unsigned rd,
197 const int is_adrp, struct aarch64_insn_data *data);
199 /* Visit instruction LDR/LDRSW Rt, OFFSET. */
200 void (*ldr_literal) (const int32_t offset, const int is_sw,
201 const unsigned rt, const int is64,
202 struct aarch64_insn_data *data);
204 /* Visit instruction INSN of other kinds. */
205 void (*others) (const uint32_t insn, struct aarch64_insn_data *data);
208 void aarch64_relocate_instruction (uint32_t insn,
209 const struct aarch64_insn_visitor *visitor,
210 struct aarch64_insn_data *data);
212 #define can_encode_int32(val, bits) \
213 (((val) >> (bits)) == 0 || ((val) >> (bits)) == -1)
215 /* Write a B or BL instruction into *BUF.
220 IS_BL specifies if the link register should be updated.
221 OFFSET is the immediate offset from the current PC. It is
222 byte-addressed but should be 4 bytes aligned. It has a limited range of
223 +/- 128MB (26 bits << 2). */
225 #define emit_b(buf, is_bl, offset) \
226 emit_insn (buf, ((is_bl) ? BL : B) | (ENCODE ((offset) >> 2, 26, 0)))
228 /* Write a BCOND instruction into *BUF.
232 COND specifies the condition field.
233 OFFSET is the immediate offset from the current PC. It is
234 byte-addressed but should be 4 bytes aligned. It has a limited range of
235 +/- 1MB (19 bits << 2). */
237 #define emit_bcond(buf, cond, offset) \
239 BCOND | ENCODE ((offset) >> 2, 19, 5) \
240 | ENCODE ((cond), 4, 0))
242 /* Write a CBZ or CBNZ instruction into *BUF.
247 IS_CBNZ distinguishes between CBZ and CBNZ instructions.
248 RN is the register to test.
249 OFFSET is the immediate offset from the current PC. It is
250 byte-addressed but should be 4 bytes aligned. It has a limited range of
251 +/- 1MB (19 bits << 2). */
253 #define emit_cb(buf, is_cbnz, rt, offset) \
255 ((is_cbnz) ? CBNZ : CBZ) \
256 | ENCODE (rt.is64, 1, 31) /* sf */ \
257 | ENCODE (offset >> 2, 19, 5) /* imm19 */ \
258 | ENCODE (rt.num, 5, 0))
260 /* Write a LDR instruction into *BUF.
262 LDR rt, [rn, #offset]
263 LDR rt, [rn, #index]!
266 RT is the register to store.
267 RN is the base address register.
268 OFFSET is the immediate to add to the base address. It is limited to
269 0 .. 32760 range (12 bits << 3). */
271 #define emit_ldr(buf, rt, rn, operand) \
272 emit_load_store (buf, rt.is64 ? 3 : 2, LDR, rt, rn, operand)
274 /* Write a LDRSW instruction into *BUF. The register size is 64-bit.
276 LDRSW xt, [rn, #offset]
277 LDRSW xt, [rn, #index]!
278 LDRSW xt, [rn], #index
280 RT is the register to store.
281 RN is the base address register.
282 OFFSET is the immediate to add to the base address. It is limited to
283 0 .. 16380 range (12 bits << 2). */
285 #define emit_ldrsw(buf, rt, rn, operand) \
286 emit_load_store (buf, 3, LDRSW, rt, rn, operand)
289 /* Write a TBZ or TBNZ instruction into *BUF.
291 TBZ rt, #bit, #offset
292 TBNZ rt, #bit, #offset
294 IS_TBNZ distinguishes between TBZ and TBNZ instructions.
295 RT is the register to test.
296 BIT is the index of the bit to test in register RT.
297 OFFSET is the immediate offset from the current PC. It is
298 byte-addressed but should be 4 bytes aligned. It has a limited range of
299 +/- 32KB (14 bits << 2). */
301 #define emit_tb(buf, is_tbnz, bit, rt, offset) \
303 ((is_tbnz) ? TBNZ: TBZ) \
304 | ENCODE (bit >> 5, 1, 31) /* b5 */ \
305 | ENCODE (bit, 5, 19) /* b40 */ \
306 | ENCODE (offset >> 2, 14, 5) /* imm14 */ \
307 | ENCODE (rt.num, 5, 0))
309 /* Write a NOP instruction into *BUF. */
311 #define emit_nop(buf) emit_insn (buf, NOP)
313 int emit_insn (uint32_t *buf, uint32_t insn);
315 int emit_load_store (uint32_t *buf, uint32_t size,
316 enum aarch64_opcodes opcode,
317 struct aarch64_register rt,
318 struct aarch64_register rn,
319 struct aarch64_memory_operand operand);