Automatic date update in version.in
[external/binutils.git] / opcodes / arc-dis.h
1 /* Disassembler structures definitions for the ARC.
2    Copyright (C) 1994-2019 Free Software Foundation, Inc.
3
4    Contributed by Claudiu Zissulescu (claziss@synopsys.com)
5
6    This file is part of libopcodes.
7
8    This library is free software; you can redistribute it and/or modify
9    it under the terms of the GNU General Public License as published by
10    the Free Software Foundation; either version 3, or (at your option)
11    any later version.
12
13    It is distributed in the hope that it will be useful, but WITHOUT
14    ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
15    or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public
16    License for more details.
17
18    You should have received a copy of the GNU General Public License
19    along with this program; if not, write to the Free Software Foundation,
20    Inc., 51 Franklin Street - Fifth Floor, Boston, MA 02110-1301, USA.  */
21
22 #ifndef ARCDIS_H
23 #define ARCDIS_H
24
25 #ifdef __cplusplus
26 extern "C" {
27 #endif
28
29 enum arc_ldst_writeback_mode
30 {
31   ARC_WRITEBACK_NO = 0,
32   ARC_WRITEBACK_AW = 1,
33   ARC_WRITEBACK_A = ARC_WRITEBACK_AW,
34   ARC_WRITEBACK_AB = 2,
35   ARC_WRITEBACK_AS = 3,
36 };
37
38
39 enum arc_ldst_data_size
40 {
41   ARC_SCALING_NONE = 4,
42   ARC_SCALING_B = 1,
43   ARC_SCALING_H = 2,
44   ARC_SCALING_D = 8,
45 };
46
47
48 enum arc_condition_code
49 {
50   ARC_CC_AL = 0x0,
51   ARC_CC_RA = ARC_CC_AL,
52   ARC_CC_EQ = 0x1,
53   ARC_CC_Z = ARC_CC_EQ,
54   ARC_CC_NE = 0x2,
55   ARC_CC_NZ = ARC_CC_NE,
56   ARC_CC_PL = 0x3,
57   ARC_CC_P = ARC_CC_PL,
58   ARC_CC_MI = 0x4,
59   ARC_CC_N = ARC_CC_MI,
60   ARC_CC_CS = 0x5,
61   ARC_CC_C = ARC_CC_CS,
62   ARC_CC_LO = ARC_CC_CS,
63   ARC_CC_CC = 0x6,
64   ARC_CC_NC = ARC_CC_CC,
65   ARC_CC_HS = ARC_CC_CC,
66   ARC_CC_VS = 0x7,
67   ARC_CC_V = ARC_CC_VS,
68   ARC_CC_VC = 0x8,
69   ARC_CC_NV = ARC_CC_VC,
70   ARC_CC_GT = 0x9,
71   ARC_CC_GE = 0xA,
72   ARC_CC_LT = 0xB,
73   ARC_CC_LE = 0xC,
74   ARC_CC_HI = 0xD,
75   ARC_CC_LS = 0xE,
76   ARC_CC_PNZ = 0xF,
77   ARC_CC_UNDEF0 = 0x10,
78   ARC_CC_UNDEF1 = 0x11,
79   ARC_CC_UNDEF2 = 0x12,
80   ARC_CC_UNDEF3 = 0x13,
81   ARC_CC_UNDEF4 = 0x14,
82   ARC_CC_UNDEF5 = 0x15,
83   ARC_CC_UNDEF6 = 0x16,
84   ARC_CC_UNDEF7 = 0x17,
85   ARC_CC_UNDEF8 = 0x18,
86   ARC_CC_UNDEF9 = 0x19,
87   ARC_CC_UNDEFA = 0x1A,
88   ARC_CC_UNDEFB = 0x1B,
89   ARC_CC_UNDEFC = 0x1C,
90   ARC_CC_UNDEFD = 0x1D,
91   ARC_CC_UNDEFE = 0x1E,
92   ARC_CC_UNDEFF = 0x1F
93 };
94
95 enum arc_operand_kind
96 {
97   ARC_OPERAND_KIND_UNKNOWN = 0,
98   ARC_OPERAND_KIND_REG,
99   ARC_OPERAND_KIND_SHIMM,
100   ARC_OPERAND_KIND_LIMM
101 };
102
103 struct arc_insn_operand
104 {
105   /* Operand value as encoded in instruction.  */
106   unsigned long value;
107
108   enum arc_operand_kind kind;
109 };
110
111 /* Container for information about instruction.  Provides a higher
112    level access to data that is contained in struct arc_opcode.  */
113
114 struct arc_instruction
115 {
116   /* Address of this instruction.  */
117   bfd_vma address;
118
119   /* Whether this is a valid instruction.  */
120   bfd_boolean valid;
121
122   insn_class_t insn_class;
123
124   /* Length (without LIMM).  */
125   unsigned length;
126
127   /* Is there a LIMM in this instruction?  */
128   int limm_p;
129
130   /* Long immediate value.  */
131   unsigned limm_value;
132
133   /* Is it a branch/jump instruction?  */
134   int is_control_flow;
135
136   /* Whether this instruction has a delay slot.  */
137   int has_delay_slot;
138
139   /* Value of condition code field.  */
140   enum arc_condition_code condition_code;
141
142   /* Load/store writeback mode.  */
143   enum arc_ldst_writeback_mode writeback_mode;
144
145   /* Load/store data size.  */
146   enum arc_ldst_data_size data_size_mode;
147
148   /* Amount of operands in instruction.  Note that amount of operands
149      reported by opcodes disassembler can be different from the one
150      encoded in the instruction.  Notable case is "ld a,[b,offset]",
151      when offset == 0.  In this case opcodes disassembler presents
152      this instruction as "ld a,[b]", hence there are *two* operands,
153      not three.  OPERANDS_COUNT and OPERANDS contain only those
154      explicit operands, hence it is up to invoker to handle the case
155      described above based on instruction opcodes.  Another notable
156      thing is that in opcodes disassembler representation square
157      brackets (`[' and `]') are so called fake-operands - they are in
158      the list of operands, but do not have any value of they own.
159      Those "operands" are not present in this array.  */
160   struct arc_insn_operand operands[MAX_INSN_ARGS];
161
162   unsigned int operands_count;
163 };
164
165 /* Fill INSN with data about instruction at specified ADDR.  */
166
167 void arc_insn_decode (bfd_vma addr,
168                       struct disassemble_info *di,
169                       disassembler_ftype func,
170                       struct arc_instruction *insn);
171
172 #ifdef __cplusplus
173 }
174 #endif
175
176 #endif