sim: cgen: namespace custom trace functions
[external/binutils.git] / sim / common / cgen-trace.c
1 /* Tracing support for CGEN-based simulators.
2    Copyright (C) 1996-2015 Free Software Foundation, Inc.
3    Contributed by Cygnus Support.
4
5 This file is part of GDB, the GNU debugger.
6
7 This program 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 of the License, or
10 (at your option) any later version.
11
12 This program is distributed in the hope that it will be useful,
13 but WITHOUT ANY WARRANTY; without even the implied warranty of
14 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
15 GNU General Public License for more details.
16
17 You should have received a copy of the GNU General Public License
18 along with this program.  If not, see <http://www.gnu.org/licenses/>.  */
19
20 #include "config.h"
21 #include <errno.h>
22 #include "dis-asm.h"
23 #include "bfd.h"
24 #include "sim-main.h"
25 #include "sim-fpu.h"
26
27 #undef min
28 #define min(a,b) ((a) < (b) ? (a) : (b))
29
30 #ifndef SIZE_INSTRUCTION
31 #define SIZE_INSTRUCTION 16
32 #endif
33
34 #ifndef SIZE_LOCATION
35 #define SIZE_LOCATION 20
36 #endif
37
38 #ifndef SIZE_PC
39 #define SIZE_PC 6
40 #endif
41
42 #ifndef SIZE_LINE_NUMBER
43 #define SIZE_LINE_NUMBER 4
44 #endif
45
46 #ifndef SIZE_CYCLE_COUNT
47 #define SIZE_CYCLE_COUNT 2
48 #endif
49
50 #ifndef SIZE_TOTAL_CYCLE_COUNT
51 #define SIZE_TOTAL_CYCLE_COUNT 9
52 #endif
53
54 #ifndef SIZE_TRACE_BUF
55 #define SIZE_TRACE_BUF 1024
56 #endif
57
58 /* Text is queued in TRACE_BUF because we want to output the insn's cycle
59    count first but that isn't known until after the insn has executed.
60    This also handles the queueing of trace results, TRACE_RESULT may be
61    called multiple times for one insn.  */
62 static char trace_buf[SIZE_TRACE_BUF];
63 /* If NULL, output to stdout directly.  */
64 static char *bufptr;
65
66 /* Non-zero if this is the first insn in a set of parallel insns.  */
67 static int first_insn_p;
68
69 /* For communication between cgen_trace_insn and cgen_trace_result.  */
70 static int printed_result_p;
71
72 /* Insn and its extracted fields.
73    Set by cgen_trace_insn, used by cgen_trace_insn_fini.
74    ??? Move to SIM_CPU to support heterogeneous multi-cpu case.  */
75 static const struct cgen_insn *current_insn;
76 static const struct argbuf *current_abuf;
77
78 void
79 cgen_trace_insn_init (SIM_CPU *cpu, int first_p)
80 {
81   bufptr = trace_buf;
82   *bufptr = 0;
83   first_insn_p = first_p;
84
85   /* Set to NULL so cgen_trace_insn_fini can know if cgen_trace_insn was
86      called.  */
87   current_insn = NULL;
88   current_abuf = NULL;
89 }
90
91 void
92 cgen_trace_insn_fini (SIM_CPU *cpu, const struct argbuf *abuf, int last_p)
93 {
94   SIM_DESC sd = CPU_STATE (cpu);
95
96   /* Was insn traced?  It might not be if trace ranges are in effect.  */
97   if (current_insn == NULL)
98     return;
99
100   /* The first thing printed is current and total cycle counts.  */
101
102   if (PROFILE_MODEL_P (cpu)
103       && ARGBUF_PROFILE_P (current_abuf))
104     {
105       unsigned long total = PROFILE_MODEL_TOTAL_CYCLES (CPU_PROFILE_DATA (cpu));
106       unsigned long this_insn = PROFILE_MODEL_CUR_INSN_CYCLES (CPU_PROFILE_DATA (cpu));
107
108       if (last_p)
109         {
110           trace_printf (sd, cpu, "%-*ld %-*ld ",
111                         SIZE_CYCLE_COUNT, this_insn,
112                         SIZE_TOTAL_CYCLE_COUNT, total);
113         }
114       else
115         {
116           trace_printf (sd, cpu, "%-*ld %-*s ",
117                         SIZE_CYCLE_COUNT, this_insn,
118                         SIZE_TOTAL_CYCLE_COUNT, "---");
119         }
120     }
121
122   /* Print the disassembled insn.  */
123
124   trace_printf (sd, cpu, "%s", TRACE_PREFIX (CPU_TRACE_DATA (cpu)));
125
126 #if 0
127   /* Print insn results.  */
128   {
129     const CGEN_OPINST *opinst = CGEN_INSN_OPERANDS (current_insn);
130
131     if (opinst)
132       {
133         int i;
134         int indices[MAX_OPERAND_INSTANCES];
135
136         /* Fetch the operands used by the insn.  */
137         /* FIXME: Add fn ptr to CGEN_CPU_DESC.  */
138         CGEN_SYM (get_insn_operands) (CPU_CPU_DESC (cpu), current_insn,
139                                       0, CGEN_FIELDS_BITSIZE (&insn_fields),
140                                       indices);
141
142         for (i = 0;
143              CGEN_OPINST_TYPE (opinst) != CGEN_OPINST_END;
144              ++i, ++opinst)
145           {
146             if (CGEN_OPINST_TYPE (opinst) == CGEN_OPINST_OUTPUT)
147               cgen_trace_result (cpu, current_insn, opinst, indices[i]);
148           }
149       }
150   }
151 #endif
152
153   /* Print anything else requested.  */
154
155   if (*trace_buf)
156     trace_printf (sd, cpu, " %s\n", trace_buf);
157   else
158     trace_printf (sd, cpu, "\n");
159 }
160
161 void
162 cgen_trace_insn (SIM_CPU *cpu, const struct cgen_insn *opcode,
163                  const struct argbuf *abuf, IADDR pc)
164 {
165   char disasm_buf[50];
166
167   printed_result_p = 0;
168   current_insn = opcode;
169   current_abuf = abuf;
170
171   if (CGEN_INSN_VIRTUAL_P (opcode))
172     {
173       trace_prefix (CPU_STATE (cpu), cpu, NULL_CIA, pc, 0,
174                     NULL, 0, CGEN_INSN_NAME (opcode));
175       return;
176     }
177
178   CPU_DISASSEMBLER (cpu) (cpu, opcode, abuf, pc, disasm_buf);
179   trace_prefix (CPU_STATE (cpu), cpu, NULL_CIA, pc, TRACE_LINENUM_P (cpu),
180                 NULL, 0,
181                 "%s%-*s",
182                 first_insn_p ? " " : "|",
183                 SIZE_INSTRUCTION, disasm_buf);
184 }
185
186 void
187 cgen_trace_extract (SIM_CPU *cpu, IADDR pc, char *name, ...)
188 {
189   va_list args;
190   int printed_one_p = 0;
191   char *fmt;
192
193   va_start (args, name);
194
195   trace_printf (CPU_STATE (cpu), cpu, "Extract: 0x%.*lx: %s ",
196                 SIZE_PC, (unsigned long) pc, name);
197
198   do {
199     int type,ival;
200
201     fmt = va_arg (args, char *);
202
203     if (fmt)
204       {
205         if (printed_one_p)
206           trace_printf (CPU_STATE (cpu), cpu, ", ");
207         printed_one_p = 1;
208         type = va_arg (args, int);
209         switch (type)
210           {
211           case 'x' :
212             ival = va_arg (args, int);
213             trace_printf (CPU_STATE (cpu), cpu, fmt, ival);
214             break;
215           default :
216             abort ();
217           }
218       }
219   } while (fmt);
220
221   va_end (args);
222   trace_printf (CPU_STATE (cpu), cpu, "\n");
223 }
224
225 void
226 cgen_trace_result (SIM_CPU *cpu, char *name, int type, ...)
227 {
228   va_list args;
229
230   va_start (args, type);
231   if (printed_result_p)
232     cgen_trace_printf (cpu, ", ");
233
234   switch (type)
235     {
236     case 'x' :
237     default :
238       cgen_trace_printf (cpu, "%s <- 0x%x", name, va_arg (args, int));
239       break;
240     case 'f':
241       {
242         DI di;
243         sim_fpu f;
244
245         /* this is separated from previous line for sunos cc */
246         di = va_arg (args, DI);
247         sim_fpu_64to (&f, di);
248
249         cgen_trace_printf (cpu, "%s <- ", name);
250         sim_fpu_printn_fpu (&f, (sim_fpu_print_func *) cgen_trace_printf, 4, cpu);
251         break;
252       }
253     case 'D' :
254       {
255         DI di;
256         /* this is separated from previous line for sunos cc */
257         di = va_arg (args, DI);
258         cgen_trace_printf (cpu, "%s <- 0x%x%08x", name,
259                            GETHIDI(di), GETLODI (di));
260         break;
261       }
262     }
263
264   printed_result_p = 1;
265   va_end (args);
266 }
267
268 /* Print trace output to BUFPTR if active, otherwise print normally.
269    This is only for tracing semantic code.  */
270
271 void
272 cgen_trace_printf (SIM_CPU *cpu, char *fmt, ...)
273 {
274   va_list args;
275
276   va_start (args, fmt);
277
278   if (bufptr == NULL)
279     {
280       if (TRACE_FILE (CPU_TRACE_DATA (cpu)) == NULL)
281         (* STATE_CALLBACK (CPU_STATE (cpu))->evprintf_filtered)
282           (STATE_CALLBACK (CPU_STATE (cpu)), fmt, args);
283       else
284         vfprintf (TRACE_FILE (CPU_TRACE_DATA (cpu)), fmt, args);
285     }
286   else
287     {
288       vsprintf (bufptr, fmt, args);
289       bufptr += strlen (bufptr);
290       /* ??? Need version of SIM_ASSERT that is always enabled.  */
291       if (bufptr - trace_buf > SIZE_TRACE_BUF)
292         abort ();
293     }
294
295   va_end (args);
296 }
297 \f
298 /* Disassembly support.  */
299
300 /* sprintf to a "stream" */
301
302 int
303 sim_disasm_sprintf (SFILE *f, const char *format, ...)
304 {
305 #ifndef __STDC__
306   SFILE *f;
307   const char *format;
308 #endif
309   int n;
310   va_list args;
311
312   va_start (args, format);
313 #ifndef __STDC__
314   f = va_arg (args, SFILE *);
315   format = va_arg (args, char *);
316 #endif
317   vsprintf (f->current, format, args);
318   f->current += n = strlen (f->current);
319   va_end (args);
320   return n;
321 }
322
323 /* Memory read support for an opcodes disassembler.  */
324
325 int
326 sim_disasm_read_memory (bfd_vma memaddr, bfd_byte *myaddr, unsigned int length,
327                         struct disassemble_info *info)
328 {
329   SIM_CPU *cpu = (SIM_CPU *) info->application_data;
330   SIM_DESC sd = CPU_STATE (cpu);
331   unsigned length_read;
332
333   length_read = sim_core_read_buffer (sd, cpu, read_map, myaddr, memaddr,
334                                       length);
335   if (length_read != length)
336     return EIO;
337   return 0;
338 }
339
340 /* Memory error support for an opcodes disassembler.  */
341
342 void
343 sim_disasm_perror_memory (int status, bfd_vma memaddr,
344                           struct disassemble_info *info)
345 {
346   if (status != EIO)
347     /* Can't happen.  */
348     info->fprintf_func (info->stream, "Unknown error %d.", status);
349   else
350     /* Actually, address between memaddr and memaddr + len was
351        out of bounds.  */
352     info->fprintf_func (info->stream,
353                         "Address 0x%x is out of bounds.",
354                         (int) memaddr);
355 }
356
357 /* Disassemble using the CGEN opcode table.
358    ??? While executing an instruction, the insn has been decoded and all its
359    fields have been extracted.  It is certainly possible to do the disassembly
360    with that data.  This seems simpler, but maybe in the future the already
361    extracted fields will be used.  */
362
363 void
364 sim_cgen_disassemble_insn (SIM_CPU *cpu, const CGEN_INSN *insn,
365                            const ARGBUF *abuf, IADDR pc, char *buf)
366 {
367   unsigned int length;
368   unsigned int base_length;
369   unsigned long insn_value;
370   struct disassemble_info disasm_info;
371   SFILE sfile;
372   union {
373     unsigned8 bytes[CGEN_MAX_INSN_SIZE];
374     unsigned16 shorts[8];
375     unsigned32 words[4];
376   } insn_buf;
377   SIM_DESC sd = CPU_STATE (cpu);
378   CGEN_CPU_DESC cd = CPU_CPU_DESC (cpu);
379   CGEN_EXTRACT_INFO ex_info;
380   CGEN_FIELDS *fields = alloca (CGEN_CPU_SIZEOF_FIELDS (cd));
381   int insn_bit_length = CGEN_INSN_BITSIZE (insn);
382   int insn_length = insn_bit_length / 8;
383
384   sfile.buffer = sfile.current = buf;
385   INIT_DISASSEMBLE_INFO (disasm_info, (FILE *) &sfile,
386                          (fprintf_ftype) sim_disasm_sprintf);
387   disasm_info.endian =
388     (bfd_big_endian (STATE_PROG_BFD (sd)) ? BFD_ENDIAN_BIG
389      : bfd_little_endian (STATE_PROG_BFD (sd)) ? BFD_ENDIAN_LITTLE
390      : BFD_ENDIAN_UNKNOWN);
391
392   length = sim_core_read_buffer (sd, cpu, read_map, &insn_buf, pc,
393                                  insn_length);
394
395   if (length != insn_length)
396   {
397     sim_io_error (sd, "unable to read address %x", pc);
398   }
399
400   /* If the entire insn will fit into an integer, then do it. Otherwise, just
401      use the bits of the base_insn.  */
402   if (insn_bit_length <= 32)
403     base_length = insn_bit_length;
404   else
405     base_length = min (cd->base_insn_bitsize, insn_bit_length);
406   switch (base_length)
407     {
408     case 0 : return; /* fake insn, typically "compile" (aka "invalid") */
409     case 8 : insn_value = insn_buf.bytes[0]; break;
410     case 16 : insn_value = T2H_2 (insn_buf.shorts[0]); break;
411     case 32 : insn_value = T2H_4 (insn_buf.words[0]); break;
412     default: abort ();
413     }
414
415   disasm_info.buffer_vma = pc;
416   disasm_info.buffer = insn_buf.bytes;
417   disasm_info.buffer_length = length;
418
419   ex_info.dis_info = (PTR) &disasm_info;
420   ex_info.valid = (1 << length) - 1;
421   ex_info.insn_bytes = insn_buf.bytes;
422
423   length = (*CGEN_EXTRACT_FN (cd, insn)) (cd, insn, &ex_info, insn_value, fields, pc);
424   /* Result of extract fn is in bits.  */
425   /* ??? This assumes that each instruction has a fixed length (and thus
426      for insns with multiple versions of variable lengths they would each
427      have their own table entry).  */
428   if (length == insn_bit_length)
429     {
430       (*CGEN_PRINT_FN (cd, insn)) (cd, &disasm_info, insn, fields, pc, length);
431     }
432   else
433     {
434       /* This shouldn't happen, but aborting is too drastic.  */
435       strcpy (buf, "***unknown***");
436     }
437 }