gem5  v20.1.0.0
Public Member Functions | Protected Member Functions | Protected Attributes | List of all members
BaseKvmCPU::KVMCpuPort Class Reference

KVM memory port. More...

#include <base.hh>

Inheritance diagram for BaseKvmCPU::KVMCpuPort:
RequestPort Port AtomicRequestProtocol TimingRequestProtocol FunctionalRequestProtocol

Public Member Functions

 KVMCpuPort (const std::string &_name, BaseKvmCPU *_cpu)
 
Tick submitIO (PacketPtr pkt)
 Interface to send Atomic or Timing IO request. More...
 
Status nextIOState () const
 Returns next valid state after one or more IO accesses. More...
 
- Public Member Functions inherited from RequestPort
 RequestPort (const std::string &name, SimObject *_owner, PortID id=InvalidPortID)
 Request port. More...
 
virtual ~RequestPort ()
 
void bind (Port &peer) override
 Bind this request port to a response port. More...
 
void unbind () override
 Unbind this request port and the associated response port. More...
 
virtual bool isSnooping () const
 Determine if this request port is snooping or not. More...
 
AddrRangeList getAddrRanges () const
 Get the address ranges of the connected responder port. More...
 
void printAddr (Addr a)
 Inject a PrintReq for the given address to print the state of that address throughout the memory system. More...
 
Tick sendAtomic (PacketPtr pkt)
 Send an atomic request packet, where the data is moved and the state is updated in zero time, without interleaving with other memory accesses. More...
 
Tick sendAtomicBackdoor (PacketPtr pkt, MemBackdoorPtr &backdoor)
 Send an atomic request packet like above, but also request a backdoor to the data being accessed. More...
 
void sendFunctional (PacketPtr pkt) const
 Send a functional 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 sendTimingReq (PacketPtr pkt)
 Attempt to send a timing request to the responder port by calling its corresponding receive function. More...
 
bool tryTiming (PacketPtr pkt) const
 Check if the responder can handle a timing request. More...
 
bool sendTimingSnoopResp (PacketPtr pkt)
 Attempt to send a timing snoop response packet to the response port by calling its corresponding receive function. More...
 
virtual void sendRetryResp ()
 Send a retry to the response port that previously attempted a sendTimingResp to this request 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

bool recvTimingResp (PacketPtr pkt) override
 Receive a timing response from the peer. More...
 
void recvReqRetry () override
 Called by the peer if sendTimingReq was called on this peer (causing recvTimingReq to be called on the peer) and was unsuccessful. More...
 
- Protected Member Functions inherited from RequestPort
virtual void recvRangeChange ()
 Called to receive an address range change from the peer response port. More...
 
Tick recvAtomicSnoop (PacketPtr pkt) override
 Default implementations. More...
 
void recvFunctionalSnoop (PacketPtr pkt) override
 Receive a functional snoop request packet from the peer. More...
 
void recvTimingSnoopReq (PacketPtr pkt) override
 Receive a timing snoop request from the peer. More...
 
void recvRetrySnoopResp () override
 Called by the peer if sendTimingSnoopResp was called on this protocol (causing recvTimingSnoopResp to be called on the peer) and was unsuccessful. 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 AtomicRequestProtocol
Tick send (AtomicResponseProtocol *peer, PacketPtr pkt)
 Send an atomic request packet, where the data is moved and the state is updated in zero time, without interleaving with other memory accesses. More...
 
Tick sendBackdoor (AtomicResponseProtocol *peer, PacketPtr pkt, MemBackdoorPtr &backdoor)
 Send an atomic request packet like above, but also request a backdoor to the data being accessed. More...
 
- Protected Member Functions inherited from TimingRequestProtocol
bool sendReq (TimingResponseProtocol *peer, PacketPtr pkt)
 Attempt to send a timing request to the peer by calling its corresponding receive function. More...
 
bool trySend (TimingResponseProtocol *peer, PacketPtr pkt) const
 Check if the peer can handle a timing request. More...
 
bool sendSnoopResp (TimingResponseProtocol *peer, PacketPtr pkt)
 Attempt to send a timing snoop response packet to it's peer by calling its corresponding receive function. More...
 
void sendRetryResp (TimingResponseProtocol *peer)
 Send a retry to the peer that previously attempted a sendTimingResp to this protocol and failed. More...
 
- Protected Member Functions inherited from FunctionalRequestProtocol
void send (FunctionalResponseProtocol *peer, PacketPtr pkt) const
 Send a functional 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...
 

Protected Attributes

BaseKvmCPUcpu
 KVM cpu pointer for finishMMIOPending() callback. More...
 
std::queue< PacketPtrpendingMMIOPkts
 Pending MMIO packets. More...
 
unsigned int activeMMIOReqs
 Number of MMIO requests in flight. More...
 
- Protected Attributes inherited from RequestPort
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...
 

Detailed Description

KVM memory port.

Uses default RequestPort behavior and provides an interface for KVM to transparently submit atomic or timing requests.

Definition at line 577 of file base.hh.

Constructor & Destructor Documentation

◆ KVMCpuPort()

BaseKvmCPU::KVMCpuPort::KVMCpuPort ( const std::string &  _name,
BaseKvmCPU _cpu 
)
inline

Definition at line 581 of file base.hh.

Member Function Documentation

◆ nextIOState()

BaseKvmCPU::Status BaseKvmCPU::KVMCpuPort::nextIOState ( ) const

Returns next valid state after one or more IO accesses.

Definition at line 164 of file base.cc.

References activeMMIOReqs, pendingMMIOPkts, BaseKvmCPU::RunningMMIOPending, and BaseKvmCPU::RunningServiceCompletion.

Referenced by BaseKvmCPU::handleKvmExit().

◆ recvReqRetry()

void BaseKvmCPU::KVMCpuPort::recvReqRetry ( )
overrideprotectedvirtual

Called by the peer if sendTimingReq was called on this peer (causing recvTimingReq to be called on the peer) and was unsuccessful.

Implements TimingRequestProtocol.

Definition at line 206 of file base.cc.

References DPRINTF.

◆ recvTimingResp()

bool BaseKvmCPU::KVMCpuPort::recvTimingResp ( PacketPtr  pkt)
overrideprotectedvirtual

Receive a timing response from the peer.

Implements TimingRequestProtocol.

Definition at line 189 of file base.cc.

References DPRINTF.

◆ submitIO()

Tick BaseKvmCPU::KVMCpuPort::submitIO ( PacketPtr  pkt)

Interface to send Atomic or Timing IO request.

Assumes that the pkt and corresponding req have been dynamically allocated and deletes them both if the system is in atomic mode.

Definition at line 171 of file base.cc.

Referenced by BaseKvmCPU::doMMIOAccess(), and X86KvmCPU::handleKvmExitIO().

Member Data Documentation

◆ activeMMIOReqs

unsigned int BaseKvmCPU::KVMCpuPort::activeMMIOReqs
protected

Number of MMIO requests in flight.

Definition at line 602 of file base.hh.

Referenced by nextIOState().

◆ cpu

BaseKvmCPU* BaseKvmCPU::KVMCpuPort::cpu
protected

KVM cpu pointer for finishMMIOPending() callback.

Definition at line 596 of file base.hh.

◆ pendingMMIOPkts

std::queue<PacketPtr> BaseKvmCPU::KVMCpuPort::pendingMMIOPkts
protected

Pending MMIO packets.

Definition at line 599 of file base.hh.

Referenced by nextIOState().


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