[thirdparty/binutils-gdb.git] / opcodes / aarch64-opc.h

/* aarch64-opc.h -- Header file for aarch64-opc.c and aarch64-opc-2.c.
   Copyright (C) 2012-2021 Free Software Foundation, Inc.
   Contributed by ARM Ltd.

   This file is part of the GNU opcodes library.

   This library is free software; you can redistribute it and/or modify
   it under the terms of the GNU General Public License as published by
   the Free Software Foundation; either version 3, or (at your option)
   any later version.

   It is distributed in the hope that it will be useful, but WITHOUT
   ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
   or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public
   License for more details.

   You should have received a copy of the GNU General Public License
   along with this program; see the file COPYING3. If not,
   see <http://www.gnu.org/licenses/>.  */

#ifndef OPCODES_AARCH64_OPC_H
#define OPCODES_AARCH64_OPC_H

#include <string.h>
#include "opcode/aarch64.h"

/* Instruction fields.
   Keep synced with fields.  */
enum aarch64_field_kind
{
  FLD_NIL,
  FLD_cond2,
  FLD_nzcv,
  FLD_defgh,
  FLD_abc,
  FLD_imm19,
  FLD_immhi,
  FLD_immlo,
  FLD_size,
  FLD_vldst_size,
  FLD_op,
  FLD_Q,
  FLD_Rt,
  FLD_Rd,
  FLD_Rn,
  FLD_Rt2,
  FLD_Ra,
  FLD_op2,
  FLD_CRm,
  FLD_CRn,
  FLD_op1,
  FLD_op0,
  FLD_imm3,
  FLD_cond,
  FLD_opcode,
  FLD_cmode,
  FLD_asisdlso_opcode,
  FLD_len,
  FLD_Rm,
  FLD_Rs,
  FLD_option,
  FLD_S,
  FLD_hw,
  FLD_opc,
  FLD_opc1,
  FLD_shift,
  FLD_type,
  FLD_ldst_size,
  FLD_imm6,
  FLD_imm6_2,
  FLD_imm4,
  FLD_imm4_2,
  FLD_imm4_3,
  FLD_imm5,
  FLD_imm7,
  FLD_imm8,
  FLD_imm9,
  FLD_imm12,
  FLD_imm14,
  FLD_imm16,
  FLD_imm16_2,
  FLD_imm26,
  FLD_imms,
  FLD_immr,
  FLD_immb,
  FLD_immh,
  FLD_S_imm10,
  FLD_N,
  FLD_index,
  FLD_index2,
  FLD_sf,
  FLD_lse_sz,
  FLD_H,
  FLD_L,
  FLD_M,
  FLD_b5,
  FLD_b40,
  FLD_scale,
  FLD_SVE_M_4,
  FLD_SVE_M_14,
  FLD_SVE_M_16,
  FLD_SVE_N,
  FLD_SVE_Pd,
  FLD_SVE_Pg3,
  FLD_SVE_Pg4_5,
  FLD_SVE_Pg4_10,
  FLD_SVE_Pg4_16,
  FLD_SVE_Pm,
  FLD_SVE_Pn,
  FLD_SVE_Pt,
  FLD_SVE_Rm,
  FLD_SVE_Rn,
  FLD_SVE_Vd,
  FLD_SVE_Vm,
  FLD_SVE_Vn,
  FLD_SVE_Za_5,
  FLD_SVE_Za_16,
  FLD_SVE_Zd,
  FLD_SVE_Zm_5,
  FLD_SVE_Zm_16,
  FLD_SVE_Zn,
  FLD_SVE_Zt,
  FLD_SVE_i1,
  FLD_SVE_i3h,
  FLD_SVE_i3l,
  FLD_SVE_i3h2,
  FLD_SVE_i2h,
  FLD_SVE_imm3,
  FLD_SVE_imm4,
  FLD_SVE_imm5,
  FLD_SVE_imm5b,
  FLD_SVE_imm6,
  FLD_SVE_imm7,
  FLD_SVE_imm8,
  FLD_SVE_imm9,
  FLD_SVE_immr,
  FLD_SVE_imms,
  FLD_SVE_msz,
  FLD_SVE_pattern,
  FLD_SVE_prfop,
  FLD_SVE_rot1,
  FLD_SVE_rot2,
  FLD_SVE_rot3,
  FLD_SVE_sz,
  FLD_SVE_size,
  FLD_SVE_sz2,
  FLD_SVE_tsz,
  FLD_SVE_tszh,
  FLD_SVE_tszl_8,
  FLD_SVE_tszl_19,
  FLD_SVE_xs_14,
  FLD_SVE_xs_22,
  FLD_rotate1,
  FLD_rotate2,
  FLD_rotate3,
  FLD_SM3_imm2,
  FLD_sz,
  FLD_CRm_dsb_nxs
};

