Home | History | Annotate | Line # | Download | only in common 
      1 /* Simulator tracing support for Cpu tools GENerated simulators.
      2    Copyright (C) 1996-2024 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 #ifndef CGEN_TRACE_H
     21 #define CGEN_TRACE_H
     22 
     23 #include "ansidecl.h"
     24 #include "bfd.h"
     25 
     26 void cgen_trace_insn_init (SIM_CPU *, int);
     27 void cgen_trace_insn_fini (SIM_CPU *, const struct argbuf *, int);
     28 void cgen_trace_insn (SIM_CPU *, const struct cgen_insn *,
     29 		      const struct argbuf *, IADDR);
     30 void cgen_trace_extract (SIM_CPU *, IADDR, const char *, ...);
     31 void cgen_trace_result (SIM_CPU *, const char *, int, ...);
     32 void cgen_trace_printf (SIM_CPU *, const char *fmt, ...) ATTRIBUTE_PRINTF_2;
     33 
     34 /* Trace instruction results.  */
     35 #define CGEN_TRACE_RESULT_P(cpu, abuf) \
     36   (TRACE_INSN_P (cpu) && ARGBUF_TRACE_P (abuf))
     37 
     38 #define CGEN_TRACE_INSN_INIT(cpu, abuf, first_p) \
     39 do { \
     40   if (TRACE_INSN_P (cpu)) \
     41     cgen_trace_insn_init ((cpu), (first_p)); \
     42 } while (0)
     43 #define CGEN_TRACE_INSN_FINI(cpu, abuf, last_p) \
     44 do { \
     45   if (TRACE_INSN_P (cpu)) \
     46     cgen_trace_insn_fini ((cpu), (abuf), (last_p)); \
     47 } while (0)
     48 #define CGEN_TRACE_PRINTF(cpu, what, args) \
     49 do { \
     50   if (TRACE_P ((cpu), (what))) \
     51     cgen_trace_printf args ; \
     52 } while (0)
     53 #define CGEN_TRACE_INSN(cpu, insn, abuf, pc) \
     54 do { \
     55   if (TRACE_INSN_P (cpu) && ARGBUF_TRACE_P (abuf)) \
     56     cgen_trace_insn ((cpu), (insn), (abuf), (pc)) ; \
     57 } while (0)
     58 #define CGEN_TRACE_EXTRACT(cpu, abuf, args) \
     59 do { \
     60   if (TRACE_EXTRACT_P (cpu)) \
     61     cgen_trace_extract args ; \
     62 } while (0)
     63 #define CGEN_TRACE_RESULT(cpu, abuf, name, type, val) \
     64 do { \
     65   if (CGEN_TRACE_RESULT_P ((cpu), (abuf))) \
     66     cgen_trace_result ((cpu), (name), (type), (val)) ; \
     67 } while (0)
     68 
     69 /* Disassembly support.  */
     71 
     72 /* Function to use for cgen-based disassemblers.  */
     73 extern CGEN_DISASSEMBLER sim_cgen_disassemble_insn;
     74 
     75 /* Pseudo FILE object for strings.  */
     76 typedef struct {
     77   char *buffer;
     78   char *current;
     79 } SFILE;
     80 
     81 /* String printer for the disassembler.  */
     82 extern int sim_disasm_sprintf (SFILE *, const char *, ...) ATTRIBUTE_PRINTF_2;
     83 extern int sim_disasm_styled_sprintf (SFILE *, enum disassembler_style, const char *, ...) ATTRIBUTE_PRINTF_3;
     84 
     85 /* For opcodes based disassemblers.  */
     86 #ifdef __BFD_H_SEEN__
     87 struct disassemble_info;
     88 extern int
     89 sim_disasm_read_memory (bfd_vma memaddr_, bfd_byte *myaddr_, unsigned int length_,
     90 			struct disassemble_info *info_);
     91 extern void
     92 sim_disasm_perror_memory (int status_, bfd_vma memaddr_,
     93 			  struct disassemble_info *info_);
     94 #endif
     95 
     96 #endif /* CGEN_TRACE_H */
     97