1 /* aarch64-opc.h -- Header file for aarch64-opc.c and aarch64-opc-2.c.
2 Copyright (C) 2012-2024 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 this sorted alphanumerically and synced with the fields array
30 enum aarch64_field_kind
244 /* Field description. */
251 typedef struct aarch64_field aarch64_field
;
253 extern const aarch64_field fields
[];
255 /* Operand description. */
257 struct aarch64_operand
259 enum aarch64_operand_class op_class
;
261 /* Name of the operand code; used mainly for the purpose of internal
267 /* The associated instruction bit-fields; no operand has more than 4
269 enum aarch64_field_kind fields
[5];
271 /* Brief description */
275 typedef struct aarch64_operand aarch64_operand
;
277 extern const aarch64_operand aarch64_operands
[];
280 verify_constraints (const struct aarch64_inst
*, const aarch64_insn
, bfd_vma
,
281 bool, aarch64_operand_error
*, aarch64_instr_sequence
*);
285 #define OPD_F_HAS_INSERTER 0x00000001
286 #define OPD_F_HAS_EXTRACTOR 0x00000002
287 #define OPD_F_SEXT 0x00000004 /* Require sign-extension. */
288 #define OPD_F_SHIFT_BY_2 0x00000008 /* Need to left shift the field
289 value by 2 to get the value
290 of an immediate operand. */
291 #define OPD_F_MAYBE_SP 0x00000010 /* May potentially be SP. */
292 #define OPD_F_OD_MASK 0x000001e0 /* Operand-dependent data. */
293 #define OPD_F_OD_LSB 5
294 #define OPD_F_NO_ZR 0x00000200 /* ZR index not allowed. */
295 #define OPD_F_SHIFT_BY_3 0x00000400 /* Need to left shift the field
296 value by 3 to get the value
297 of an immediate operand. */
298 #define OPD_F_SHIFT_BY_4 0x00000800 /* Need to left shift the field
299 value by 4 to get the value
300 of an immediate operand. */
301 #define OPD_F_UNSIGNED 0x00001000 /* Expect an unsigned value. */
304 /* Register flags. */
307 #define F_DEPRECATED (1 << 0) /* Deprecated system register. */
310 #define F_ARCHEXT (1 << 1) /* Architecture dependent system register. */
313 #define F_HASXT (1 << 2) /* System instruction register <Xt>
317 #define F_REG_READ (1 << 3) /* Register can only be used to read values
321 #define F_REG_WRITE (1 << 4) /* Register can only be written to but not
325 #define F_REG_IN_CRM (1 << 5) /* Register extra encoding in CRm. */
328 #define F_REG_ALIAS (1 << 6) /* Register name aliases another. */
331 #define F_REG_128 (1 << 7) /* System regsister implementable as 128-bit wide. */
334 /* PSTATE field name for the MSR instruction this is encoded in "op1:op2:CRm".
335 Part of CRm can be used to encode <pstatefield>. E.g. CRm[3:1] for SME.
336 In order to set/get full PSTATE field name use flag F_REG_IN_CRM and below
337 macros to encode and decode CRm encoding.
339 #define PSTATE_ENCODE_CRM(val) (val << 6)
340 #define PSTATE_DECODE_CRM(flags) ((flags >> 6) & 0x0f)
343 #define F_IMM_IN_CRM (1 << 10) /* Immediate extra encoding in CRm. */
345 /* Also CRm may contain, in addition to <pstatefield> immediate.
346 E.g. CRm[0] <imm1> at bit 0 for SME. Use below macros to encode and decode
349 #define PSTATE_ENCODE_CRM_IMM(mask) (mask << 11)
350 #define PSTATE_DECODE_CRM_IMM(mask) ((mask >> 11) & 0x0f)
352 /* Helper macro to ENCODE CRm and its immediate. */
353 #define PSTATE_ENCODE_CRM_AND_IMM(CVAL,IMASK) \
354 (F_REG_IN_CRM | PSTATE_ENCODE_CRM(CVAL) \
355 | F_IMM_IN_CRM | PSTATE_ENCODE_CRM_IMM(IMASK))
357 /* Bits [15, 18] contain the maximum value for an immediate MSR. */
358 #define F_REG_MAX_VALUE(X) ((X) << 15)
359 #define F_GET_REG_MAX_VALUE(X) (((X) >> 15) & 0x0f)
361 /* HINT operand flags. */
362 #define HINT_OPD_F_NOPRINT (1 << 0) /* Should not be printed. */
364 /* Encode 7-bit HINT #imm in the lower 8 bits. Use higher bits for flags. */
365 #define HINT_ENCODE(flag, val) ((flag << 8) | val)
366 #define HINT_FLAG(val) (val >> 8)
367 #define HINT_VAL(val) (val & 0xff)
370 operand_has_inserter (const aarch64_operand
*operand
)
372 return (operand
->flags
& OPD_F_HAS_INSERTER
) != 0;
376 operand_has_extractor (const aarch64_operand
*operand
)
378 return (operand
->flags
& OPD_F_HAS_EXTRACTOR
) != 0;
382 operand_need_sign_extension (const aarch64_operand
*operand
)
384 return (operand
->flags
& OPD_F_SEXT
) != 0;
388 operand_need_shift_by_two (const aarch64_operand
*operand
)
390 return (operand
->flags
& OPD_F_SHIFT_BY_2
) != 0;
394 operand_need_shift_by_three (const aarch64_operand
*operand
)
396 return (operand
->flags
& OPD_F_SHIFT_BY_3
) != 0;
400 operand_need_shift_by_four (const aarch64_operand
*operand
)
402 return (operand
->flags
& OPD_F_SHIFT_BY_4
) != 0;
406 operand_need_unsigned_offset (const aarch64_operand
*operand
)
408 return (operand
->flags
& OPD_F_UNSIGNED
) != 0;
412 operand_maybe_stack_pointer (const aarch64_operand
*operand
)
414 return (operand
->flags
& OPD_F_MAYBE_SP
) != 0;
417 /* Return the value of the operand-specific data field (OPD_F_OD_MASK). */
418 static inline unsigned int
419 get_operand_specific_data (const aarch64_operand
*operand
)
421 return (operand
->flags
& OPD_F_OD_MASK
) >> OPD_F_OD_LSB
;
424 /* Return the width of field number N of operand *OPERAND. */
425 static inline unsigned
426 get_operand_field_width (const aarch64_operand
*operand
, unsigned n
)
428 assert (operand
->fields
[n
] != FLD_NIL
);
429 return fields
[operand
->fields
[n
]].width
;
432 /* Return the total width of the operand *OPERAND. */
433 static inline unsigned
434 get_operand_fields_width (const aarch64_operand
*operand
)
438 while (operand
->fields
[i
] != FLD_NIL
)
439 width
+= fields
[operand
->fields
[i
++]].width
;
440 assert (width
> 0 && width
< 32);
444 static inline const aarch64_operand
*
445 get_operand_from_code (enum aarch64_opnd code
)
447 return aarch64_operands
+ code
;
450 /* Operand qualifier and operand constraint checking. */
452 bool aarch64_match_operands_constraint (aarch64_inst
*,
453 aarch64_operand_error
*);
455 /* Operand qualifier related functions. */
456 const char* aarch64_get_qualifier_name (aarch64_opnd_qualifier_t
);
457 unsigned char aarch64_get_qualifier_nelem (aarch64_opnd_qualifier_t
);
458 aarch64_insn
aarch64_get_qualifier_standard_value (aarch64_opnd_qualifier_t
);
459 int aarch64_find_best_match (const aarch64_inst
*,
460 const aarch64_opnd_qualifier_seq_t
*,
461 int, aarch64_opnd_qualifier_t
*, int *);
464 reset_operand_qualifier (aarch64_inst
*inst
, int idx
)
466 assert (idx
>=0 && idx
< aarch64_num_of_operands (inst
->opcode
));
467 inst
->operands
[idx
].qualifier
= AARCH64_OPND_QLF_NIL
;
470 /* Inline functions operating on instruction bit-field(s). */
472 /* Generate a mask that has WIDTH number of consecutive 1s. */
474 static inline aarch64_insn
477 return ((aarch64_insn
) 1 << width
) - 1;
480 /* LSB_REL is the relative location of the lsb in the sub field, starting from 0. */
482 gen_sub_field (enum aarch64_field_kind kind
, int lsb_rel
, int width
, aarch64_field
*ret
)
484 const aarch64_field
*field
= &fields
[kind
];
485 if (lsb_rel
< 0 || width
<= 0 || lsb_rel
+ width
> field
->width
)
487 ret
->lsb
= field
->lsb
+ lsb_rel
;
492 /* Insert VALUE into FIELD of CODE. MASK can be zero or the base mask
496 insert_field_2 (const aarch64_field
*field
, aarch64_insn
*code
,
497 aarch64_insn value
, aarch64_insn mask
)
499 assert (field
->width
< 32 && field
->width
>= 1 && field
->lsb
>= 0
500 && field
->lsb
+ field
->width
<= 32);
501 value
&= gen_mask (field
->width
);
502 value
<<= field
->lsb
;
503 /* In some opcodes, field can be part of the base opcode, e.g. the size
504 field in FADD. The following helps avoid corrupt the base opcode. */
509 /* Extract FIELD of CODE and return the value. MASK can be zero or the base
510 mask of the opcode. */
512 static inline aarch64_insn
513 extract_field_2 (const aarch64_field
*field
, aarch64_insn code
,
517 /* Clear any bit that is a part of the base opcode. */
519 value
= (code
>> field
->lsb
) & gen_mask (field
->width
);
523 /* Insert VALUE into field KIND of CODE. MASK can be zero or the base mask
527 insert_field (enum aarch64_field_kind kind
, aarch64_insn
*code
,
528 aarch64_insn value
, aarch64_insn mask
)
530 insert_field_2 (&fields
[kind
], code
, value
, mask
);
533 /* Extract field KIND of CODE and return the value. MASK can be zero or the
534 base mask of the opcode. */
536 static inline aarch64_insn
537 extract_field (enum aarch64_field_kind kind
, aarch64_insn code
,
540 return extract_field_2 (&fields
[kind
], code
, mask
);
544 extract_fields (aarch64_insn code
, aarch64_insn mask
, ...);
546 /* Inline functions selecting operand to do the encoding/decoding for a
547 certain instruction bit-field. */
549 /* Select the operand to do the encoding/decoding of the 'sf' field.
550 The heuristic-based rule is that the result operand is respected more. */
553 select_operand_for_sf_field_coding (const aarch64_opcode
*opcode
)
556 if (aarch64_get_operand_class (opcode
->operands
[0])
557 == AARCH64_OPND_CLASS_INT_REG
)
560 else if (aarch64_get_operand_class (opcode
->operands
[1])
561 == AARCH64_OPND_CLASS_INT_REG
)
562 /* e.g. float2fix. */
565 { assert (0); abort (); }
569 /* Select the operand to do the encoding/decoding of the 'type' field in
570 the floating-point instructions.
571 The heuristic-based rule is that the source operand is respected more. */
574 select_operand_for_fptype_field_coding (const aarch64_opcode
*opcode
)
577 if (aarch64_get_operand_class (opcode
->operands
[1])
578 == AARCH64_OPND_CLASS_FP_REG
)
581 else if (aarch64_get_operand_class (opcode
->operands
[0])
582 == AARCH64_OPND_CLASS_FP_REG
)
583 /* e.g. float2fix. */
586 { assert (0); abort (); }
590 /* Select the operand to do the encoding/decoding of the 'size' field in
591 the AdvSIMD scalar instructions.
592 The heuristic-based rule is that the destination operand is respected
596 select_operand_for_scalar_size_field_coding (const aarch64_opcode
*opcode
)
598 int src_size
= 0, dst_size
= 0;
599 if (aarch64_get_operand_class (opcode
->operands
[0])
600 == AARCH64_OPND_CLASS_SISD_REG
)
601 dst_size
= aarch64_get_qualifier_esize (opcode
->qualifiers_list
[0][0]);
602 if (aarch64_get_operand_class (opcode
->operands
[1])
603 == AARCH64_OPND_CLASS_SISD_REG
)
604 src_size
= aarch64_get_qualifier_esize (opcode
->qualifiers_list
[0][1]);
605 if (src_size
== dst_size
&& src_size
== 0)
606 { assert (0); abort (); }
607 /* When the result is not a sisd register or it is a long operantion. */
608 if (dst_size
== 0 || dst_size
== src_size
<< 1)
614 /* Select the operand to do the encoding/decoding of the 'size:Q' fields in
615 the AdvSIMD instructions. */
617 int aarch64_select_operand_for_sizeq_field_coding (const aarch64_opcode
*);
621 aarch64_insn
aarch64_get_operand_modifier_value (enum aarch64_modifier_kind
);
622 enum aarch64_modifier_kind
623 aarch64_get_operand_modifier_from_value (aarch64_insn
, bool);
626 bool aarch64_wide_constant_p (uint64_t, int, unsigned int *);
627 bool aarch64_logical_immediate_p (uint64_t, int, aarch64_insn
*);
628 int aarch64_shrink_expanded_imm8 (uint64_t);
630 /* Copy the content of INST->OPERANDS[SRC] to INST->OPERANDS[DST]. */
632 copy_operand_info (aarch64_inst
*inst
, int dst
, int src
)
634 assert (dst
>= 0 && src
>= 0 && dst
< AARCH64_MAX_OPND_NUM
635 && src
< AARCH64_MAX_OPND_NUM
);
636 memcpy (&inst
->operands
[dst
], &inst
->operands
[src
],
637 sizeof (aarch64_opnd_info
));
638 inst
->operands
[dst
].idx
= dst
;
641 /* A primitive log caculator. */
643 static inline unsigned int
644 get_logsz (unsigned int size
)
646 const unsigned char ls
[16] =
647 {0, 1, -1, 2, -1, -1, -1, 3, -1, -1, -1, -1, -1, -1, -1, 4};
653 assert (ls
[size
- 1] != (unsigned char)-1);
657 #endif /* OPCODES_AARCH64_OPC_H */