/* Field description.  */
struct aarch64_field
{
  int lsb;
  int width;
};

typedef struct aarch64_field aarch64_field;

extern const aarch64_field fields[];
\f
/* Operand description.  */

struct aarch64_operand
{
  enum aarch64_operand_class op_class;

  /* Name of the operand code; used mainly for the purpose of internal
     debugging.  */
  const char *name;

  unsigned int flags;

  /* The associated instruction bit-fields; no operand has more than 4
     bit-fields */
  enum aarch64_field_kind fields[4];

  /* Brief description */
  const char *desc;
};

typedef struct aarch64_operand aarch64_operand;

extern const aarch64_operand aarch64_operands[];

enum err_type
verify_constraints (const struct aarch64_inst *, const aarch64_insn, bfd_vma,
		    bfd_boolean, aarch64_operand_error *, aarch64_instr_sequence*);

/* Operand flags.  */

#define OPD_F_HAS_INSERTER	0x00000001
#define OPD_F_HAS_EXTRACTOR	0x00000002
#define OPD_F_SEXT		0x00000004	/* Require sign-extension.  */
#define OPD_F_SHIFT_BY_2	0x00000008	/* Need to left shift the field
						   value by 2 to get the value
						   of an immediate operand.  */
#define OPD_F_MAYBE_SP		0x00000010	/* May potentially be SP.  */
#define OPD_F_OD_MASK		0x000000e0	/* Operand-dependent data.  */
#define OPD_F_OD_LSB		5
#define OPD_F_NO_ZR		0x00000100	/* ZR index not allowed.  */
#define OPD_F_SHIFT_BY_4	0x00000200	/* Need to left shift the field
						   value by 4 to get the value
						   of an immediate operand.  */


/* Register flags.  */

#undef F_DEPRECATED
#define F_DEPRECATED	(1 << 0)  /* Deprecated system register.  */

#undef F_ARCHEXT
#define F_ARCHEXT	(1 << 1)  /* Architecture dependent system register.  */

#undef F_HASXT
#define F_HASXT		(1 << 2)  /* System instruction register <Xt>
				     operand.  */

#undef F_REG_READ
#define F_REG_READ	(1 << 3)  /* Register can only be used to read values
				     out of.  */

#undef F_REG_WRITE
#define F_REG_WRITE	(1 << 4)  /* Register can only be written to but not
				     read from.  */

/* HINT operand flags.  */
#define HINT_OPD_F_NOPRINT	(1 << 0)  /* Should not be printed.  */

/* Encode 7-bit HINT #imm in the lower 8 bits.  Use higher bits for flags.  */
#define HINT_ENCODE(flag, val) ((flag << 8) | val)
#define HINT_FLAG(val) (val >> 8)
#define HINT_VAL(val) (val & 0xff)

static inline bfd_boolean
operand_has_inserter (const aarch64_operand *operand)
{
  return (operand->flags & OPD_F_HAS_INSERTER) ? TRUE : FALSE;
}

static inline bfd_boolean
operand_has_extractor (const aarch64_operand *operand)
{
  return (operand->flags & OPD_F_HAS_EXTRACTOR) ? TRUE : FALSE;
}

static inline bfd_boolean
operand_need_sign_extension (const aarch64_operand *operand)
{
  return (operand->flags & OPD_F_SEXT) ? TRUE : FALSE;
}

static inline bfd_boolean
operand_need_shift_by_two (const aarch64_operand *operand)
{
  return (operand->flags & OPD_F_SHIFT_BY_2) ? TRUE : FALSE;
}

static inline bfd_boolean
operand_need_shift_by_four (const aarch64_operand *operand)
{
  return (operand->flags & OPD_F_SHIFT_BY_4) ? TRUE : FALSE;
}

static inline bfd_boolean
operand_maybe_stack_pointer (const aarch64_operand *operand)
{
  return (operand->flags & OPD_F_MAYBE_SP) ? TRUE : FALSE;
}

/* Return the value of the operand-specific data field (OPD_F_OD_MASK).  */
static inline unsigned int
get_operand_specific_data (const aarch64_operand *operand)
{
  return (operand->flags & OPD_F_OD_MASK) >> OPD_F_OD_LSB;
}

/* Return the width of field number N of operand *OPERAND.  */
static inline unsigned
get_operand_field_width (const aarch64_operand *operand, unsigned n)
{
  assert (operand->fields[n] != FLD_NIL);
  return fields[operand->fields[n]].width;
}

/* Return the total width of the operand *OPERAND.  */
static inline unsigned
get_operand_fields_width (const aarch64_operand *operand)
{
  int i = 0;
  unsigned width = 0;
  while (operand->fields[i] != FLD_NIL)
    width += fields[operand->fields[i++]].width;
  assert (width > 0 && width < 32);
  return width;
}

