gem5  v21.1.0.2
Public Member Functions | Static Public Member Functions | Public Attributes | Private Attributes | List of all members
gem5::minor::ForwardLineData Class Reference

Line fetch data in the forward direction. More...

#include <pipe_data.hh>

Public Member Functions

 ForwardLineData ()
 
 ~ForwardLineData ()
 
bool isFault () const
 This is a fault, not a line. More...
 
void setFault (Fault fault_)
 Set fault and possible clear the bubble flag. More...
 
void allocateLine (unsigned int width_)
 In-place initialise a ForwardLineData, freeing and overridding the line. More...
 
void adoptPacketData (Packet *packet)
 Use the data from a packet as line instead of allocating new space. More...
 
void freeLine ()
 Free this ForwardLineData line. More...
 
bool isBubble () const
 
void reportData (std::ostream &os) const
 ReportIF interface. More...
 

Static Public Member Functions

static ForwardLineData bubble ()
 BubbleIF interface. More...
 

Public Attributes

Addr lineBaseAddr
 First byte address in the line. More...
 
TheISA::PCState pc
 PC of the first requested inst within this line. More...
 
unsigned int lineWidth
 Explicit line width, don't rely on data.size. More...
 
Fault fault
 This line has a fault. More...
 
InstId id
 Thread, stream, prediction ... More...
 
uint8_t * line
 Line data. More...
 
Packetpacket
 Packet from which the line is taken. More...
 

Private Attributes

bool bubbleFlag
 This line is a bubble. More...
 

Detailed Description

Line fetch data in the forward direction.

Contains a single cache line (or fragment of a line), its address, a sequence number assigned when that line was fetched and a bubbleFlag that can allow ForwardLineData to be used to represent the absence of line data in a pipeline.

Definition at line 175 of file pipe_data.hh.

Constructor & Destructor Documentation

◆ ForwardLineData()

gem5::minor::ForwardLineData::ForwardLineData ( )
inline

Definition at line 209 of file pipe_data.hh.

Referenced by bubble().

◆ ~ForwardLineData()

gem5::minor::ForwardLineData::~ForwardLineData ( )
inline

Definition at line 220 of file pipe_data.hh.

References line.

Member Function Documentation

◆ adoptPacketData()

void gem5::minor::ForwardLineData::adoptPacketData ( Packet packet)

Use the data from a packet as line instead of allocating new space.

On destruction of this object, the packet will be destroyed

Definition at line 187 of file pipe_data.cc.

References bubbleFlag, gem5::Packet::getPtr(), isFault(), line, lineWidth, packet, and gem5::Packet::req.

Referenced by gem5::minor::Fetch1::processResponse().

◆ allocateLine()

void gem5::minor::ForwardLineData::allocateLine ( unsigned int  width_)

In-place initialise a ForwardLineData, freeing and overridding the line.

Definition at line 175 of file pipe_data.cc.

References bubbleFlag, isFault(), line, and lineWidth.

◆ bubble()

static ForwardLineData gem5::minor::ForwardLineData::bubble ( )
inlinestatic

BubbleIF interface.

Definition at line 244 of file pipe_data.hh.

References ForwardLineData().

◆ freeLine()

void gem5::minor::ForwardLineData::freeLine ( )

Free this ForwardLineData line.

Note that these are shared between line objects and so you must be careful when deallocating them. Copying of ForwardLineData can, therefore, be done by default copy constructors/assignment

Definition at line 200 of file pipe_data.cc.

References bubbleFlag, isBubble(), isFault(), line, and packet.

◆ isBubble()

bool gem5::minor::ForwardLineData::isBubble ( ) const
inline

Definition at line 245 of file pipe_data.hh.

References bubbleFlag.

Referenced by gem5::minor::Fetch1::evaluate(), freeLine(), and reportData().

◆ isFault()

bool gem5::minor::ForwardLineData::isFault ( ) const
inline

This is a fault, not a line.

Definition at line 224 of file pipe_data.hh.

References fault, and gem5::NoFault.

Referenced by adoptPacketData(), allocateLine(), gem5::minor::Fetch2::evaluate(), freeLine(), and setFault().

◆ reportData()

void gem5::minor::ForwardLineData::reportData ( std::ostream &  os) const

ReportIF interface.

Definition at line 218 of file pipe_data.cc.

References fault, id, isBubble(), gem5::NoFault, and gem5::X86ISA::os.

◆ setFault()

void gem5::minor::ForwardLineData::setFault ( Fault  fault_)

Set fault and possible clear the bubble flag.

Definition at line 167 of file pipe_data.cc.

References bubbleFlag, fault, and isFault().

Referenced by gem5::minor::Fetch1::processResponse().

Member Data Documentation

◆ bubbleFlag

bool gem5::minor::ForwardLineData::bubbleFlag
private

This line is a bubble.

No other data member is required to be valid if this is true

Definition at line 180 of file pipe_data.hh.

Referenced by adoptPacketData(), allocateLine(), freeLine(), isBubble(), and setFault().

◆ fault

Fault gem5::minor::ForwardLineData::fault

This line has a fault.

The bubble flag will be false and seqNums will be valid but no data will

Definition at line 196 of file pipe_data.hh.

Referenced by gem5::minor::Fetch2::evaluate(), isFault(), reportData(), and setFault().

◆ id

InstId gem5::minor::ForwardLineData::id

Thread, stream, prediction ...

id of this line

Definition at line 199 of file pipe_data.hh.

Referenced by gem5::minor::Fetch2::evaluate(), gem5::minor::Fetch1::processResponse(), and reportData().

◆ line

uint8_t* gem5::minor::ForwardLineData::line

Line data.

line[0] is the byte at address pc.instAddr(). Data is only valid upto lineWidth - 1.

Definition at line 203 of file pipe_data.hh.

Referenced by adoptPacketData(), allocateLine(), gem5::minor::Fetch2::evaluate(), freeLine(), and ~ForwardLineData().

◆ lineBaseAddr

Addr gem5::minor::ForwardLineData::lineBaseAddr

First byte address in the line.

This is allowed to be <= pc.instAddr()

Definition at line 185 of file pipe_data.hh.

Referenced by gem5::minor::Fetch2::evaluate(), and gem5::minor::Fetch1::processResponse().

◆ lineWidth

unsigned int gem5::minor::ForwardLineData::lineWidth

Explicit line width, don't rely on data.size.

Definition at line 191 of file pipe_data.hh.

Referenced by adoptPacketData(), allocateLine(), and gem5::minor::Fetch2::evaluate().

◆ packet

Packet* gem5::minor::ForwardLineData::packet

Packet from which the line is taken.

Definition at line 206 of file pipe_data.hh.

Referenced by adoptPacketData(), and freeLine().

◆ pc

TheISA::PCState gem5::minor::ForwardLineData::pc

PC of the first requested inst within this line.

Definition at line 188 of file pipe_data.hh.

Referenced by gem5::minor::Fetch2::evaluate(), and gem5::minor::Fetch1::processResponse().


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

Generated on Tue Sep 21 2021 12:31:30 for gem5 by doxygen 1.8.17