Replace "the the" with "the"
[external/binutils.git] / opcodes / lm32-dis.c
1 /* DO NOT EDIT!  -*- buffer-read-only: t -*- vi:set ro:  */
2 /* Disassembler interface for targets using CGEN. -*- C -*-
3    CGEN: Cpu tools GENerator
4
5    THIS FILE IS MACHINE GENERATED WITH CGEN.
6    - the resultant file is machine generated, cgen-dis.in isn't
7
8    Copyright (C) 1996-2019 Free Software Foundation, Inc.
9
10    This file is part of libopcodes.
11
12    This library is free software; you can redistribute it and/or modify
13    it under the terms of the GNU General Public License as published by
14    the Free Software Foundation; either version 3, or (at your option)
15    any later version.
16
17    It is distributed in the hope that it will be useful, but WITHOUT
18    ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
19    or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public
20    License for more details.
21
22    You should have received a copy of the GNU General Public License
23    along with this program; if not, write to the Free Software Foundation, Inc.,
24    51 Franklin Street - Fifth Floor, Boston, MA 02110-1301, USA.  */
25
26 /* ??? Eventually more and more of this stuff can go to cpu-independent files.
27    Keep that in mind.  */
28
29 #include "sysdep.h"
30 #include <stdio.h>
31 #include "ansidecl.h"
32 #include "disassemble.h"
33 #include "bfd.h"
34 #include "symcat.h"
35 #include "libiberty.h"
36 #include "lm32-desc.h"
37 #include "lm32-opc.h"
38 #include "opintl.h"
39
40 /* Default text to print if an instruction isn't recognized.  */
41 #define UNKNOWN_INSN_MSG _("*unknown*")
42
43 static void print_normal
44   (CGEN_CPU_DESC, void *, long, unsigned int, bfd_vma, int);
45 static void print_address
46   (CGEN_CPU_DESC, void *, bfd_vma, unsigned int, bfd_vma, int) ATTRIBUTE_UNUSED;
47 static void print_keyword
48   (CGEN_CPU_DESC, void *, CGEN_KEYWORD *, long, unsigned int) ATTRIBUTE_UNUSED;
49 static void print_insn_normal
50   (CGEN_CPU_DESC, void *, const CGEN_INSN *, CGEN_FIELDS *, bfd_vma, int);
51 static int print_insn
52   (CGEN_CPU_DESC, bfd_vma,  disassemble_info *, bfd_byte *, unsigned);
53 static int default_print_insn
54   (CGEN_CPU_DESC, bfd_vma, disassemble_info *) ATTRIBUTE_UNUSED;
55 static int read_insn
56   (CGEN_CPU_DESC, bfd_vma, disassemble_info *, bfd_byte *, int, CGEN_EXTRACT_INFO *,
57    unsigned long *);
58 \f
59 /* -- disassembler routines inserted here.  */
60
61
62 void lm32_cgen_print_operand
63   (CGEN_CPU_DESC, int, PTR, CGEN_FIELDS *, void const *, bfd_vma, int);
64
65 /* Main entry point for printing operands.
66    XINFO is a `void *' and not a `disassemble_info *' to not put a requirement
67    of dis-asm.h on cgen.h.
68
69    This function is basically just a big switch statement.  Earlier versions
70    used tables to look up the function to use, but
71    - if the table contains both assembler and disassembler functions then
72      the disassembler contains much of the assembler and vice-versa,
73    - there's a lot of inlining possibilities as things grow,
74    - using a switch statement avoids the function call overhead.
75
76    This function could be moved into `print_insn_normal', but keeping it
77    separate makes clear the interface between `print_insn_normal' and each of
78    the handlers.  */
79
80 void
81 lm32_cgen_print_operand (CGEN_CPU_DESC cd,
82                            int opindex,
83                            void * xinfo,
84                            CGEN_FIELDS *fields,
85                            void const *attrs ATTRIBUTE_UNUSED,
86                            bfd_vma pc,
87                            int length)
88 {
89   disassemble_info *info = (disassemble_info *) xinfo;
90
91   switch (opindex)
92     {
93     case LM32_OPERAND_BRANCH :
94       print_address (cd, info, fields->f_branch, 0|(1<<CGEN_OPERAND_PCREL_ADDR), pc, length);
95       break;
96     case LM32_OPERAND_CALL :
97       print_address (cd, info, fields->f_call, 0|(1<<CGEN_OPERAND_PCREL_ADDR), pc, length);
98       break;
99     case LM32_OPERAND_CSR :
100       print_keyword (cd, info, & lm32_cgen_opval_h_csr, fields->f_csr, 0);
101       break;
102     case LM32_OPERAND_EXCEPTION :
103       print_normal (cd, info, fields->f_exception, 0, pc, length);
104       break;
105     case LM32_OPERAND_GOT16 :
106       print_normal (cd, info, fields->f_imm, 0|(1<<CGEN_OPERAND_SIGNED), pc, length);
107       break;
108     case LM32_OPERAND_GOTOFFHI16 :
109       print_normal (cd, info, fields->f_imm, 0|(1<<CGEN_OPERAND_SIGNED), pc, length);
110       break;
111     case LM32_OPERAND_GOTOFFLO16 :
112       print_normal (cd, info, fields->f_imm, 0|(1<<CGEN_OPERAND_SIGNED), pc, length);
113       break;
114     case LM32_OPERAND_GP16 :
115       print_normal (cd, info, fields->f_imm, 0|(1<<CGEN_OPERAND_SIGNED), pc, length);
116       break;
117     case LM32_OPERAND_HI16 :
118       print_normal (cd, info, fields->f_uimm, 0, pc, length);
119       break;
120     case LM32_OPERAND_IMM :
121       print_normal (cd, info, fields->f_imm, 0|(1<<CGEN_OPERAND_SIGNED), pc, length);
122       break;
123     case LM32_OPERAND_LO16 :
124       print_normal (cd, info, fields->f_uimm, 0, pc, length);
125       break;
126     case LM32_OPERAND_R0 :
127       print_keyword (cd, info, & lm32_cgen_opval_h_gr, fields->f_r0, 0);
128       break;
129     case LM32_OPERAND_R1 :
130       print_keyword (cd, info, & lm32_cgen_opval_h_gr, fields->f_r1, 0);
131       break;
132     case LM32_OPERAND_R2 :
133       print_keyword (cd, info, & lm32_cgen_opval_h_gr, fields->f_r2, 0);
134       break;
135     case LM32_OPERAND_SHIFT :
136       print_normal (cd, info, fields->f_shift, 0, pc, length);
137       break;
138     case LM32_OPERAND_UIMM :
139       print_normal (cd, info, fields->f_uimm, 0, pc, length);
140       break;
141     case LM32_OPERAND_USER :
142       print_normal (cd, info, fields->f_user, 0, pc, length);
143       break;
144
145     default :
146       /* xgettext:c-format */
147       opcodes_error_handler
148         (_("internal error: unrecognized field %d while printing insn"),
149          opindex);
150       abort ();
151   }
152 }
153
154 cgen_print_fn * const lm32_cgen_print_handlers[] =
155 {
156   print_insn_normal,
157 };
158
159
160 void
161 lm32_cgen_init_dis (CGEN_CPU_DESC cd)
162 {
163   lm32_cgen_init_opcode_table (cd);
164   lm32_cgen_init_ibld_table (cd);
165   cd->print_handlers = & lm32_cgen_print_handlers[0];
166   cd->print_operand = lm32_cgen_print_operand;
167 }
168
169 \f
170 /* Default print handler.  */
171
172 static void
173 print_normal (CGEN_CPU_DESC cd ATTRIBUTE_UNUSED,
174               void *dis_info,
175               long value,
176               unsigned int attrs,
177               bfd_vma pc ATTRIBUTE_UNUSED,
178               int length ATTRIBUTE_UNUSED)
179 {
180   disassemble_info *info = (disassemble_info *) dis_info;
181
182   /* Print the operand as directed by the attributes.  */
183   if (CGEN_BOOL_ATTR (attrs, CGEN_OPERAND_SEM_ONLY))
184     ; /* nothing to do */
185   else if (CGEN_BOOL_ATTR (attrs, CGEN_OPERAND_SIGNED))
186     (*info->fprintf_func) (info->stream, "%ld", value);
187   else
188     (*info->fprintf_func) (info->stream, "0x%lx", value);
189 }
190
191 /* Default address handler.  */
192
193 static void
194 print_address (CGEN_CPU_DESC cd ATTRIBUTE_UNUSED,
195                void *dis_info,
196                bfd_vma value,
197                unsigned int attrs,
198                bfd_vma pc ATTRIBUTE_UNUSED,
199                int length ATTRIBUTE_UNUSED)
200 {
201   disassemble_info *info = (disassemble_info *) dis_info;
202
203   /* Print the operand as directed by the attributes.  */
204   if (CGEN_BOOL_ATTR (attrs, CGEN_OPERAND_SEM_ONLY))
205     ; /* Nothing to do.  */
206   else if (CGEN_BOOL_ATTR (attrs, CGEN_OPERAND_PCREL_ADDR))
207     (*info->print_address_func) (value, info);
208   else if (CGEN_BOOL_ATTR (attrs, CGEN_OPERAND_ABS_ADDR))
209     (*info->print_address_func) (value, info);
210   else if (CGEN_BOOL_ATTR (attrs, CGEN_OPERAND_SIGNED))
211     (*info->fprintf_func) (info->stream, "%ld", (long) value);
212   else
213     (*info->fprintf_func) (info->stream, "0x%lx", (long) value);
214 }
215
216 /* Keyword print handler.  */
217
218 static void
219 print_keyword (CGEN_CPU_DESC cd ATTRIBUTE_UNUSED,
220                void *dis_info,
221                CGEN_KEYWORD *keyword_table,
222                long value,
223                unsigned int attrs ATTRIBUTE_UNUSED)
224 {
225   disassemble_info *info = (disassemble_info *) dis_info;
226   const CGEN_KEYWORD_ENTRY *ke;
227
228   ke = cgen_keyword_lookup_value (keyword_table, value);
229   if (ke != NULL)
230     (*info->fprintf_func) (info->stream, "%s", ke->name);
231   else
232     (*info->fprintf_func) (info->stream, "???");
233 }
234 \f
235 /* Default insn printer.
236
237    DIS_INFO is defined as `void *' so the disassembler needn't know anything
238    about disassemble_info.  */
239
240 static void
241 print_insn_normal (CGEN_CPU_DESC cd,
242                    void *dis_info,
243                    const CGEN_INSN *insn,
244                    CGEN_FIELDS *fields,
245                    bfd_vma pc,
246                    int length)
247 {
248   const CGEN_SYNTAX *syntax = CGEN_INSN_SYNTAX (insn);
249   disassemble_info *info = (disassemble_info *) dis_info;
250   const CGEN_SYNTAX_CHAR_TYPE *syn;
251
252   CGEN_INIT_PRINT (cd);
253
254   for (syn = CGEN_SYNTAX_STRING (syntax); *syn; ++syn)
255     {
256       if (CGEN_SYNTAX_MNEMONIC_P (*syn))
257         {
258           (*info->fprintf_func) (info->stream, "%s", CGEN_INSN_MNEMONIC (insn));
259           continue;
260         }
261       if (CGEN_SYNTAX_CHAR_P (*syn))
262         {
263           (*info->fprintf_func) (info->stream, "%c", CGEN_SYNTAX_CHAR (*syn));
264           continue;
265         }
266
267       /* We have an operand.  */
268       lm32_cgen_print_operand (cd, CGEN_SYNTAX_FIELD (*syn), info,
269                                  fields, CGEN_INSN_ATTRS (insn), pc, length);
270     }
271 }
272 \f
273 /* Subroutine of print_insn. Reads an insn into the given buffers and updates
274    the extract info.
275    Returns 0 if all is well, non-zero otherwise.  */
276
277 static int
278 read_insn (CGEN_CPU_DESC cd ATTRIBUTE_UNUSED,
279            bfd_vma pc,
280            disassemble_info *info,
281            bfd_byte *buf,
282            int buflen,
283            CGEN_EXTRACT_INFO *ex_info,
284            unsigned long *insn_value)
285 {
286   int status = (*info->read_memory_func) (pc, buf, buflen, info);
287
288   if (status != 0)
289     {
290       (*info->memory_error_func) (status, pc, info);
291       return -1;
292     }
293
294   ex_info->dis_info = info;
295   ex_info->valid = (1 << buflen) - 1;
296   ex_info->insn_bytes = buf;
297
298   *insn_value = bfd_get_bits (buf, buflen * 8, info->endian == BFD_ENDIAN_BIG);
299   return 0;
300 }
301
302 /* Utility to print an insn.
303    BUF is the base part of the insn, target byte order, BUFLEN bytes long.
304    The result is the size of the insn in bytes or zero for an unknown insn
305    or -1 if an error occurs fetching data (memory_error_func will have
306    been called).  */
307
308 static int
309 print_insn (CGEN_CPU_DESC cd,
310             bfd_vma pc,
311             disassemble_info *info,
312             bfd_byte *buf,
313             unsigned int buflen)
314 {
315   CGEN_INSN_INT insn_value;
316   const CGEN_INSN_LIST *insn_list;
317   CGEN_EXTRACT_INFO ex_info;
318   int basesize;
319
320   /* Extract base part of instruction, just in case CGEN_DIS_* uses it. */
321   basesize = cd->base_insn_bitsize < buflen * 8 ?
322                                      cd->base_insn_bitsize : buflen * 8;
323   insn_value = cgen_get_insn_value (cd, buf, basesize);
324
325
326   /* Fill in ex_info fields like read_insn would.  Don't actually call
327      read_insn, since the incoming buffer is already read (and possibly
328      modified a la m32r).  */
329   ex_info.valid = (1 << buflen) - 1;
330   ex_info.dis_info = info;
331   ex_info.insn_bytes = buf;
332
333   /* The instructions are stored in hash lists.
334      Pick the first one and keep trying until we find the right one.  */
335
336   insn_list = CGEN_DIS_LOOKUP_INSN (cd, (char *) buf, insn_value);
337   while (insn_list != NULL)
338     {
339       const CGEN_INSN *insn = insn_list->insn;
340       CGEN_FIELDS fields;
341       int length;
342       unsigned long insn_value_cropped;
343
344 #ifdef CGEN_VALIDATE_INSN_SUPPORTED
345       /* Not needed as insn shouldn't be in hash lists if not supported.  */
346       /* Supported by this cpu?  */
347       if (! lm32_cgen_insn_supported (cd, insn))
348         {
349           insn_list = CGEN_DIS_NEXT_INSN (insn_list);
350           continue;
351         }
352 #endif
353
354       /* Basic bit mask must be correct.  */
355       /* ??? May wish to allow target to defer this check until the extract
356          handler.  */
357
358       /* Base size may exceed this instruction's size.  Extract the
359          relevant part from the buffer. */
360       if ((unsigned) (CGEN_INSN_BITSIZE (insn) / 8) < buflen &&
361           (unsigned) (CGEN_INSN_BITSIZE (insn) / 8) <= sizeof (unsigned long))
362         insn_value_cropped = bfd_get_bits (buf, CGEN_INSN_BITSIZE (insn),
363                                            info->endian == BFD_ENDIAN_BIG);
364       else
365         insn_value_cropped = insn_value;
366
367       if ((insn_value_cropped & CGEN_INSN_BASE_MASK (insn))
368           == CGEN_INSN_BASE_VALUE (insn))
369         {
370           /* Printing is handled in two passes.  The first pass parses the
371              machine insn and extracts the fields.  The second pass prints
372              them.  */
373
374           /* Make sure the entire insn is loaded into insn_value, if it
375              can fit.  */
376           if (((unsigned) CGEN_INSN_BITSIZE (insn) > cd->base_insn_bitsize) &&
377               (unsigned) (CGEN_INSN_BITSIZE (insn) / 8) <= sizeof (unsigned long))
378             {
379               unsigned long full_insn_value;
380               int rc = read_insn (cd, pc, info, buf,
381                                   CGEN_INSN_BITSIZE (insn) / 8,
382                                   & ex_info, & full_insn_value);
383               if (rc != 0)
384                 return rc;
385               length = CGEN_EXTRACT_FN (cd, insn)
386                 (cd, insn, &ex_info, full_insn_value, &fields, pc);
387             }
388           else
389             length = CGEN_EXTRACT_FN (cd, insn)
390               (cd, insn, &ex_info, insn_value_cropped, &fields, pc);
391
392           /* Length < 0 -> error.  */
393           if (length < 0)
394             return length;
395           if (length > 0)
396             {
397               CGEN_PRINT_FN (cd, insn) (cd, info, insn, &fields, pc, length);
398               /* Length is in bits, result is in bytes.  */
399               return length / 8;
400             }
401         }
402
403       insn_list = CGEN_DIS_NEXT_INSN (insn_list);
404     }
405
406   return 0;
407 }
408
409 /* Default value for CGEN_PRINT_INSN.
410    The result is the size of the insn in bytes or zero for an unknown insn
411    or -1 if an error occured fetching bytes.  */
412
413 #ifndef CGEN_PRINT_INSN
414 #define CGEN_PRINT_INSN default_print_insn
415 #endif
416
417 static int
418 default_print_insn (CGEN_CPU_DESC cd, bfd_vma pc, disassemble_info *info)
419 {
420   bfd_byte buf[CGEN_MAX_INSN_SIZE];
421   int buflen;
422   int status;
423
424   /* Attempt to read the base part of the insn.  */
425   buflen = cd->base_insn_bitsize / 8;
426   status = (*info->read_memory_func) (pc, buf, buflen, info);
427
428   /* Try again with the minimum part, if min < base.  */
429   if (status != 0 && (cd->min_insn_bitsize < cd->base_insn_bitsize))
430     {
431       buflen = cd->min_insn_bitsize / 8;
432       status = (*info->read_memory_func) (pc, buf, buflen, info);
433     }
434
435   if (status != 0)
436     {
437       (*info->memory_error_func) (status, pc, info);
438       return -1;
439     }
440
441   return print_insn (cd, pc, info, buf, buflen);
442 }
443
444 /* Main entry point.
445    Print one instruction from PC on INFO->STREAM.
446    Return the size of the instruction (in bytes).  */
447
448 typedef struct cpu_desc_list
449 {
450   struct cpu_desc_list *next;
451   CGEN_BITSET *isa;
452   int mach;
453   int endian;
454   CGEN_CPU_DESC cd;
455 } cpu_desc_list;
456
457 int
458 print_insn_lm32 (bfd_vma pc, disassemble_info *info)
459 {
460   static cpu_desc_list *cd_list = 0;
461   cpu_desc_list *cl = 0;
462   static CGEN_CPU_DESC cd = 0;
463   static CGEN_BITSET *prev_isa;
464   static int prev_mach;
465   static int prev_endian;
466   int length;
467   CGEN_BITSET *isa;
468   int mach;
469   int endian = (info->endian == BFD_ENDIAN_BIG
470                 ? CGEN_ENDIAN_BIG
471                 : CGEN_ENDIAN_LITTLE);
472   enum bfd_architecture arch;
473
474   /* ??? gdb will set mach but leave the architecture as "unknown" */
475 #ifndef CGEN_BFD_ARCH
476 #define CGEN_BFD_ARCH bfd_arch_lm32
477 #endif
478   arch = info->arch;
479   if (arch == bfd_arch_unknown)
480     arch = CGEN_BFD_ARCH;
481
482   /* There's no standard way to compute the machine or isa number
483      so we leave it to the target.  */
484 #ifdef CGEN_COMPUTE_MACH
485   mach = CGEN_COMPUTE_MACH (info);
486 #else
487   mach = info->mach;
488 #endif
489
490 #ifdef CGEN_COMPUTE_ISA
491   {
492     static CGEN_BITSET *permanent_isa;
493
494     if (!permanent_isa)
495       permanent_isa = cgen_bitset_create (MAX_ISAS);
496     isa = permanent_isa;
497     cgen_bitset_clear (isa);
498     cgen_bitset_add (isa, CGEN_COMPUTE_ISA (info));
499   }
500 #else
501   isa = info->insn_sets;
502 #endif
503
504   /* If we've switched cpu's, try to find a handle we've used before */
505   if (cd
506       && (cgen_bitset_compare (isa, prev_isa) != 0
507           || mach != prev_mach
508           || endian != prev_endian))
509     {
510       cd = 0;
511       for (cl = cd_list; cl; cl = cl->next)
512         {
513           if (cgen_bitset_compare (cl->isa, isa) == 0 &&
514               cl->mach == mach &&
515               cl->endian == endian)
516             {
517               cd = cl->cd;
518               prev_isa = cd->isas;
519               break;
520             }
521         }
522     }
523
524   /* If we haven't initialized yet, initialize the opcode table.  */
525   if (! cd)
526     {
527       const bfd_arch_info_type *arch_type = bfd_lookup_arch (arch, mach);
528       const char *mach_name;
529
530       if (!arch_type)
531         abort ();
532       mach_name = arch_type->printable_name;
533
534       prev_isa = cgen_bitset_copy (isa);
535       prev_mach = mach;
536       prev_endian = endian;
537       cd = lm32_cgen_cpu_open (CGEN_CPU_OPEN_ISAS, prev_isa,
538                                  CGEN_CPU_OPEN_BFDMACH, mach_name,
539                                  CGEN_CPU_OPEN_ENDIAN, prev_endian,
540                                  CGEN_CPU_OPEN_END);
541       if (!cd)
542         abort ();
543
544       /* Save this away for future reference.  */
545       cl = xmalloc (sizeof (struct cpu_desc_list));
546       cl->cd = cd;
547       cl->isa = prev_isa;
548       cl->mach = mach;
549       cl->endian = endian;
550       cl->next = cd_list;
551       cd_list = cl;
552
553       lm32_cgen_init_dis (cd);
554     }
555
556   /* We try to have as much common code as possible.
557      But at this point some targets need to take over.  */
558   /* ??? Some targets may need a hook elsewhere.  Try to avoid this,
559      but if not possible try to move this hook elsewhere rather than
560      have two hooks.  */
561   length = CGEN_PRINT_INSN (cd, pc, info);
562   if (length > 0)
563     return length;
564   if (length < 0)
565     return -1;
566
567   (*info->fprintf_func) (info->stream, UNKNOWN_INSN_MSG);
568   return cd->default_insn_bitsize / 8;
569 }