static inline const aarch64_operand *
get_operand_from_code (enum aarch64_opnd code)
{
  return aarch64_operands + code;
}
\f
/* Operand qualifier and operand constraint checking.  */

int aarch64_match_operands_constraint (aarch64_inst *,
				       aarch64_operand_error *);

/* Operand qualifier related functions.  */
const char* aarch64_get_qualifier_name (aarch64_opnd_qualifier_t);
unsigned char aarch64_get_qualifier_nelem (aarch64_opnd_qualifier_t);
aarch64_insn aarch64_get_qualifier_standard_value (aarch64_opnd_qualifier_t);
int aarch64_find_best_match (const aarch64_inst *,
			     const aarch64_opnd_qualifier_seq_t *,
			     int, aarch64_opnd_qualifier_t *);

static inline void
reset_operand_qualifier (aarch64_inst *inst, int idx)
{
  assert (idx >=0 && idx < aarch64_num_of_operands (inst->opcode));
  inst->operands[idx].qualifier = AARCH64_OPND_QLF_NIL;
}
\f
/* Inline functions operating on instruction bit-field(s).  */

/* Generate a mask that has WIDTH number of consecutive 1s.  */

static inline aarch64_insn
gen_mask (int width)
{
  return ((aarch64_insn) 1 << width) - 1;
}

/* LSB_REL is the relative location of the lsb in the sub field, starting from 0.  */
static inline int
gen_sub_field (enum aarch64_field_kind kind, int lsb_rel, int width, aarch64_field *ret)
{
  const aarch64_field *field = &fields[kind];
  if (lsb_rel < 0 || width <= 0 || lsb_rel + width > field->width)
    return 0;
  ret->lsb = field->lsb + lsb_rel;
  ret->width = width;
  return 1;
}

/* Insert VALUE into FIELD of CODE.  MASK can be zero or the base mask
   of the opcode.  */

static inline void
insert_field_2 (const aarch64_field *field, aarch64_insn *code,
		aarch64_insn value, aarch64_insn mask)
{
  assert (field->width < 32 && field->width >= 1 && field->lsb >= 0
	  && field->lsb + field->width <= 32);
  value &= gen_mask (field->width);
  value <<= field->lsb;
  /* In some opcodes, field can be part of the base opcode, e.g. the size
     field in FADD.  The following helps avoid corrupt the base opcode.  */
  value &= ~mask;
  *code |= value;
}

/* Extract FIELD of CODE and return the value.  MASK can be zero or the base
   mask of the opcode.  */

static inline aarch64_insn
extract_field_2 (const aarch64_field *field, aarch64_insn code,
		 aarch64_insn mask)
{
  aarch64_insn value;
  /* Clear any bit that is a part of the base opcode.  */
  code &= ~mask;
  value = (code >> field->lsb) & gen_mask (field->width);
  return value;
}

/* Insert VALUE into field KIND of CODE.  MASK can be zero or the base mask
   of the opcode.  */

static inline void
insert_field (enum aarch64_field_kind kind, aarch64_insn *code,
	      aarch64_insn value, aarch64_insn mask)
{
  insert_field_2 (&fields[kind], code, value, mask);
}

/* Extract field KIND of CODE and return the value.  MASK can be zero or the
   base mask of the opcode.  */

static inline aarch64_insn
extract_field (enum aarch64_field_kind kind, aarch64_insn code,
	       aarch64_insn mask)
{
  return extract_field_2 (&fields[kind], code, mask);
}

extern aarch64_insn
extract_fields (aarch64_insn code, aarch64_insn mask, ...);
\f
/* Inline functions selecting operand to do the encoding/decoding for a
   certain instruction bit-field.  */

/* Select the operand to do the encoding/decoding of the 'sf' field.
   The heuristic-based rule is that the result operand is respected more.  */

static inline int
select_operand_for_sf_field_coding (const aarch64_opcode *opcode)
{
  int idx = -1;
  if (aarch64_get_operand_class (opcode->operands[0])
      == AARCH64_OPND_CLASS_INT_REG)
    /* normal case.  */
    idx = 0;
  else if (aarch64_get_operand_class (opcode->operands[1])
	   == AARCH64_OPND_CLASS_INT_REG)
    /* e.g. float2fix.  */
    idx = 1;
  else
    { assert (0); abort (); }
  return idx;
}

/* Select the operand to do the encoding/decoding of the 'type' field in
   the floating-point instructions.
   The heuristic-based rule is that the source operand is respected more.  */

static inline int
select_operand_for_fptype_field_coding (const aarch64_opcode *opcode)
{
  int idx;
  if (aarch64_get_operand_class (opcode->operands[1])
      == AARCH64_OPND_CLASS_FP_REG)
    /* normal case.  */
    idx = 1;
  else if (aarch64_get_operand_class (opcode->operands[0])
	   == AARCH64_OPND_CLASS_FP_REG)
    /* e.g. float2fix.  */
    idx = 0;
  else
    { assert (0); abort (); }
  return idx;
}

