gem5  v21.1.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, ArmISA::PCState _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, ArmISA::PCState _pc, const StaticInstPtr _macroStaticInst=NULL)
 
- Public Member Functions inherited from gem5::Trace::InstRecord
 InstRecord (Tick _when, ThreadContext *_thread, const StaticInstPtr _staticInst, TheISA::PCState _pc, const StaticInstPtr _macroStaticInst=NULL)
 
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
 
TheISA::PCState getPCState () 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
 
TheISA::PCState pc
 
StaticInstPtr macroStaticInst
 
Addr addr
 The address that was accessed. More...
 
Addr size
 The size of the memory request. More...
 
unsigned flags
 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
 
InstSeqNum fetch_seq
 
InstSeqNum cp_seq
 
enum gem5::Trace::InstRecord::DataStatus data_status
 
bool mem_valid
 
bool fetch_seq_valid
 
bool cp_seq_valid
 
bool predicate
 is the predicate for execution this inst true or false (not execed)? More...
 
bool faulting
 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 (ArmISA::PCState 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,
ArmISA::PCState  _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 293 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 304 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 320 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 392 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 405 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 Tue Sep 21 2021 12:32:32 for gem5 by doxygen 1.8.17