1 /* aarch64-opc.h -- Header file for aarch64-opc.c and aarch64-opc-2.c.
2 Copyright (C) 2012-2016 Free Software Foundation, Inc.
3 Contributed by ARM Ltd.
5 This file is part of the GNU opcodes library.
7 This library 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, or (at your option)
12 It is distributed in the hope that it will be useful, but WITHOUT
13 ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
14 or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public
15 License for more details.
17 You should have received a copy of the GNU General Public License
18 along with this program; see the file COPYING3. If not,
19 see <http://www.gnu.org/licenses/>. */
21 #ifndef OPCODES_AARCH64_OPC_H
22 #define OPCODES_AARCH64_OPC_H
25 #include "opcode/aarch64.h"
27 /* Instruction fields.
28 Keep synced with fields. */
29 enum aarch64_field_kind
114 /* Field description. */
121 typedef struct aarch64_field aarch64_field
;
123 extern const aarch64_field fields
[];
125 /* Operand description. */
127 struct aarch64_operand
129 enum aarch64_operand_class op_class
;
131 /* Name of the operand code; used mainly for the purpose of internal
137 /* The associated instruction bit-fields; no operand has more than 4
139 enum aarch64_field_kind fields
[4];
141 /* Brief description */
145 typedef struct aarch64_operand aarch64_operand
;
147 extern const aarch64_operand aarch64_operands
[];
151 #define OPD_F_HAS_INSERTER 0x00000001
152 #define OPD_F_HAS_EXTRACTOR 0x00000002
153 #define OPD_F_SEXT 0x00000004 /* Require sign-extension. */
154 #define OPD_F_SHIFT_BY_2 0x00000008 /* Need to left shift the field
155 value by 2 to get the value
156 of an immediate operand. */
157 #define OPD_F_MAYBE_SP 0x00000010 /* May potentially be SP. */
159 static inline bfd_boolean
160 operand_has_inserter (const aarch64_operand
*operand
)
162 return (operand
->flags
& OPD_F_HAS_INSERTER
) ? TRUE
: FALSE
;
165 static inline bfd_boolean
166 operand_has_extractor (const aarch64_operand
*operand
)
168 return (operand
->flags
& OPD_F_HAS_EXTRACTOR
) ? TRUE
: FALSE
;
171 static inline bfd_boolean
172 operand_need_sign_extension (const aarch64_operand
*operand
)
174 return (operand
->flags
& OPD_F_SEXT
) ? TRUE
: FALSE
;
177 static inline bfd_boolean
178 operand_need_shift_by_two (const aarch64_operand
*operand
)
180 return (operand
->flags
& OPD_F_SHIFT_BY_2
) ? TRUE
: FALSE
;
183 static inline bfd_boolean
184 operand_maybe_stack_pointer (const aarch64_operand
*operand
)
186 return (operand
->flags
& OPD_F_MAYBE_SP
) ? TRUE
: FALSE
;
189 /* Return the total width of the operand *OPERAND. */
190 static inline unsigned
191 get_operand_fields_width (const aarch64_operand
*operand
)
195 while (operand
->fields
[i
] != FLD_NIL
)
196 width
+= fields
[operand
->fields
[i
++]].width
;
197 assert (width
> 0 && width
< 32);
201 static inline const aarch64_operand
*
202 get_operand_from_code (enum aarch64_opnd code
)
204 return aarch64_operands
+ code
;
207 /* Operand qualifier and operand constraint checking. */
209 int aarch64_match_operands_constraint (aarch64_inst
*,
210 aarch64_operand_error
*);
212 /* Operand qualifier related functions. */
213 const char* aarch64_get_qualifier_name (aarch64_opnd_qualifier_t
);
214 unsigned char aarch64_get_qualifier_nelem (aarch64_opnd_qualifier_t
);
215 aarch64_insn
aarch64_get_qualifier_standard_value (aarch64_opnd_qualifier_t
);
216 int aarch64_find_best_match (const aarch64_inst
*,
217 const aarch64_opnd_qualifier_seq_t
*,
218 int, aarch64_opnd_qualifier_t
*);
221 reset_operand_qualifier (aarch64_inst
*inst
, int idx
)
223 assert (idx
>=0 && idx
< aarch64_num_of_operands (inst
->opcode
));
224 inst
->operands
[idx
].qualifier
= AARCH64_OPND_QLF_NIL
;
227 /* Inline functions operating on instruction bit-field(s). */
229 /* Generate a mask that has WIDTH number of consecutive 1s. */
231 static inline aarch64_insn
234 return ((aarch64_insn
) 1 << width
) - 1;
237 /* LSB_REL is the relative location of the lsb in the sub field, starting from 0. */
239 gen_sub_field (enum aarch64_field_kind kind
, int lsb_rel
, int width
, aarch64_field
*ret
)
241 const aarch64_field
*field
= &fields
[kind
];
242 if (lsb_rel
< 0 || width
<= 0 || lsb_rel
+ width
> field
->width
)
244 ret
->lsb
= field
->lsb
+ lsb_rel
;
249 /* Insert VALUE into FIELD of CODE. MASK can be zero or the base mask
253 insert_field_2 (const aarch64_field
*field
, aarch64_insn
*code
,
254 aarch64_insn value
, aarch64_insn mask
)
256 assert (field
->width
< 32 && field
->width
>= 1 && field
->lsb
>= 0
257 && field
->lsb
+ field
->width
<= 32);
258 value
&= gen_mask (field
->width
);
259 value
<<= field
->lsb
;
260 /* In some opcodes, field can be part of the base opcode, e.g. the size
261 field in FADD. The following helps avoid corrupt the base opcode. */
266 /* Extract FIELD of CODE and return the value. MASK can be zero or the base
267 mask of the opcode. */
269 static inline aarch64_insn
270 extract_field_2 (const aarch64_field
*field
, aarch64_insn code
,
274 /* Clear any bit that is a part of the base opcode. */
276 value
= (code
>> field
->lsb
) & gen_mask (field
->width
);
280 /* Insert VALUE into field KIND of CODE. MASK can be zero or the base mask
284 insert_field (enum aarch64_field_kind kind
, aarch64_insn
*code
,
285 aarch64_insn value
, aarch64_insn mask
)
287 insert_field_2 (&fields
[kind
], code
, value
, mask
);
290 /* Extract field KIND of CODE and return the value. MASK can be zero or the
291 base mask of the opcode. */
293 static inline aarch64_insn
294 extract_field (enum aarch64_field_kind kind
, aarch64_insn code
,
297 return extract_field_2 (&fields
[kind
], code
, mask
);
300 /* Inline functions selecting operand to do the encoding/decoding for a
301 certain instruction bit-field. */
303 /* Select the operand to do the encoding/decoding of the 'sf' field.
304 The heuristic-based rule is that the result operand is respected more. */
307 select_operand_for_sf_field_coding (const aarch64_opcode
*opcode
)
310 if (aarch64_get_operand_class (opcode
->operands
[0])
311 == AARCH64_OPND_CLASS_INT_REG
)
314 else if (aarch64_get_operand_class (opcode
->operands
[1])
315 == AARCH64_OPND_CLASS_INT_REG
)
316 /* e.g. float2fix. */
319 { assert (0); abort (); }
323 /* Select the operand to do the encoding/decoding of the 'type' field in
324 the floating-point instructions.
325 The heuristic-based rule is that the source operand is respected more. */
328 select_operand_for_fptype_field_coding (const aarch64_opcode
*opcode
)
331 if (aarch64_get_operand_class (opcode
->operands
[1])
332 == AARCH64_OPND_CLASS_FP_REG
)
335 else if (aarch64_get_operand_class (opcode
->operands
[0])
336 == AARCH64_OPND_CLASS_FP_REG
)
337 /* e.g. float2fix. */
340 { assert (0); abort (); }
344 /* Select the operand to do the encoding/decoding of the 'size' field in
345 the AdvSIMD scalar instructions.
346 The heuristic-based rule is that the destination operand is respected
350 select_operand_for_scalar_size_field_coding (const aarch64_opcode
*opcode
)
352 int src_size
= 0, dst_size
= 0;
353 if (aarch64_get_operand_class (opcode
->operands
[0])
354 == AARCH64_OPND_CLASS_SISD_REG
)
355 dst_size
= aarch64_get_qualifier_esize (opcode
->qualifiers_list
[0][0]);
356 if (aarch64_get_operand_class (opcode
->operands
[1])
357 == AARCH64_OPND_CLASS_SISD_REG
)
358 src_size
= aarch64_get_qualifier_esize (opcode
->qualifiers_list
[0][1]);
359 if (src_size
== dst_size
&& src_size
== 0)
360 { assert (0); abort (); }
361 /* When the result is not a sisd register or it is a long operantion. */
362 if (dst_size
== 0 || dst_size
== src_size
<< 1)
368 /* Select the operand to do the encoding/decoding of the 'size:Q' fields in
369 the AdvSIMD instructions. */
371 int aarch64_select_operand_for_sizeq_field_coding (const aarch64_opcode
*);
375 aarch64_insn
aarch64_get_operand_modifier_value (enum aarch64_modifier_kind
);
376 enum aarch64_modifier_kind
377 aarch64_get_operand_modifier_from_value (aarch64_insn
, bfd_boolean
);
380 bfd_boolean
aarch64_wide_constant_p (int64_t, int, unsigned int *);
381 bfd_boolean
aarch64_logical_immediate_p (uint64_t, int, aarch64_insn
*);
382 int aarch64_shrink_expanded_imm8 (uint64_t);
384 /* Copy the content of INST->OPERANDS[SRC] to INST->OPERANDS[DST]. */
386 copy_operand_info (aarch64_inst
*inst
, int dst
, int src
)
388 assert (dst
>= 0 && src
>= 0 && dst
< AARCH64_MAX_OPND_NUM
389 && src
< AARCH64_MAX_OPND_NUM
);
390 memcpy (&inst
->operands
[dst
], &inst
->operands
[src
],
391 sizeof (aarch64_opnd_info
));
392 inst
->operands
[dst
].idx
= dst
;
395 /* A primitive log caculator. */
397 static inline unsigned int
398 get_logsz (unsigned int size
)
400 const unsigned char ls
[16] =
401 {0, 1, -1, 2, -1, -1, -1, 3, -1, -1, -1, -1, -1, -1, -1, 4};
407 assert (ls
[size
- 1] != (unsigned char)-1);
411 #endif /* OPCODES_AARCH64_OPC_H */