/* Select the operand to do the encoding/decoding of the 'size' field in
   the AdvSIMD scalar instructions.
   The heuristic-based rule is that the destination operand is respected
   more.  */

static inline int
select_operand_for_scalar_size_field_coding (const aarch64_opcode *opcode)
{
  int src_size = 0, dst_size = 0;
  if (aarch64_get_operand_class (opcode->operands[0])
      == AARCH64_OPND_CLASS_SISD_REG)
    dst_size = aarch64_get_qualifier_esize (opcode->qualifiers_list[0][0]);
  if (aarch64_get_operand_class (opcode->operands[1])
      == AARCH64_OPND_CLASS_SISD_REG)
    src_size = aarch64_get_qualifier_esize (opcode->qualifiers_list[0][1]);
  if (src_size == dst_size && src_size == 0)
    { assert (0); abort (); }
  /* When the result is not a sisd register or it is a long operantion.  */
  if (dst_size == 0 || dst_size == src_size << 1)
    return 1;
  else
    return 0;
}

/* Select the operand to do the encoding/decoding of the 'size:Q' fields in
   the AdvSIMD instructions.  */

int aarch64_select_operand_for_sizeq_field_coding (const aarch64_opcode *);
\f
/* Miscellaneous.  */

aarch64_insn aarch64_get_operand_modifier_value (enum aarch64_modifier_kind);
enum aarch64_modifier_kind
aarch64_get_operand_modifier_from_value (aarch64_insn, bfd_boolean);


bfd_boolean aarch64_wide_constant_p (uint64_t, int, unsigned int *);
bfd_boolean aarch64_logical_immediate_p (uint64_t, int, aarch64_insn *);
int aarch64_shrink_expanded_imm8 (uint64_t);

/* Copy the content of INST->OPERANDS[SRC] to INST->OPERANDS[DST].  */
static inline void
copy_operand_info (aarch64_inst *inst, int dst, int src)
{
  assert (dst >= 0 && src >= 0 && dst < AARCH64_MAX_OPND_NUM
	  && src < AARCH64_MAX_OPND_NUM);
  memcpy (&inst->operands[dst], &inst->operands[src],
	  sizeof (aarch64_opnd_info));
  inst->operands[dst].idx = dst;
}

/* A primitive log caculator.  */

static inline unsigned int
get_logsz (unsigned int size)
{
  const unsigned char ls[16] =
    {0, 1, -1, 2, -1, -1, -1, 3, -1, -1, -1, -1, -1, -1, -1, 4};
  if (size > 16)
    {
      assert (0);
      return -1;
    }
  assert (ls[size - 1] != (unsigned char)-1);
  return ls[size - 1];
}

