gem5  v22.0.0.2
Classes | Public Types | Public Member Functions | Protected Member Functions | Protected Attributes | List of all members
gem5::Trace::TarmacTracerRecord Class Reference

TarmacTracer Record: Record generated by the TarmacTracer for every executed instruction. More...

#include <tarmac_record.hh>

Inheritance diagram for gem5::Trace::TarmacTracerRecord:
gem5::Trace::TarmacBaseRecord gem5::Trace::InstRecord gem5::Trace::TarmacTracerRecordV8

Classes

struct  TraceInstEntry
 Instruction Entry. More...
 
struct  TraceMemEntry
 Memory Entry. More...
 
struct  TraceRegEntry
 Register Entry. More...
 

Public Types

using InstPtr = std::unique_ptr< TraceInstEntry >
 
using MemPtr = std::unique_ptr< TraceMemEntry >
 
using RegPtr = std::unique_ptr< TraceRegEntry >
 
- Public Types inherited from gem5::Trace::TarmacBaseRecord
enum  TarmacRecordType { TARMAC_INST, TARMAC_REG, TARMAC_MEM, TARMAC_UNSUPPORTED }
 TARMAC trace record type. More...
 
enum  ISetState { ISET_ARM, ISET_THUMB, ISET_A64, ISET_UNSUPPORTED }
 ARM instruction set state. More...
 
enum  RegType {
  REG_R, REG_X, REG_S, REG_D,
  REG_P, REG_Q, REG_Z, REG_MISC
}
 ARM register type. More...
 

Public Member Functions

 TarmacTracerRecord (Tick _when, ThreadContext *_thread, const StaticInstPtr _staticInst, const PCStateBase &_pc, TarmacTracer &_tracer, const StaticInstPtr _macroStaticInst=NULL)
 
virtual void dump () override
 
- Public Member Functions inherited from gem5::Trace::TarmacBaseRecord
 TarmacBaseRecord (Tick _when, ThreadContext *_thread, const StaticInstPtr _staticInst, const PCStateBase &_pc, const StaticInstPtr _macroStaticInst=nullptr)
 
- Public Member Functions inherited from gem5::Trace::InstRecord
 InstRecord (Tick _when, ThreadContext *_thread, const StaticInstPtr _staticInst, const PCStateBase &_pc, const StaticInstPtr _macroStaticInst=nullptr)
 
virtual ~InstRecord ()
 
void setWhen (Tick new_when)
 
void setMem (Addr a, Addr s, unsigned f)
 
template<typename T , size_t N>
void setData (std::array< T, N > d)
 
void setData (uint64_t d)
 
void setData (uint32_t d)
 
void setData (uint16_t d)
 
void setData (uint8_t d)
 
void setData (int64_t d)
 
void setData (int32_t d)
 
void setData (int16_t d)
 
void setData (int8_t d)
 
void setData (double d)
 
void setData (TheISA::VecRegContainer &d)
 
void setData (TheISA::VecPredRegContainer &d)
 
void setFetchSeq (InstSeqNum seq)
 
void setCPSeq (InstSeqNum seq)
 
void setPredicate (bool val)
 
void setFaulting (bool val)
 
Tick getWhen () const
 
ThreadContextgetThread () const
 
StaticInstPtr getStaticInst () const
 
const PCStateBasegetPCState () const
 
StaticInstPtr getMacroStaticInst () const
 
Addr getAddr () const
 
Addr getSize () const
 
unsigned getFlags () const
 
bool getMemValid () const
 
uint64_t getIntData () const
 
double getFloatData () const
 
int getDataStatus () const
 
InstSeqNum getFetchSeq () const
 
bool getFetchSeqValid () const
 
InstSeqNum getCpSeq () const
 
bool getCpSeqValid () const
 
bool getFaulting () const
 

Protected Member Functions

virtual void addInstEntry (std::vector< InstPtr > &queue, const TarmacContext &ptr)
 Generates an Entry for the executed instruction. More...
 
virtual void addMemEntry (std::vector< MemPtr > &queue, const TarmacContext &ptr)
 Generates an Entry for every triggered memory access. More...
 
virtual void addRegEntry (std::vector< RegPtr > &queue, const TarmacContext &ptr)
 Generate an Entry for every register being written. More...
 
template<typename RegEntry >
RegEntry genRegister (const TarmacContext &tarmCtx, const RegId &reg)
 Generate and update a register entry. More...
 
template<typename RegEntry >
void mergeCCEntry (std::vector< RegPtr > &queue, const TarmacContext &tarmCtx)
 
template<typename Queue >
void flushQueues (Queue &queue)
 Flush queues to the trace output. More...
 
template<typename Queue , typename... Args>
void flushQueues (Queue &queue, Args &... args)
 

Protected Attributes

TarmacTracertracer
 Reference to tracer. More...
 
- Protected Attributes inherited from gem5::Trace::InstRecord
Tick when
 
ThreadContextthread
 
StaticInstPtr staticInst
 
std::unique_ptr< PCStateBasepc
 
StaticInstPtr macroStaticInst
 
Addr addr = 0
 The address that was accessed. More...
 
Addr size = 0
 The size of the memory request. More...
 
unsigned flags = 0
 The flags that were assigned to the request. More...
 
union {
   uint64_t   as_int
 
