1 /* ppc-dis.c -- Disassemble PowerPC instructions
2    Copyright 1994, 1995, 2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007,
3    2008, 2009, 2010 Free Software Foundation, Inc.
4    Written by Ian Lance Taylor, Cygnus Support
5 
6    This file is part of the GNU opcodes library.
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 file; see the file COPYING.  If not, write to the
20    Free Software Foundation, 51 Franklin Street - Fifth Floor, Boston,
21    MA 02110-1301, USA.  */
22 
23 #include <stdio.h>
24 #include "sysdep.h"
25 #include "dis-asm.h"
26 #include "opintl.h"
27 #include "opcode/ppc.h"
28 
29 /* This file provides several disassembler functions, all of which use
30    the disassembler interface defined in dis-asm.h.  Several functions
31    are provided because this file handles disassembly for the PowerPC
32    in both big and little endian mode and also for the POWER (RS/6000)
33    chip.  */
34 static int print_insn_powerpc (bfd_vma, struct disassemble_info *, int,
35 			       ppc_cpu_t);
36 
37 struct dis_private
38 {
39   /* Stash the result of parsing disassembler_options here.  */
40   ppc_cpu_t dialect;
41 };
42 
43 #define POWERPC_DIALECT(INFO) \
44   (((struct dis_private *) ((INFO)->private_data))->dialect)
45 
46 struct ppc_mopt {
47   const char *opt;
48   ppc_cpu_t cpu;
49   ppc_cpu_t sticky;
50 };
51 
52 struct ppc_mopt ppc_opts[] = {
53   { "403",     (PPC_OPCODE_PPC | PPC_OPCODE_403),
54     0 },
55   { "405",     (PPC_OPCODE_PPC | PPC_OPCODE_403 | PPC_OPCODE_405),
56     0 },
57   { "440",     (PPC_OPCODE_PPC | PPC_OPCODE_BOOKE | PPC_OPCODE_440
58 		| PPC_OPCODE_ISEL | PPC_OPCODE_RFMCI),
59     0 },
60   { "464",     (PPC_OPCODE_PPC | PPC_OPCODE_BOOKE | PPC_OPCODE_440
61 		| PPC_OPCODE_ISEL | PPC_OPCODE_RFMCI),
62     0 },
63   { "476",     (PPC_OPCODE_PPC | PPC_OPCODE_ISEL | PPC_OPCODE_440
64 		| PPC_OPCODE_476 | PPC_OPCODE_POWER4 | PPC_OPCODE_POWER5),
65     0 },
66   { "601",     (PPC_OPCODE_PPC | PPC_OPCODE_601),
67     0 },
68   { "603",     (PPC_OPCODE_PPC),
69     0 },
70   { "604",     (PPC_OPCODE_PPC),
71     0 },
72   { "620",     (PPC_OPCODE_PPC | PPC_OPCODE_64),
73     0 },
74   { "7400",    (PPC_OPCODE_PPC | PPC_OPCODE_ALTIVEC),
75     0 },
76   { "7410",    (PPC_OPCODE_PPC | PPC_OPCODE_ALTIVEC),
77     0 },
78   { "7450",    (PPC_OPCODE_PPC | PPC_OPCODE_ALTIVEC),
79     0 },
80   { "7455",    (PPC_OPCODE_PPC | PPC_OPCODE_ALTIVEC),
81     0 },
82   { "750cl",   (PPC_OPCODE_PPC | PPC_OPCODE_PPCPS)
83     , 0 },
84   { "a2",      (PPC_OPCODE_PPC | PPC_OPCODE_ISEL | PPC_OPCODE_POWER4
85 		| PPC_OPCODE_POWER5 | PPC_OPCODE_CACHELCK | PPC_OPCODE_64
86 		| PPC_OPCODE_A2),
87     0 },
88   { "altivec", (PPC_OPCODE_PPC),
89     PPC_OPCODE_ALTIVEC },
90   { "any",     0,
91     PPC_OPCODE_ANY },
92   { "booke",   (PPC_OPCODE_PPC | PPC_OPCODE_BOOKE),
93     0 },
94   { "booke32", (PPC_OPCODE_PPC | PPC_OPCODE_BOOKE),
95     0 },
96   { "cell",    (PPC_OPCODE_PPC | PPC_OPCODE_64 | PPC_OPCODE_POWER4
97 		| PPC_OPCODE_CELL | PPC_OPCODE_ALTIVEC),
98     0 },
99   { "com",     (PPC_OPCODE_COMMON),
100     0 },
101   { "e300",    (PPC_OPCODE_PPC | PPC_OPCODE_E300),
102     0 },
103   { "e500",    (PPC_OPCODE_PPC | PPC_OPCODE_BOOKE | PPC_OPCODE_SPE
104 		| PPC_OPCODE_ISEL | PPC_OPCODE_EFS | PPC_OPCODE_BRLOCK
105 		| PPC_OPCODE_PMR | PPC_OPCODE_CACHELCK | PPC_OPCODE_RFMCI
106 		| PPC_OPCODE_E500),
107     0 },
108   { "e500mc",  (PPC_OPCODE_PPC | PPC_OPCODE_BOOKE | PPC_OPCODE_ISEL
109 		| PPC_OPCODE_PMR | PPC_OPCODE_CACHELCK | PPC_OPCODE_RFMCI
110 		| PPC_OPCODE_E500MC),
111     0 },
112   { "e500mc64",  (PPC_OPCODE_PPC | PPC_OPCODE_BOOKE | PPC_OPCODE_ISEL
113 		| PPC_OPCODE_PMR | PPC_OPCODE_CACHELCK | PPC_OPCODE_RFMCI
114 		| PPC_OPCODE_E500MC | PPC_OPCODE_64 | PPC_OPCODE_POWER5
115 		| PPC_OPCODE_POWER6 | PPC_OPCODE_POWER7),
116     0 },
117   { "e500x2",  (PPC_OPCODE_PPC | PPC_OPCODE_BOOKE | PPC_OPCODE_SPE
118 		| PPC_OPCODE_ISEL | PPC_OPCODE_EFS | PPC_OPCODE_BRLOCK
119 		| PPC_OPCODE_PMR | PPC_OPCODE_CACHELCK | PPC_OPCODE_RFMCI
120 		| PPC_OPCODE_E500),
121     0 },
122   { "efs",     (PPC_OPCODE_PPC | PPC_OPCODE_EFS),
123     0 },
124   { "power4",  (PPC_OPCODE_PPC | PPC_OPCODE_64 | PPC_OPCODE_POWER4),
125     0 },
126   { "power5",  (PPC_OPCODE_PPC | PPC_OPCODE_64 | PPC_OPCODE_POWER4
127 		| PPC_OPCODE_POWER5),
128     0 },
129   { "power6",  (PPC_OPCODE_PPC | PPC_OPCODE_64 | PPC_OPCODE_POWER4
130 		| PPC_OPCODE_POWER5 | PPC_OPCODE_POWER6 | PPC_OPCODE_ALTIVEC),
131     0 },
132   { "power7",  (PPC_OPCODE_PPC | PPC_OPCODE_ISEL | PPC_OPCODE_64
133 		| PPC_OPCODE_POWER4 | PPC_OPCODE_POWER5 | PPC_OPCODE_POWER6
134 		| PPC_OPCODE_POWER7 | PPC_OPCODE_ALTIVEC | PPC_OPCODE_VSX),
135     0 },
136   { "ppc",     (PPC_OPCODE_PPC),
137     0 },
138   { "ppc32",   (PPC_OPCODE_PPC),
139     0 },
140   { "ppc64",   (PPC_OPCODE_PPC | PPC_OPCODE_64),
141     0 },
142   { "ppc64bridge", (PPC_OPCODE_PPC | PPC_OPCODE_64_BRIDGE),
143     0 },
144   { "ppcps",   (PPC_OPCODE_PPC | PPC_OPCODE_PPCPS),
145     0 },
146   { "pwr",     (PPC_OPCODE_POWER),
147     0 },
148   { "pwr2",    (PPC_OPCODE_POWER | PPC_OPCODE_POWER2),
149     0 },
150   { "pwr4",    (PPC_OPCODE_PPC | PPC_OPCODE_64 | PPC_OPCODE_POWER4),
151     0 },
152   { "pwr5",    (PPC_OPCODE_PPC | PPC_OPCODE_64 | PPC_OPCODE_POWER4
153 		| PPC_OPCODE_POWER5),
154     0 },
155   { "pwr5x",   (PPC_OPCODE_PPC | PPC_OPCODE_64 | PPC_OPCODE_POWER4
156 		| PPC_OPCODE_POWER5),
157     0 },
158   { "pwr6",    (PPC_OPCODE_PPC | PPC_OPCODE_64 | PPC_OPCODE_POWER4
159 		| PPC_OPCODE_POWER5 | PPC_OPCODE_POWER6 | PPC_OPCODE_ALTIVEC),
160     0 },
161   { "pwr7",    (PPC_OPCODE_PPC | PPC_OPCODE_ISEL | PPC_OPCODE_64
162 		| PPC_OPCODE_POWER4 | PPC_OPCODE_POWER5 | PPC_OPCODE_POWER6
163 		| PPC_OPCODE_POWER7 | PPC_OPCODE_ALTIVEC | PPC_OPCODE_VSX),
164     0 },
165   { "pwrx",    (PPC_OPCODE_POWER | PPC_OPCODE_POWER2),
166     0 },
167   { "spe",     (PPC_OPCODE_PPC | PPC_OPCODE_EFS),
168     PPC_OPCODE_SPE },
169   { "titan",   (PPC_OPCODE_PPC | PPC_OPCODE_BOOKE | PPC_OPCODE_PMR
170 		| PPC_OPCODE_RFMCI | PPC_OPCODE_TITAN),
171     0 },
172   { "vsx",     (PPC_OPCODE_PPC),
173     PPC_OPCODE_VSX },
174 };
175 
176 /* Handle -m and -M options that set cpu type, and .machine arg.  */
177 
178 ppc_cpu_t
ppc_parse_cpu(ppc_cpu_t ppc_cpu,const char * arg)179 ppc_parse_cpu (ppc_cpu_t ppc_cpu, const char *arg)
180 {
181   /* Sticky bits.  */
182   ppc_cpu_t retain_flags = ppc_cpu & (PPC_OPCODE_ALTIVEC | PPC_OPCODE_VSX
183 				      | PPC_OPCODE_SPE | PPC_OPCODE_ANY);
184   unsigned int i;
185 
186   for (i = 0; i < sizeof (ppc_opts) / sizeof (ppc_opts[0]); i++)
187     if (strcmp (ppc_opts[i].opt, arg) == 0)
188       {
189 	if (ppc_opts[i].sticky)
190 	  {
191 	    retain_flags |= ppc_opts[i].sticky;
192 	    if ((ppc_cpu & ~(ppc_cpu_t) (PPC_OPCODE_ALTIVEC | PPC_OPCODE_VSX
193 					 | PPC_OPCODE_SPE | PPC_OPCODE_ANY)) != 0)
194 	      break;
195 	  }
196 	ppc_cpu = ppc_opts[i].cpu;
197 	break;
198       }
199   if (i >= sizeof (ppc_opts) / sizeof (ppc_opts[0]))
200     return 0;
201 
202   ppc_cpu |= retain_flags;
203   return ppc_cpu;
204 }
205 
206 /* Determine which set of machines to disassemble for.  */
207 
208 static int
powerpc_init_dialect(struct disassemble_info * info)209 powerpc_init_dialect (struct disassemble_info *info)
210 {
211   ppc_cpu_t dialect = 0;
212   char *arg;
213   struct dis_private *priv = calloc (sizeof (*priv), 1);
214 
215   if (priv == NULL)
216     return FALSE;
217 
218   arg = info->disassembler_options;
219   while (arg != NULL)
220     {
221       ppc_cpu_t new_cpu = 0;
222       char *end = strchr (arg, ',');
223 
224       if (end != NULL)
225 	*end = 0;
226 
227       if ((new_cpu = ppc_parse_cpu (dialect, arg)) != 0)
228 	dialect = new_cpu;
229       else if (strcmp (arg, "32") == 0)
230 	dialect &= ~(ppc_cpu_t) PPC_OPCODE_64;
231       else if (strcmp (arg, "64") == 0)
232 	dialect |= PPC_OPCODE_64;
233       else
234 	fprintf (stderr, _("warning: ignoring unknown -M%s option\n"), arg);
235 
236       if (end != NULL)
237 	*end++ = ',';
238       arg = end;
239     }
240 
241   if ((dialect & ~(ppc_cpu_t) PPC_OPCODE_64) == 0)
242     {
243       if (info->mach == bfd_mach_ppc64)
244 	dialect |= PPC_OPCODE_64;
245       else
246 	dialect &= ~(ppc_cpu_t) PPC_OPCODE_64;
247       /* Choose a reasonable default.  */
248       dialect |= (PPC_OPCODE_PPC | PPC_OPCODE_COMMON | PPC_OPCODE_601
249 		  | PPC_OPCODE_ALTIVEC);
250     }
251 
252   info->private_data = priv;
253   POWERPC_DIALECT(info) = dialect;
254 
255   return TRUE;
256 }
257 
258 /* Print a big endian PowerPC instruction.  */
259 
260 int
print_insn_big_powerpc(bfd_vma memaddr,struct disassemble_info * info)261 print_insn_big_powerpc (bfd_vma memaddr, struct disassemble_info *info)
262 {
263   if (info->private_data == NULL && !powerpc_init_dialect (info))
264     return -1;
265   return print_insn_powerpc (memaddr, info, 1, POWERPC_DIALECT(info));
266 }
267 
268 /* Print a little endian PowerPC instruction.  */
269 
270 int
print_insn_little_powerpc(bfd_vma memaddr,struct disassemble_info * info)271 print_insn_little_powerpc (bfd_vma memaddr, struct disassemble_info *info)
272 {
273   if (info->private_data == NULL && !powerpc_init_dialect (info))
274     return -1;
275   return print_insn_powerpc (memaddr, info, 0, POWERPC_DIALECT(info));
276 }
277 
278 /* Print a POWER (RS/6000) instruction.  */
279 
280 int
print_insn_rs6000(bfd_vma memaddr,struct disassemble_info * info)281 print_insn_rs6000 (bfd_vma memaddr, struct disassemble_info *info)
282 {
283   return print_insn_powerpc (memaddr, info, 1, PPC_OPCODE_POWER);
284 }
285 
286 /* Extract the operand value from the PowerPC or POWER instruction.  */
287 
288 static long
operand_value_powerpc(const struct powerpc_operand * operand,unsigned long insn,ppc_cpu_t dialect)289 operand_value_powerpc (const struct powerpc_operand *operand,
290 		       unsigned long insn, ppc_cpu_t dialect)
291 {
292   long value;
293   int invalid;
294   /* Extract the value from the instruction.  */
295   if (operand->extract)
296     value = (*operand->extract) (insn, dialect, &invalid);
297   else
298     {
299       value = (insn >> operand->shift) & operand->bitm;
300       if ((operand->flags & PPC_OPERAND_SIGNED) != 0)
301 	{
302 	  /* BITM is always some number of zeros followed by some
303 	     number of ones, followed by some numer of zeros.  */
304 	  unsigned long top = operand->bitm;
305 	  /* top & -top gives the rightmost 1 bit, so this
306 	     fills in any trailing zeros.  */
307 	  top |= (top & -top) - 1;
308 	  top &= ~(top >> 1);
309 	  value = (value ^ top) - top;
310 	}
311     }
312 
313   return value;
314 }
315 
316 /* Determine whether the optional operand(s) should be printed.  */
317 
318 static int
skip_optional_operands(const unsigned char * opindex,unsigned long insn,ppc_cpu_t dialect)319 skip_optional_operands (const unsigned char *opindex,
320 			unsigned long insn, ppc_cpu_t dialect)
321 {
322   const struct powerpc_operand *operand;
323 
324   for (; *opindex != 0; opindex++)
325     {
326       operand = &powerpc_operands[*opindex];
327       if ((operand->flags & PPC_OPERAND_NEXT) != 0
328 	  || ((operand->flags & PPC_OPERAND_OPTIONAL) != 0
329 	      && operand_value_powerpc (operand, insn, dialect) != 0))
330 	return 0;
331     }
332 
333   return 1;
334 }
335 
336 /* Print a PowerPC or POWER instruction.  */
337 
338 static int
print_insn_powerpc(bfd_vma memaddr,struct disassemble_info * info,int bigendian,ppc_cpu_t dialect)339 print_insn_powerpc (bfd_vma memaddr,
340 		    struct disassemble_info *info,
341 		    int bigendian,
342 		    ppc_cpu_t dialect)
343 {
344   bfd_byte buffer[4];
345   int status;
346   unsigned long insn;
347   const struct powerpc_opcode *opcode;
348   const struct powerpc_opcode *opcode_end;
349   unsigned long op;
350   ppc_cpu_t dialect_orig = dialect;
351 
352   status = (*info->read_memory_func) (memaddr, buffer, 4, info);
353   if (status != 0)
354     {
355       (*info->memory_error_func) (status, memaddr, info);
356       return -1;
357     }
358 
359   if (bigendian)
360     insn = bfd_getb32 (buffer);
361   else
362     insn = bfd_getl32 (buffer);
363 
364   /* Get the major opcode of the instruction.  */
365   op = PPC_OP (insn);
366 
367   /* Find the first match in the opcode table.  We could speed this up
368      a bit by doing a binary search on the major opcode.  */
369   opcode_end = powerpc_opcodes + powerpc_num_opcodes;
370  again:
371   for (opcode = powerpc_opcodes; opcode < opcode_end; opcode++)
372     {
373       unsigned long table_op;
374       const unsigned char *opindex;
375       const struct powerpc_operand *operand;
376       int invalid;
377       int need_comma;
378       int need_paren;
379       int skip_optional;
380 
381       table_op = PPC_OP (opcode->opcode);
382       if (op < table_op)
383 	break;
384       if (op > table_op)
385 	continue;
386 
387       if ((insn & opcode->mask) != opcode->opcode
388 	  || (opcode->flags & dialect) == 0
389 	  || (opcode->deprecated & dialect_orig) != 0)
390 	continue;
391 
392       /* Make two passes over the operands.  First see if any of them
393 	 have extraction functions, and, if they do, make sure the
394 	 instruction is valid.  */
395       invalid = 0;
396       for (opindex = opcode->operands; *opindex != 0; opindex++)
397 	{
398 	  operand = powerpc_operands + *opindex;
399 	  if (operand->extract)
400 	    (*operand->extract) (insn, dialect, &invalid);
401 	}
402       if (invalid)
403 	continue;
404 
405       /* The instruction is valid.  */
406       if (opcode->operands[0] != 0)
407 	(*info->fprintf_func) (info->stream, "%-7s ", opcode->name);
408       else
409 	(*info->fprintf_func) (info->stream, "%s", opcode->name);
410 
411       /* Now extract and print the operands.  */
412       need_comma = 0;
413       need_paren = 0;
414       skip_optional = -1;
415       for (opindex = opcode->operands; *opindex != 0; opindex++)
416 	{
417 	  long value;
418 
419 	  operand = powerpc_operands + *opindex;
420 
421 	  /* Operands that are marked FAKE are simply ignored.  We
422 	     already made sure that the extract function considered
423 	     the instruction to be valid.  */
424 	  if ((operand->flags & PPC_OPERAND_FAKE) != 0)
425 	    continue;
426 
427 	  /* If all of the optional operands have the value zero,
428 	     then don't print any of them.  */
429 	  if ((operand->flags & PPC_OPERAND_OPTIONAL) != 0)
430 	    {
431 	      if (skip_optional < 0)
432 		skip_optional = skip_optional_operands (opindex, insn,
433 							dialect);
434 	      if (skip_optional)
435 		continue;
436 	    }
437 
438 	  value = operand_value_powerpc (operand, insn, dialect);
439 
440 	  if (need_comma)
441 	    {
442 	      (*info->fprintf_func) (info->stream, ",");
443 	      need_comma = 0;
444 	    }
445 
446 	  /* Print the operand as directed by the flags.  */
447 	  if ((operand->flags & PPC_OPERAND_GPR) != 0
448 	      || ((operand->flags & PPC_OPERAND_GPR_0) != 0 && value != 0))
449 	    (*info->fprintf_func) (info->stream, "r%ld", value);
450 	  else if ((operand->flags & PPC_OPERAND_FPR) != 0)
451 	    (*info->fprintf_func) (info->stream, "f%ld", value);
452 	  else if ((operand->flags & PPC_OPERAND_VR) != 0)
453 	    (*info->fprintf_func) (info->stream, "v%ld", value);
454 	  else if ((operand->flags & PPC_OPERAND_VSR) != 0)
455 	    (*info->fprintf_func) (info->stream, "vs%ld", value);
456 	  else if ((operand->flags & PPC_OPERAND_RELATIVE) != 0)
457 	    (*info->print_address_func) (memaddr + value, info);
458 	  else if ((operand->flags & PPC_OPERAND_ABSOLUTE) != 0)
459 	    (*info->print_address_func) ((bfd_vma) value & 0xffffffff, info);
460 	  else if ((operand->flags & PPC_OPERAND_FSL) != 0)
461 	    (*info->fprintf_func) (info->stream, "fsl%ld", value);
462 	  else if ((operand->flags & PPC_OPERAND_FCR) != 0)
463 	    (*info->fprintf_func) (info->stream, "fcr%ld", value);
464 	  else if ((operand->flags & PPC_OPERAND_UDI) != 0)
465 	    (*info->fprintf_func) (info->stream, "%ld", value);
466 	  else if ((operand->flags & PPC_OPERAND_CR) != 0
467 		   && (dialect & PPC_OPCODE_PPC) != 0)
468 	    {
469 	      if (operand->bitm == 7)
470 		(*info->fprintf_func) (info->stream, "cr%ld", value);
471 	      else
472 		{
473 		  static const char *cbnames[4] = { "lt", "gt", "eq", "so" };
474 		  int cr;
475 		  int cc;
476 
477 		  cr = value >> 2;
478 		  if (cr != 0)
479 		    (*info->fprintf_func) (info->stream, "4*cr%d+", cr);
480 		  cc = value & 3;
481 		  (*info->fprintf_func) (info->stream, "%s", cbnames[cc]);
482 		}
483 	    }
484 	  else
485 	    (*info->fprintf_func) (info->stream, "%ld", value);
486 
487 	  if (need_paren)
488 	    {
489 	      (*info->fprintf_func) (info->stream, ")");
490 	      need_paren = 0;
491 	    }
492 
493 	  if ((operand->flags & PPC_OPERAND_PARENS) == 0)
494 	    need_comma = 1;
495 	  else
496 	    {
497 	      (*info->fprintf_func) (info->stream, "(");
498 	      need_paren = 1;
499 	    }
500 	}
501 
502       /* We have found and printed an instruction; return.  */
503       return 4;
504     }
505 
506   if ((dialect & PPC_OPCODE_ANY) != 0)
507     {
508       dialect = ~(ppc_cpu_t) PPC_OPCODE_ANY;
509       goto again;
510     }
511 
512   /* We could not find a match.  */
513   (*info->fprintf_func) (info->stream, ".long 0x%lx", insn);
514 
515   return 4;
516 }
517 
518 void
print_ppc_disassembler_options(FILE * stream)519 print_ppc_disassembler_options (FILE *stream)
520 {
521   unsigned int i, col;
522 
523   fprintf (stream, _("\n\
524 The following PPC specific disassembler options are supported for use with\n\
525 the -M switch:\n"));
526 
527   for (col = 0, i = 0; i < sizeof (ppc_opts) / sizeof (ppc_opts[0]); i++)
528     {
529       col += fprintf (stream, " %s,", ppc_opts[i].opt);
530       if (col > 66)
531 	{
532 	  fprintf (stream, "\n");
533 	  col = 0;
534 	}
535     }
536   fprintf (stream, " 32, 64\n");
537 }
538