#endif /* OPCODES_AARCH64_OPC_H */
Commit	Line	Data
a06ea964	1	/* aarch64-opc.h -- Header file for aarch64-opc.c and aarch64-opc-2.c.
250d07de	2	Copyright (C) 2012-2021 Free Software Foundation, Inc.
a06ea964 NC	3	Contributed by ARM Ltd.
	4
	5	This file is part of the GNU opcodes library.
	6
	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)
	10	any later version.
	11
	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.
	16
	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/>. */
	20
	21	#ifndef OPCODES_AARCH64_OPC_H
	22	#define OPCODES_AARCH64_OPC_H
	23
	24	#include <string.h>
	25	#include "opcode/aarch64.h"
	26
	27	/* Instruction fields.
	28	Keep synced with fields. */
	29	enum aarch64_field_kind
	30	{
	31	FLD_NIL,
	32	FLD_cond2,
	33	FLD_nzcv,
	34	FLD_defgh,
	35	FLD_abc,
	36	FLD_imm19,
	37	FLD_immhi,
	38	FLD_immlo,
	39	FLD_size,
	40	FLD_vldst_size,
	41	FLD_op,
	42	FLD_Q,
	43	FLD_Rt,
	44	FLD_Rd,
	45	FLD_Rn,
	46	FLD_Rt2,
	47	FLD_Ra,
	48	FLD_op2,
	49	FLD_CRm,
	50	FLD_CRn,
	51	FLD_op1,
	52	FLD_op0,
	53	FLD_imm3,
	54	FLD_cond,
	55	FLD_opcode,
	56	FLD_cmode,
	57	FLD_asisdlso_opcode,
	58	FLD_len,
	59	FLD_Rm,
	60	FLD_Rs,
	61	FLD_option,
	62	FLD_S,
	63	FLD_hw,
	64	FLD_opc,
	65	FLD_opc1,
	66	FLD_shift,
67	FLD_type,
68	FLD_ldst_size,
69	FLD_imm6,
f42f1a1d	70	FLD_imm6_2,
a06ea964	71	FLD_imm4,
f42f1a1d	72	FLD_imm4_2,
193614f2	73	FLD_imm4_3,
a06ea964 NC	74	FLD_imm5,
	75	FLD_imm7,
	76	FLD_imm8,
	77	FLD_imm9,
	78	FLD_imm12,
	79	FLD_imm14,
	80	FLD_imm16,
09c1e68a	81	FLD_imm16_2,
a06ea964 NC	82	FLD_imm26,
	83	FLD_imms,
	84	FLD_immr,
	85	FLD_immb,
	86	FLD_immh,
3f06e550	87	FLD_S_imm10,
a06ea964 NC	88	FLD_N,
	89	FLD_index,
	90	FLD_index2,
	91	FLD_sf,
ee804238	92	FLD_lse_sz,
a06ea964 NC	93	FLD_H,
	94	FLD_L,
	95	FLD_M,
	96	FLD_b5,
	97	FLD_b40,
	98	FLD_scale,
116b6019 RS	99	FLD_SVE_M_4,
	100	FLD_SVE_M_14,
	101	FLD_SVE_M_16,
e950b345	102	FLD_SVE_N,
f11ad6bc RS	103	FLD_SVE_Pd,
	104	FLD_SVE_Pg3,
	105	FLD_SVE_Pg4_5,
	106	FLD_SVE_Pg4_10,
	107	FLD_SVE_Pg4_16,
	108	FLD_SVE_Pm,
	109	FLD_SVE_Pn,
	110	FLD_SVE_Pt,
047cd301 RS	111	FLD_SVE_Rm,
	112	FLD_SVE_Rn,
	113	FLD_SVE_Vd,
	114	FLD_SVE_Vm,
	115	FLD_SVE_Vn,
f11ad6bc RS	116	FLD_SVE_Za_5,
	117	FLD_SVE_Za_16,
	118	FLD_SVE_Zd,
	119	FLD_SVE_Zm_5,
	120	FLD_SVE_Zm_16,
	121	FLD_SVE_Zn,
	122	FLD_SVE_Zt,
165d4950	123	FLD_SVE_i1,
582e12bf	124	FLD_SVE_i3h,
116adc27 MM	125	FLD_SVE_i3l,
116adc27 MM	126	FLD_SVE_i3h2,
31e36ab3	127	FLD_SVE_i2h,
e950b345	128	FLD_SVE_imm3,
2442d846	129	FLD_SVE_imm4,
e950b345 RS	130	FLD_SVE_imm5,
e950b345 RS	131	FLD_SVE_imm5b,
4df068de	132	FLD_SVE_imm6,
e950b345 RS	133	FLD_SVE_imm7,
	134	FLD_SVE_imm8,
	135	FLD_SVE_imm9,
	136	FLD_SVE_immr,
	137	FLD_SVE_imms,
4df068de	138	FLD_SVE_msz,
245d2e3f RS	139	FLD_SVE_pattern,
245d2e3f RS	140	FLD_SVE_prfop,
582e12bf RS	141	FLD_SVE_rot1,
582e12bf RS	142	FLD_SVE_rot2,
adccc507	143	FLD_SVE_rot3,
116b6019	144	FLD_SVE_sz,
3bd82c86	145	FLD_SVE_size,
0a57e14f	146	FLD_SVE_sz2,
116b6019	147	FLD_SVE_tsz,
f11ad6bc	148	FLD_SVE_tszh,
116b6019 RS	149	FLD_SVE_tszl_8,
116b6019 RS	150	FLD_SVE_tszl_19,
4df068de RS	151	FLD_SVE_xs_14,
4df068de RS	152	FLD_SVE_xs_22,
c2c4ff8d SN	153	FLD_rotate1,
	154	FLD_rotate2,
	155	FLD_rotate3,
6456d318	156	FLD_SM3_imm2,
fd195909 PW	157	FLD_sz,
fd195909 PW	158	FLD_CRm_dsb_nxs
a06ea964 NC	159	};
	160
	161	/* Field description. */
	162	struct aarch64_field
	163	{
	164	int lsb;
	165	int width;
	166	};
	167
	168	typedef struct aarch64_field aarch64_field;
	169
	170	extern const aarch64_field fields[];
	171	\f
	172	/* Operand description. */
	173
	174	struct aarch64_operand
	175	{
	176	enum aarch64_operand_class op_class;
	177
	178	/* Name of the operand code; used mainly for the purpose of internal
	179	debugging. */
	180	const char *name;
	181
	182	unsigned int flags;
	183
	184	/* The associated instruction bit-fields; no operand has more than 4
	185	bit-fields */
	186	enum aarch64_field_kind fields[4];
	187
	188	/* Brief description */
	189	const char *desc;
	190	};
	191
	192	typedef struct aarch64_operand aarch64_operand;
	193
	194	extern const aarch64_operand aarch64_operands[];
	195
