gem5
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Friends Macros Groups Pages
Public Member Functions | Protected Types | Protected Member Functions | Protected Attributes | Private Member Functions | Private Attributes | List of all members
BaseArmKvmCPU Class Reference

#include <base_cpu.hh>

Inheritance diagram for BaseArmKvmCPU:
BaseKvmCPU BaseCPU ArmV8KvmCPU

Public Member Functions

 BaseArmKvmCPU (BaseArmKvmCPUParams *params)
 
virtual ~BaseArmKvmCPU ()
 
void startup () override
 
- Public Member Functions inherited from BaseKvmCPU
 BaseKvmCPU (BaseKvmCPUParams *params)
 
virtual ~BaseKvmCPU ()
 
void init () override
 
void startup () override
 
void regStats () override
 
void serializeThread (CheckpointOut &cp, ThreadID tid) const override
 
void unserializeThread (CheckpointIn &cp, ThreadID tid) override
 
DrainState drain () override
 
void drainResume () override
 
void notifyFork () override
 
void switchOut () override
 
void takeOverFrom (BaseCPU *cpu) override
 
void verifyMemoryMode () const override
 
MasterPortgetDataPort () override
 
MasterPortgetInstPort () override
 
void wakeup (ThreadID tid=0) override
 
void activateContext (ThreadID thread_num) override
 
void suspendContext (ThreadID thread_num) override
 
void deallocateContext (ThreadID thread_num)
 
void haltContext (ThreadID thread_num) override
 
long getVCpuID () const
 
ThreadContextgetContext (int tn) override
 
Counter totalInsts () const override
 
Counter totalOps () const override
 
void finishMMIOPending ()
 Callback from KvmCPUPort to transition the CPU out of RunningMMIOPending when all timing requests have completed. More...
 
virtual void dump () const
 Dump the internal state to the terminal. More...
 
void kick () const
 Force an exit from KVM. More...
 

Protected Types

typedef std::vector< uint64_t > RegIndexVector
 
- Protected Types inherited from BaseKvmCPU
enum  Status {
  Idle, Running, RunningService, RunningMMIOPending,
  RunningServiceCompletion
}
 

Protected Member Functions

Tick kvmRun (Tick ticks) override
 Request KVM to run the guest for a given number of ticks. More...
 
const RegIndexVectorgetRegList () const
 Get a list of registers supported by getOneReg() and setOneReg(). More...
 
void kvmArmVCpuInit (const struct kvm_vcpu_init &init)
 Tell the kernel to initialize this CPU. More...
 
- Protected Member Functions inherited from BaseKvmCPU
void tick ()
 Execute the CPU until the next event in the main event queue or until the guest needs service from gem5. More...
 
virtual uint64_t getHostCycles () const
 Get the value of the hardware cycle counter in the guest. More...
 
virtual Tick kvmRunDrain ()
 Request the CPU to run until draining completes. More...
 
struct kvm_run * getKvmRunState ()
 Get a pointer to the kvm_run structure containing all the input and output parameters from kvmRun(). More...
 
uint8_t * getGuestData (uint64_t offset) const
 Retrieve a pointer to guest data stored at the end of the kvm_run structure. More...
 
void kvmNonMaskableInterrupt ()
 Send a non-maskable interrupt to the guest. More...
 
void kvmInterrupt (const struct kvm_interrupt &interrupt)
 Send a normal interrupt to the guest. More...
 
std::string getAndFormatOneReg (uint64_t id) const
 Get and format one register for printout. More...
 
virtual bool archIsDrained () const
 Is the architecture specific code in a state that prevents draining? More...
 
Tick doMMIOAccess (Addr paddr, void *data, int size, bool write)
 Inject a memory mapped IO request into gem5. More...
 
int ioctl (int request, long p1) const
 vCPU ioctl interface. More...
 
int ioctl (int request, void *p1) const
 
int ioctl (int request) const
 
void getRegisters (struct kvm_regs &regs) const
 Get/Set the register state of the guest vCPU. More...
 
void setRegisters (const struct kvm_regs &regs)
 
void getSpecialRegisters (struct kvm_sregs &regs) const
 
void setSpecialRegisters (const struct kvm_sregs &regs)
 
void getFPUState (struct kvm_fpu &state) const
 Get/Set the guest FPU/vector state. More...
 