   double   as_double
 
   TheISA::VecRegContainer *   as_vec
 
   TheISA::VecPredRegContainer *   as_pred
 
data = {0}
 
InstSeqNum fetch_seq = 0
 
InstSeqNum cp_seq = 0
 
enum gem5::Trace::InstRecord::DataStatus data_status = DataInvalid
 
bool mem_valid = false
 
bool fetch_seq_valid = false
 
bool cp_seq_valid = false
 
bool predicate = true
 is the predicate for execution this inst true or false (not execed)? More...
 
bool faulting = false
 Did the execution of this instruction fault? (requires ExecFaulting to be enabled) More...
 

Additional Inherited Members

- Static Public Member Functions inherited from gem5::Trace::TarmacBaseRecord
static ISetState pcToISetState (const PCStateBase &pc)
 Returns the Instruction Set State according to the current PCState. More...
 
- Protected Types inherited from gem5::Trace::InstRecord
enum  DataStatus {
  DataInvalid = 0, DataInt8 = 1, DataInt16 = 2, DataInt32 = 4,
  DataInt64 = 8, DataDouble = 3, DataVec = 5, DataVecPred = 6
}
 

Detailed Description

TarmacTracer Record: Record generated by the TarmacTracer for every executed instruction.

The record is composed by a set of entries, matching the tracing capabilities provided by the Tarmac specifications:

Definition at line 94 of file tarmac_record.hh.

Member Typedef Documentation

◆ InstPtr

Definition at line 196 of file tarmac_record.hh.

◆ MemPtr

Definition at line 197 of file tarmac_record.hh.

◆ RegPtr

Definition at line 198 of file tarmac_record.hh.

Constructor & Destructor Documentation

◆ TarmacTracerRecord()

gem5::Trace::TarmacTracerRecord::TarmacTracerRecord ( Tick  _when,
ThreadContext _thread,
const StaticInstPtr  _staticInst,
const PCStateBase _pc,
TarmacTracer _tracer,
const StaticInstPtr  _macroStaticInst = NULL 
)

Definition at line 112 of file tarmac_record.cc.

Member Function Documentation

◆ addInstEntry()

void gem5::Trace::TarmacTracerRecord::addInstEntry ( std::vector< InstPtr > &  queue,
const TarmacContext ptr 
)
protectedvirtual

Generates an Entry for the executed instruction.

Reimplemented in gem5::Trace::TarmacTracerRecordV8.

Definition at line 294 of file tarmac_record.cc.

References gem5::Trace::InstRecord::predicate.

Referenced by dump().

◆ addMemEntry()

void gem5::Trace::TarmacTracerRecord::addMemEntry ( std::vector< MemPtr > &  queue,
const TarmacContext ptr 
)
protectedvirtual

Generates an Entry for every triggered memory access.

Reimplemented in gem5::Trace::TarmacTracerRecordV8.

Definition at line 305 of file tarmac_record.cc.

References gem5::Trace::InstRecord::getAddr(), gem5::Trace::InstRecord::getIntData(), gem5::Trace::InstRecord::getMemValid(), and gem5::Trace::InstRecord::getSize().

Referenced by dump().

◆ addRegEntry()

void gem5::Trace::TarmacTracerRecord::addRegEntry ( std::vector< RegPtr > &  queue,
const TarmacContext ptr 
)
protectedvirtual

Generate an Entry for every register being written.

Reimplemented in gem5::Trace::TarmacTracerRecordV8.

Definition at line 321 of file tarmac_record.cc.

References gem5::StaticInst::destRegIdx(), gem5::StaticInst::numDestRegs(), gem5::X86ISA::reg, and gem5::Trace::InstRecord::staticInst.

Referenced by dump().

◆ dump()

void gem5::Trace::TarmacTracerRecord::dump ( )
overridevirtual

◆ flushQueues() [1/2]

template<typename Queue >
void gem5::Trace::TarmacTracerRecord::flushQueues ( Queue queue)
protected

Flush queues to the trace output.

Definition at line 393 of file tarmac_record.cc.

References gem5::Trace::output().

Referenced by dump(), and flushQueues().

◆ flushQueues() [2/2]

template<typename Queue , typename... Args>
void gem5::Trace::TarmacTracerRecord::flushQueues ( Queue queue,
Args &...  args 
)
protected

Definition at line 406 of file tarmac_record.cc.

References flushQueues().

◆ genRegister()

template<typename RegEntry >
RegEntry gem5::Trace::TarmacTracerRecord::genRegister ( const TarmacContext tarmCtx,
const RegId reg 
)
inlineprotected

Generate and update a register entry.

Definition at line 217 of file tarmac_record.hh.

References gem5::X86ISA::reg.

◆ mergeCCEntry()

template<typename RegEntry >
void gem5::Trace::TarmacTracerRecord::mergeCCEntry ( std::vector< RegPtr > &  queue,
const TarmacContext tarmCtx 
)
inlineprotected

Member Data Documentation

◆ tracer

TarmacTracer& gem5::Trace::TarmacTracerRecord::tracer
protected

Reference to tracer.

Definition at line 269 of file tarmac_record.hh.

Referenced by dump().


The documentation for this class was generated from the following files:

Generated on Thu Jul 28 2022 13:34:20 for gem5 by doxygen 1.8.17