a68f4cd2 TC	196	enum err_type
	197	verify_constraints (const struct aarch64_inst *, const aarch64_insn, bfd_vma,
	198	bfd_boolean, aarch64_operand_error , aarch64_instr_sequence);
	199
a06ea964 NC	200	/* Operand flags. */
	201
	202	#define OPD_F_HAS_INSERTER 0x00000001
	203	#define OPD_F_HAS_EXTRACTOR 0x00000002
	204	#define OPD_F_SEXT 0x00000004 /* Require sign-extension. */
	205	#define OPD_F_SHIFT_BY_2 0x00000008 /* Need to left shift the field
	206	value by 2 to get the value
	207	of an immediate operand. */
	208	#define OPD_F_MAYBE_SP 0x00000010 /* May potentially be SP. */
582e12bf	209	#define OPD_F_OD_MASK 0x000000e0 /* Operand-dependent data. */
4df068de	210	#define OPD_F_OD_LSB 5
582e12bf	211	#define OPD_F_NO_ZR 0x00000100 /* ZR index not allowed. */
193614f2 SD	212	#define OPD_F_SHIFT_BY_4 0x00000200 /* Need to left shift the field
	213	value by 4 to get the value
	214	of an immediate operand. */
	215
a06ea964	216
f9830ec1 TC	217	/* Register flags. */
	218
	219	#undef F_DEPRECATED
	220	#define F_DEPRECATED (1 << 0) /* Deprecated system register. */
	221
	222	#undef F_ARCHEXT
	223	#define F_ARCHEXT (1 << 1) /* Architecture dependent system register. */
	224
	225	#undef F_HASXT
	226	#define F_HASXT (1 << 2) /* System instruction register <Xt>
	227	operand. */
	228
	229	#undef F_REG_READ
	230	#define F_REG_READ (1 << 3) /* Register can only be used to read values
	231	out of. */
	232
	233	#undef F_REG_WRITE
	234	#define F_REG_WRITE (1 << 4) /* Register can only be written to but not
	235	read from. */
	236
ff605452 SD	237	/* HINT operand flags. */
	238	#define HINT_OPD_F_NOPRINT (1 << 0) /* Should not be printed. */
	239
	240	/* Encode 7-bit HINT #imm in the lower 8 bits. Use higher bits for flags. */
	241	#define HINT_ENCODE(flag, val) ((flag << 8) \| val)
	242	#define HINT_FLAG(val) (val >> 8)
	243	#define HINT_VAL(val) (val & 0xff)
	244
a06ea964 NC	245	static inline bfd_boolean
	246	operand_has_inserter (const aarch64_operand *operand)
	247	{
	248	return (operand->flags & OPD_F_HAS_INSERTER) ? TRUE : FALSE;
	249	}
	250
	251	static inline bfd_boolean
	252	operand_has_extractor (const aarch64_operand *operand)
	253	{
	254	return (operand->flags & OPD_F_HAS_EXTRACTOR) ? TRUE : FALSE;
	255	}
	256
	257	static inline bfd_boolean
	258	operand_need_sign_extension (const aarch64_operand *operand)
	259	{
	260	return (operand->flags & OPD_F_SEXT) ? TRUE : FALSE;
	261	}
	262
	263	static inline bfd_boolean
	264	operand_need_shift_by_two (const aarch64_operand *operand)
	265	{
	266	return (operand->flags & OPD_F_SHIFT_BY_2) ? TRUE : FALSE;
	267	}
	268
193614f2 SD	269	static inline bfd_boolean
	270	operand_need_shift_by_four (const aarch64_operand *operand)
	271	{
	272	return (operand->flags & OPD_F_SHIFT_BY_4) ? TRUE : FALSE;
	273	}
	274
a06ea964 NC	275	static inline bfd_boolean
	276	operand_maybe_stack_pointer (const aarch64_operand *operand)
	277	{
	278	return (operand->flags & OPD_F_MAYBE_SP) ? TRUE : FALSE;
	279	}
	280
4df068de RS	281	/* Return the value of the operand-specific data field (OPD_F_OD_MASK). */
	282	static inline unsigned int
	283	get_operand_specific_data (const aarch64_operand *operand)
	284	{
	285	return (operand->flags & OPD_F_OD_MASK) >> OPD_F_OD_LSB;
	286	}
	287