void setFPUState (const struct kvm_fpu &state)
 
void setOneReg (uint64_t id, const void *addr)
 Get/Set single register using the KVM_(SET|GET)_ONE_REG API. More...
 
void setOneReg (uint64_t id, uint64_t value)
 
void setOneReg (uint64_t id, uint32_t value)
 
void getOneReg (uint64_t id, void *addr) const
 
uint64_t getOneRegU64 (uint64_t id) const
 
uint32_t getOneRegU32 (uint64_t id) const
 
virtual void updateKvmState ()=0
 Update the KVM state from the current thread context. More...
 
virtual void updateThreadContext ()=0
 Update the current thread context with the KVM state. More...
 
void syncThreadContext ()
 Update a thread context if the KVM state is dirty with respect to the cached thread context. More...
 
void syncKvmState ()
 Update the KVM if the thread context is dirty. More...
 
virtual Tick handleKvmExit ()
 Main kvmRun exit handler, calls the relevant handleKvmExit* depending on exit type. More...
 
virtual Tick handleKvmExitIO ()
 The guest performed a legacy IO request (out/inp on x86) More...
 
virtual Tick handleKvmExitHypercall ()
 The guest requested a monitor service using a hypercall. More...
 
virtual Tick handleKvmExitIRQWindowOpen ()
 The guest exited because an interrupt window was requested. More...
 
virtual Tick handleKvmExitUnknown ()
 An unknown architecture dependent error occurred when starting the vCPU. More...
 
virtual Tick handleKvmExitException ()
 An unhandled virtualization exception occured. More...
 
virtual Tick handleKvmExitFailEntry ()
 KVM failed to start the virtualized CPU. More...
 
void setSignalMask (const sigset_t *mask)
 Set the signal mask used in kvmRun() More...
 

Protected Attributes

bool irqAsserted
 Cached state of the IRQ line. More...
 
bool fiqAsserted
 Cached state of the FIQ line. More...
 
- Protected Attributes inherited from BaseKvmCPU
Status _status
 CPU run state. More...
 
KVMCpuPort dataPort
 Port for data requests. More...
 
KVMCpuPort instPort
 Unused dummy port for the instruction interface. More...
 
const bool alwaysSyncTC
 Be conservative and always synchronize the thread context on KVM entry/exit. More...
 
bool threadContextDirty
 Is the gem5 context dirty? Set to true to force an update of the KVM vCPU state upon the next call to kvmRun(). More...
 
bool kvmStateDirty
 Is the KVM state dirty? Set to true to force an update of the KVM vCPU state upon the next call to kvmRun(). More...
 
const long vcpuID
 KVM internal ID of the vCPU. More...
 
pthread_t vcpuThread
 ID of the vCPU thread. More...
 

Private Member Functions

std::unique_ptr< struct
kvm_reg_list > 
tryGetRegList (uint64_t nelem) const
 
bool getRegList (struct kvm_reg_list &regs) const
 Get a list of registers supported by getOneReg() and setOneReg(). More...
 

Private Attributes

RegIndexVector _regIndexList
 Cached copy of the list of registers supported by KVM. More...
 

Additional Inherited Members

- Static Public Member Functions inherited from BaseCPU
static int numSimulatedInsts ()
 
static int numSimulatedOps ()
 
static void wakeup (ThreadID tid)
 
- Public Attributes inherited from BaseKvmCPU
SimpleThreadthread
 A cached copy of a thread's state in the form of a SimpleThread object. More...
 
ThreadContexttc
 ThreadContext object, provides an interface for external objects to modify this thread's state. More...
 
KvmVMvm
 
Counter ctrInsts
 Number of instructions executed by the CPU. More...
 
Stats::Scalar numInsts
 
Stats::Scalar numVMExits
 
Stats::Scalar numVMHalfEntries
 
Stats::Scalar numExitSignal
 
Stats::Scalar numMMIO
 
Stats::Scalar numCoalescedMMIO
 
Stats::Scalar numIO
 
Stats::Scalar numHalt
 
Stats::Scalar numInterrupts
 
Stats::Scalar numHypercalls
 

Detailed Description

Definition at line 49 of file base_cpu.hh.

Member Typedef Documentation

typedef std::vector<uint64_t> BaseArmKvmCPU::RegIndexVector
protected

Definition at line 67 of file base_cpu.hh.

