gem5  v20.1.0.0
Public Member Functions | Protected Member Functions | Protected Attributes | Private Member Functions | Private Attributes | List of all members
BaseCache::CacheResponsePort Class Reference

A cache response port is used for the CPU-side port of the cache, and it is basically a simple timing port that uses a transmit list for responses to the CPU (or connected requestor). More...

#include <base.hh>

Inheritance diagram for BaseCache::CacheResponsePort:
QueuedResponsePort ResponsePort Port AtomicResponseProtocol TimingResponseProtocol FunctionalResponseProtocol BaseCache::CpuSidePort

Public Member Functions

void setBlocked ()
 Do not accept any new requests. More...
 
void clearBlocked ()
 Return to normal operation and accept new requests. More...
 
bool isBlocked () const
 
- Public Member Functions inherited from QueuedResponsePort
 QueuedResponsePort (const std::string &name, SimObject *owner, RespPacketQueue &resp_queue, PortID id=InvalidPortID)
 Create a QueuedPort with a given name, owner, and a supplied implementation of a packet queue. More...
 
virtual ~QueuedResponsePort ()
 
void schedTimingResp (PacketPtr pkt, Tick when)
 Schedule the sending of a timing response. More...
 
bool trySatisfyFunctional (PacketPtr pkt)
 Check the list of buffered packets against the supplied functional request. More...
 
- Public Member Functions inherited from ResponsePort
 ResponsePort (const std::string &name, SimObject *_owner, PortID id=InvalidPortID)
 Response port. More...
 
virtual ~ResponsePort ()
 
bool isSnooping () const
 Find out if the peer request port is snooping or not. More...
 
void sendRangeChange () const
 Called by the owner to send a range change. More...
 
virtual AddrRangeList getAddrRanges () const =0
 Get a list of the non-overlapping address ranges the owner is responsible for. More...
 
void unbind () override
 We let the request port do the work, so these don't do anything. More...
 
void bind (Port &peer) override
 Attach to a peer port. More...
 
Tick sendAtomicSnoop (PacketPtr pkt)
 Send an atomic snoop request packet, where the data is moved and the state is updated in zero time, without interleaving with other memory accesses. More...
 
void sendFunctionalSnoop (PacketPtr pkt) const
 Send a functional snoop request packet, where the data is instantly updated everywhere in the memory system, without affecting the current state of any block or moving the block. More...
 
bool sendTimingResp (PacketPtr pkt)
 Attempt to send a timing response to the request port by calling its corresponding receive function. More...
 
void sendTimingSnoopReq (PacketPtr pkt)
 Attempt to send a timing snoop request packet to the request port by calling its corresponding receive function. More...
 
void sendRetryReq ()
 Send a retry to the request port that previously attempted a sendTimingReq to this response port and failed. More...
 
void sendRetrySnoopResp ()
 Send a retry to the request port that previously attempted a sendTimingSnoopResp to this response port and failed. More...
 
- Public Member Functions inherited from Port
virtual ~Port ()
 Virtual destructor due to inheritance. More...
 
PortgetPeer ()
 Return a reference to this port's peer. More...
 
const std::string name () const
 Return port name (for DPRINTF). More...
 
PortID getId () const
 Get the port id. More...
 
bool isConnected () const
 Is this port currently connected to a peer? More...
 
void takeOverFrom (Port *old)
 A utility function to make it easier to swap out ports. More...
 

Protected Member Functions

 CacheResponsePort (const std::string &_name, BaseCache *_cache, const std::string &_label)
 
- Protected Member Functions inherited from QueuedResponsePort
void recvRespRetry ()
 Called by the peer if sendTimingResp was called on this protocol (causing recvTimingResp to be called on the peer) and was unsuccessful. More...
 
- Protected Member Functions inherited from ResponsePort
void responderUnbind ()
 Called by the request port to unbind. More...
 
void responderBind (RequestPort &request_port)
 Called by the request port to bind. More...
 
Tick recvAtomicBackdoor (PacketPtr pkt, MemBackdoorPtr &backdoor) override
 Default implementations. More...
 
bool tryTiming (PacketPtr pkt) override
 Availability request from the peer. More...
 
bool recvTimingSnoopResp (PacketPtr pkt) override
 Receive a timing snoop response from the peer. More...
 
- Protected Member Functions inherited from Port
void reportUnbound () const
 
 Port (const std::string &_name, PortID _id)
 Abstract base class for ports. More...
 
- Protected Member Functions inherited from AtomicResponseProtocol
Tick sendSnoop (AtomicRequestProtocol *peer, PacketPtr pkt)
 Send an atomic snoop request packet, where the data is moved and the state is updated in zero time, without interleaving with other memory accesses. More...
 