582e12bf RS	288	/* Return the width of field number N of operand OPERAND. /
	289	static inline unsigned
	290	get_operand_field_width (const aarch64_operand *operand, unsigned n)
	291	{
	292	assert (operand->fields[n] != FLD_NIL);
	293	return fields[operand->fields[n]].width;
	294	}
	295
a06ea964 NC	296	/* Return the total width of the operand OPERAND. /
	297	static inline unsigned
	298	get_operand_fields_width (const aarch64_operand *operand)
	299	{
	300	int i = 0;
	301	unsigned width = 0;
	302	while (operand->fields[i] != FLD_NIL)
	303	width += fields[operand->fields[i++]].width;
	304	assert (width > 0 && width < 32);
	305	return width;
	306	}
	307
	308	static inline const aarch64_operand *
	309	get_operand_from_code (enum aarch64_opnd code)
	310	{
	311	return aarch64_operands + code;
	312	}
	313	\f
	314	/* Operand qualifier and operand constraint checking. */
	315
	316	int aarch64_match_operands_constraint (aarch64_inst *,
	317	aarch64_operand_error *);
	318
	319	/* Operand qualifier related functions. */
	320	const char* aarch64_get_qualifier_name (aarch64_opnd_qualifier_t);
	321	unsigned char aarch64_get_qualifier_nelem (aarch64_opnd_qualifier_t);
	322	aarch64_insn aarch64_get_qualifier_standard_value (aarch64_opnd_qualifier_t);
	323	int aarch64_find_best_match (const aarch64_inst *,
	324	const aarch64_opnd_qualifier_seq_t *,
	325	int, aarch64_opnd_qualifier_t *);
	326
	327	static inline void
	328	reset_operand_qualifier (aarch64_inst *inst, int idx)
	329	{
	330	assert (idx >=0 && idx < aarch64_num_of_operands (inst->opcode));
	331	inst->operands[idx].qualifier = AARCH64_OPND_QLF_NIL;
	332	}
	333	\f
	334	/* Inline functions operating on instruction bit-field(s). */
	335
	336	/* Generate a mask that has WIDTH number of consecutive 1s. */
	337
	338	static inline aarch64_insn
	339	gen_mask (int width)
	340	{
5bb3703f	341	return ((aarch64_insn) 1 << width) - 1;
a06ea964 NC	342	}
	343
	344	/* LSB_REL is the relative location of the lsb in the sub field, starting from 0. */
	345	static inline int
	346	gen_sub_field (enum aarch64_field_kind kind, int lsb_rel, int width, aarch64_field *ret)
	347	{
	348	const aarch64_field *field = &fields[kind];
	349	if (lsb_rel < 0 \|\| width <= 0 \|\| lsb_rel + width > field->width)
	350	return 0;
	351	ret->lsb = field->lsb + lsb_rel;
	352	ret->width = width;
	353	return 1;
	354	}
	355
	356	/* Insert VALUE into FIELD of CODE. MASK can be zero or the base mask
	357	of the opcode. */
	358
	359	static inline void
	360	insert_field_2 (const aarch64_field field, aarch64_insn code,
	361	aarch64_insn value, aarch64_insn mask)
	362	{
	363	assert (field->width < 32 && field->width >= 1 && field->lsb >= 0
	364	&& field->lsb + field->width <= 32);
	365	value &= gen_mask (field->width);
	366	value <<= field->lsb;
	367	/* In some opcodes, field can be part of the base opcode, e.g. the size
	368	field in FADD. The following helps avoid corrupt the base opcode. */
	369	value &= ~mask;
	370	*code \|= value;
	371	}
	372
	373	/* Extract FIELD of CODE and return the value. MASK can be zero or the base
	374	mask of the opcode. */
	375
	376	static inline aarch64_insn
	377	extract_field_2 (const aarch64_field *field, aarch64_insn code,
	378	aarch64_insn mask)
	379	{
	380	aarch64_insn value;
	381	/* Clear any bit that is a part of the base opcode. */
	382	code &= ~mask;
	383	value = (code >> field->lsb) & gen_mask (field->width);
	384	return value;
	385	}
	386
	387	/* Insert VALUE into field KIND of CODE. MASK can be zero or the base mask
	388	of the opcode. */
	389
	390	static inline void
	391	insert_field (enum aarch64_field_kind kind, aarch64_insn *code,
	392	aarch64_insn value, aarch64_insn mask)
	393	{
	394	insert_field_2 (&fields[kind], code, value, mask);
	395	}
	396
	397	/* Extract field KIND of CODE and return the value. MASK can be zero or the
	398	base mask of the opcode. */
	399
	400	static inline aarch64_insn
	401	extract_field (enum aarch64_field_kind kind, aarch64_insn code,
	402	aarch64_insn mask)
	403	{
	404	return extract_field_2 (&fields[kind], code, mask);
	405	}
c0890d26 RS	406
	407	extern aarch64_insn
	408	extract_fields (aarch64_insn code, aarch64_insn mask, ...);