Constructor & Destructor Documentation

BaseArmKvmCPU::BaseArmKvmCPU ( BaseArmKvmCPUParams *  params)

Definition at line 59 of file base_cpu.cc.

BaseArmKvmCPU::~BaseArmKvmCPU ( )
virtual

Definition at line 65 of file base_cpu.cc.

Member Function Documentation

const BaseArmKvmCPU::RegIndexVector & BaseArmKvmCPU::getRegList ( ) const
protected

Get a list of registers supported by getOneReg() and setOneReg().

This method returns a list of all registers supported by kvm. The actual list is only requested the first time this method is called. Subsequent calls return a cached copy of the register list.

Returns
Vector of register indexes.

Definition at line 109 of file base_cpu.cc.

References _regIndexList, panic, and X86ISA::size().

Referenced by ArmV8KvmCPU::dump(), and ArmV8KvmCPU::getSysRegMap().

bool BaseArmKvmCPU::getRegList ( struct kvm_reg_list &  regs) const
private

Get a list of registers supported by getOneReg() and setOneReg().

Returns
False if the number of elements allocated in the list is too small to hold the complete register list (the required size is written to regs.n in this case). True on success.

Definition at line 144 of file base_cpu.cc.

References BaseKvmCPU::ioctl(), and panic.

void BaseArmKvmCPU::kvmArmVCpuInit ( const struct kvm_vcpu_init &  init)
protected

Tell the kernel to initialize this CPU.

The kernel needs to know what type of the CPU that we want to emulate. The specified CPU type has to be compatible with the host CPU. In practice, we usually call KvmVM::kvmArmPreferredTarget() to discover the host CPU.

Parameters
targetCPU type to emulate

Definition at line 137 of file base_cpu.cc.

References BaseKvmCPU::ioctl(), and panic.

Referenced by startup().

Tick BaseArmKvmCPU::kvmRun ( Tick  ticks)
overrideprotectedvirtual

Request KVM to run the guest for a given number of ticks.

The method returns the approximate number of ticks executed.

Note
The returned number of ticks can be both larger or smaller than the requested number of ticks. A smaller number can, for example, occur when the guest executes MMIO. A larger number is typically due to performance counter inaccuracies.
This method is virtual in order to allow implementations to check for architecture specific events (e.g., interrupts) before entering the VM.
It is the response of the caller (normally tick()) to make sure that the KVM state is synchronized and that the TC is invalidated after entering KVM.
This method does not normally cause any state transitions. However, if it may suspend the CPU by suspending the thread, which leads to a transition to the Idle state. In such a case, kvm must not be entered.
Parameters
ticksNumber of ticks to execute, set to 0 to exit immediately after finishing pending operations.
Returns
Number of ticks executed (see note)

Reimplemented from BaseKvmCPU.

Definition at line 89 of file base_cpu.cc.

References DPRINTF, fiqAsserted, ArmISA::INT_FIQ, ArmISA::INT_IRQ, INTERRUPT_VCPU_FIQ, INTERRUPT_VCPU_IRQ, irqAsserted, BaseKvmCPU::kvmRun(), KvmVM::setIRQLine(), BaseKvmCPU::vcpuID, and BaseKvmCPU::vm.

void BaseArmKvmCPU::startup ( )
override

Definition at line 70 of file base_cpu.cc.

References kvmArmVCpuInit(), BaseKvmCPU::startup(), ArmISA::system, and BaseKvmCPU::vm.

Referenced by ArmV8KvmCPU::startup().

std::unique_ptr<struct kvm_reg_list> BaseArmKvmCPU::tryGetRegList ( uint64_t  nelem) const
private

Member Data Documentation

RegIndexVector BaseArmKvmCPU::_regIndexList
mutableprivate

Cached copy of the list of registers supported by KVM.

Definition at line 108 of file base_cpu.hh.

Referenced by getRegList().

bool BaseArmKvmCPU::fiqAsserted
protected

Cached state of the FIQ line.

Definition at line 64 of file base_cpu.hh.

Referenced by kvmRun().

bool BaseArmKvmCPU::irqAsserted
protected

Cached state of the IRQ line.

Definition at line 62 of file base_cpu.hh.

Referenced by kvmRun().


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

Generated on Fri Jun 9 2017 13:04:02 for gem5 by doxygen 1.8.6