virtual Tick recvAtomic (PacketPtr pkt)=0
 Receive an atomic request packet from the peer. More...
 
- Protected Member Functions inherited from TimingResponseProtocol
bool sendResp (TimingRequestProtocol *peer, PacketPtr pkt)
 Attempt to send a timing response to the peer by calling its corresponding receive function. More...
 
void sendSnoopReq (TimingRequestProtocol *peer, PacketPtr pkt)
 Attempt to send a timing snoop request packet to the peer by calling its corresponding receive function. More...
 
void sendRetryReq (TimingRequestProtocol *peer)
 Send a retry to the peer that previously attempted a sendTimingReq to this protocol and failed. More...
 
void sendRetrySnoopResp (TimingRequestProtocol *peer)
 Send a retry to the peer that previously attempted a sendTimingSnoopResp to this peer and failed. More...
 
virtual bool recvTimingReq (PacketPtr pkt)=0
 Receive a timing request from the peer. More...
 
- Protected Member Functions inherited from FunctionalResponseProtocol
void sendSnoop (FunctionalRequestProtocol *peer, PacketPtr pkt) const
 Send a functional snoop request packet, where the data is instantly updated everywhere in the memory system, without affecting the current state of any block or moving the block. More...
 
virtual void recvFunctional (PacketPtr pkt)=0
 Receive a functional request packet from the peer. More...
 

Protected Attributes

RespPacketQueue queue
 A normal packet queue used to store responses. More...
 
bool blocked
 
bool mustSendRetry
 
- Protected Attributes inherited from QueuedResponsePort
RespPacketQueuerespQueue
 Packet queue used to store outgoing responses. More...
 
- Protected Attributes inherited from ResponsePort
SimObjectowner
 
- Protected Attributes inherited from Port
const PortID id
 A numeric identifier to distinguish ports in a vector, and set to InvalidPortID in case this port is not part of a vector. More...
 
Port_peer
 A pointer to this port's peer. More...
 
bool _connected
 Whether this port is currently connected to a peer port. More...
 

Private Member Functions

void processSendRetry ()
 

Private Attributes

EventFunctionWrapper sendRetryEvent
 

Detailed Description

A cache response port is used for the CPU-side port of the cache, and it is basically a simple timing port that uses a transmit list for responses to the CPU (or connected requestor).

In addition, it has the functionality to block the port for incoming requests. If blocked, the port will issue a retry once unblocked.

Definition at line 244 of file base.hh.

Constructor & Destructor Documentation

◆ CacheResponsePort()

BaseCache::CacheResponsePort::CacheResponsePort ( const std::string &  _name,
BaseCache _cache,
const std::string &  _label 
)
protected

Definition at line 66 of file base.cc.

References processSendRetry().

Member Function Documentation

◆ clearBlocked()

void BaseCache::CacheResponsePort::clearBlocked ( )

Return to normal operation and accept new requests.

Definition at line 147 of file base.cc.

References BaseCache::blocked, curTick(), and DPRINTF.

Referenced by BaseCache::clearBlocked().

◆ isBlocked()

bool BaseCache::CacheResponsePort::isBlocked ( ) const
inline

Definition at line 255 of file base.hh.

References blocked.

◆ processSendRetry()

void BaseCache::CacheResponsePort::processSendRetry ( )
private

Definition at line 159 of file base.cc.

References DPRINTF.

Referenced by CacheResponsePort().

◆ setBlocked()

void BaseCache::CacheResponsePort::setBlocked ( )

Do not accept any new requests.

Definition at line 132 of file base.cc.

References blocked, EventManager::deschedule(), DPRINTF, mustSendRetry, ResponsePort::owner, Event::scheduled(), and sendRetryEvent.

Referenced by BaseCache::setBlocked().

Member Data Documentation

◆ blocked

bool BaseCache::CacheResponsePort::blocked
protected

Definition at line 265 of file base.hh.

Referenced by isBlocked(), and setBlocked().

◆ mustSendRetry

bool BaseCache::CacheResponsePort::mustSendRetry
protected

Definition at line 267 of file base.hh.

Referenced by setBlocked().

◆ queue

RespPacketQueue BaseCache::CacheResponsePort::queue
protected

A normal packet queue used to store responses.

Definition at line 263 of file base.hh.

◆ sendRetryEvent

EventFunctionWrapper BaseCache::CacheResponsePort::sendRetryEvent
private

Definition at line 273 of file base.hh.

Referenced by setBlocked().


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

Generated on Wed Sep 30 2020 14:02:21 for gem5 by doxygen 1.8.17