a06ea964 NC	409	\f
	410	/* Inline functions selecting operand to do the encoding/decoding for a
	411	certain instruction bit-field. */
	412
	413	/* Select the operand to do the encoding/decoding of the 'sf' field.
	414	The heuristic-based rule is that the result operand is respected more. */
	415
	416	static inline int
	417	select_operand_for_sf_field_coding (const aarch64_opcode *opcode)
	418	{
	419	int idx = -1;
	420	if (aarch64_get_operand_class (opcode->operands[0])
	421	== AARCH64_OPND_CLASS_INT_REG)
	422	/* normal case. */
	423	idx = 0;
	424	else if (aarch64_get_operand_class (opcode->operands[1])
	425	== AARCH64_OPND_CLASS_INT_REG)
	426	/* e.g. float2fix. */
	427	idx = 1;
	428	else
	429	{ assert (0); abort (); }
	430	return idx;
	431	}
	432
	433	/* Select the operand to do the encoding/decoding of the 'type' field in
	434	the floating-point instructions.
	435	The heuristic-based rule is that the source operand is respected more. */
	436
	437	static inline int
	438	select_operand_for_fptype_field_coding (const aarch64_opcode *opcode)
	439	{
	440	int idx;
	441	if (aarch64_get_operand_class (opcode->operands[1])
	442	== AARCH64_OPND_CLASS_FP_REG)
	443	/* normal case. */
	444	idx = 1;
	445	else if (aarch64_get_operand_class (opcode->operands[0])
	446	== AARCH64_OPND_CLASS_FP_REG)
	447	/* e.g. float2fix. */
	448	idx = 0;
	449	else
	450	{ assert (0); abort (); }
	451	return idx;
	452	}
	453
	454	/* Select the operand to do the encoding/decoding of the 'size' field in
	455	the AdvSIMD scalar instructions.
	456	The heuristic-based rule is that the destination operand is respected
	457	more. */
	458
	459	static inline int
	460	select_operand_for_scalar_size_field_coding (const aarch64_opcode *opcode)
	461	{
	462	int src_size = 0, dst_size = 0;
	463	if (aarch64_get_operand_class (opcode->operands[0])
	464	== AARCH64_OPND_CLASS_SISD_REG)
	465	dst_size = aarch64_get_qualifier_esize (opcode->qualifiers_list[0][0]);
	466	if (aarch64_get_operand_class (opcode->operands[1])
	467	== AARCH64_OPND_CLASS_SISD_REG)
	468	src_size = aarch64_get_qualifier_esize (opcode->qualifiers_list[0][1]);
	469	if (src_size == dst_size && src_size == 0)
	470	{ assert (0); abort (); }
	471	/* When the result is not a sisd register or it is a long operantion. */
	472	if (dst_size == 0 \|\| dst_size == src_size << 1)
473	return 1;
474	else
475	return 0;
476	}
477
478	/* Select the operand to do the encoding/decoding of the 'size:Q' fields in
479	the AdvSIMD instructions. */
480
481	int aarch64_select_operand_for_sizeq_field_coding (const aarch64_opcode *);
482	\f
483	/* Miscellaneous. */
484
485	aarch64_insn aarch64_get_operand_modifier_value (enum aarch64_modifier_kind);
486	enum aarch64_modifier_kind
487	aarch64_get_operand_modifier_from_value (aarch64_insn, bfd_boolean);
488
489
29298bf6	490	bfd_boolean aarch64_wide_constant_p (uint64_t, int, unsigned int *);
a06ea964 NC	491	bfd_boolean aarch64_logical_immediate_p (uint64_t, int, aarch64_insn *);
	492	int aarch64_shrink_expanded_imm8 (uint64_t);
	493
	494	/* Copy the content of INST->OPERANDS[SRC] to INST->OPERANDS[DST]. */
	495	static inline void
	496	copy_operand_info (aarch64_inst *inst, int dst, int src)
	497	{
	498	assert (dst >= 0 && src >= 0 && dst < AARCH64_MAX_OPND_NUM
	499	&& src < AARCH64_MAX_OPND_NUM);
	500	memcpy (&inst->operands[dst], &inst->operands[src],
	501	sizeof (aarch64_opnd_info));
	502	inst->operands[dst].idx = dst;
	503	}
	504
	505	/* A primitive log caculator. */
	506
	507	static inline unsigned int
	508	get_logsz (unsigned int size)
	509	{
	510	const unsigned char ls[16] =
	511	{0, 1, -1, 2, -1, -1, -1, 3, -1, -1, -1, -1, -1, -1, -1, 4};
	512	if (size > 16)
	513	{
	514	assert (0);
	515	return -1;
	516	}
	517	assert (ls[size - 1] != (unsigned char)-1);
	518	return ls[size - 1];
	519	}
	520
	521	#endif /* OPCODES_AARCH64_OPC_H */