gem5
v21.2.1.1
|
ARM implementation of a KVM-based hardware virtualized CPU. More...
#include <arm_cpu.hh>
Classes | |
struct | KvmCoreMiscRegInfo |
struct | KvmIntRegInfo |
Public Member Functions | |
ArmKvmCPU (const ArmKvmCPUParams ¶ms) | |
virtual | ~ArmKvmCPU () |
void | startup () |
void | dump () |
![]() | |
BaseKvmCPU (const BaseKvmCPUParams ¶ms) | |
virtual | ~BaseKvmCPU () |
void | init () override |
void | startup () 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 |
Port & | getDataPort () override |
Port & | getInstPort () 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 |
ThreadContext * | getContext (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 |
![]() | |
enum | Status { Idle, Running, RunningService, RunningMMIOPending, RunningServiceCompletion } |
Protected Member Functions | |
Tick | kvmRun (Tick ticks) |
Request KVM to run the guest for a given number of ticks. More... | |
void | updateKvmState () |
Update the KVM state from the current thread context. More... | |
void | updateThreadContext () |
Update the current thread context with the KVM state. More... | |
void | stutterPC (PCStateBase &pc) const |
Modify a PCStatePtr's value so that its next PC is the current PC. More... | |
const RegIndexVector & | getRegList () const |
Get a list of registers supported by getOneReg() and setOneReg(). More... | |
void | kvmArmVCpuInit (uint32_t target) |
void | kvmArmVCpuInit (const struct kvm_vcpu_init &init) |
ArmISA::MiscRegIndex | decodeCoProcReg (uint64_t id) const |
ArmISA::MiscRegIndex | decodeVFPCtrlReg (uint64_t id) const |
bool | isInvariantReg (uint64_t id) |
Determine if a register is invariant. More... | |
![]() | |
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 |
virtual void | ioctlRun () |
Execute the KVM_RUN ioctl. More... | |
void | getRegisters (struct kvm_regs ®s) const |
Get/Set the register state of the guest vCPU. More... | |
void | setRegisters (const struct kvm_regs ®s) |
void | getSpecialRegisters (struct kvm_sregs ®s) const |
void | setSpecialRegisters (const struct kvm_sregs ®s) |
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 |
void | syncThreadContext () |
Update a thread context if the KVM state is dirty with respect to the cached thread context. More... | |
EventQueue * | deviceEventQueue () |
Get a pointer to the event queue owning devices. 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... | |
Static Protected Attributes | |
static KvmIntRegInfo | kvmIntRegs [] |
static KvmCoreMiscRegInfo | kvmCoreMiscRegs [] |
Private Member Functions | |
bool | getRegList (struct kvm_reg_list ®s) const |
Get a list of registers supported by getOneReg() and setOneReg(). More... | |
void | dumpKvmStateCore () |
void | dumpKvmStateMisc () |
void | dumpKvmStateCoProc (uint64_t id) |
void | dumpKvmStateVFP (uint64_t id) |
void | updateKvmStateCore () |
void | updateKvmStateMisc () |
void | updateKvmStateCoProc (uint64_t id, bool show_warnings) |
void | updateKvmStateVFP (uint64_t id, bool show_warnings) |
void | updateTCStateCore () |
void | updateTCStateMisc () |
void | updateTCStateCoProc (uint64_t id, bool show_warnings) |
void | updateTCStateVFP (uint64_t id, bool show_warnings) |
Private Attributes | |
bool | irqAsserted |
Cached state of the IRQ line. More... | |
bool | fiqAsserted |
Cached state of the FIQ line. More... | |
RegIndexVector | _regIndexList |
Cached copy of the list of co-processor registers supported by KVM. More... | |
Static Private Attributes | |
static const std::set< uint64_t > | invariant_regs |
List of co-processor registers that KVM requires to be identical on both the host and the guest. More... | |
Additional Inherited Members | |
![]() | |
SimpleThread * | thread |
A cached copy of a thread's state in the form of a SimpleThread object. More... | |
ThreadContext * | tc |
ThreadContext object, provides an interface for external objects to modify this thread's state. More... | |
KvmVM & | vm |
gem5::BaseKvmCPU::StatGroup | stats |
Counter | ctrInsts |
Number of instructions executed by the CPU. More... | |
![]() | |
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... | |
ARM implementation of a KVM-based hardware virtualized CPU.
Architecture specific limitations:
Definition at line 63 of file arm_cpu.hh.
|
protected |
Definition at line 94 of file arm_cpu.hh.
gem5::ArmKvmCPU::ArmKvmCPU | ( | const ArmKvmCPUParams & | params | ) |
Definition at line 342 of file arm_cpu.cc.
|
virtual |
Definition at line 348 of file arm_cpu.cc.
|
protected |
Definition at line 455 of file arm_cpu.cc.
References gem5::ArmISA::decodeCP14Reg(), gem5::ArmISA::decodeCP15Reg(), gem5::ArmISA::NUM_MISCREGS, gem5::ArmISA::opc2, and warn.
Referenced by dumpKvmStateCoProc(), updateKvmStateCoProc(), and updateTCStateCoProc().
|
protected |
Definition at line 490 of file arm_cpu.cc.
References gem5::ArmISA::MISCREG_FPEXC, gem5::ArmISA::MISCREG_FPSCR, gem5::ArmISA::MISCREG_FPSID, gem5::ArmISA::MISCREG_MVFR0, gem5::ArmISA::MISCREG_MVFR1, gem5::ArmISA::NUM_MISCREGS, and warn_once.
Referenced by dumpKvmStateVFP(), updateKvmStateVFP(), and updateTCStateVFP().
void gem5::ArmKvmCPU::dump | ( | ) |
Definition at line 389 of file arm_cpu.cc.
References dumpKvmStateCore(), and dumpKvmStateMisc().
|
private |
Definition at line 599 of file arm_cpu.cc.
References decodeCoProcReg(), gem5::BaseKvmCPU::getAndFormatOneReg(), gem5::BaseKvmCPU::getOneRegU32(), inform, isInvariantReg(), gem5::ArmISA::miscRegName, name(), gem5::ArmISA::NUM_MISCREGS, gem5::ThreadContext::readMiscReg(), gem5::ThreadContext::readMiscRegNoEffect(), and gem5::BaseKvmCPU::tc.
Referenced by dumpKvmStateMisc().
|
private |
Definition at line 541 of file arm_cpu.cc.
References gem5::BaseKvmCPU::getOneRegU32(), inform, kvmCoreMiscRegs, kvmIntRegs, gem5::ArmISA::miscRegName, gem5::ArmISA::NUM_MISCREGS, gem5::MipsISA::pc, and gem5::PowerISA::ri.
Referenced by dump(), updateKvmStateCore(), and updateTCStateCore().
|
private |
Definition at line 563 of file arm_cpu.cc.
References dumpKvmStateCoProc(), dumpKvmStateVFP(), gem5::BaseKvmCPU::getAndFormatOneReg(), getRegList(), and inform.
Referenced by dump(), updateKvmStateMisc(), and updateTCStateMisc().
|
private |
Definition at line 641 of file arm_cpu.cc.
References decodeVFPCtrlReg(), gem5::BaseKvmCPU::getAndFormatOneReg(), inform, gem5::ArmISA::miscRegName, and gem5::ArmISA::NUM_MISCREGS.
Referenced by dumpKvmStateMisc().
|
protected |
Get a list of registers supported by getOneReg() and setOneReg().
Definition at line 414 of file arm_cpu.cc.
References _regIndexList, gem5::ArmISA::i, and gem5::MipsISA::p.
Referenced by dumpKvmStateMisc(), updateKvmStateMisc(), and updateTCStateMisc().
|
private |
Get a list of registers supported by getOneReg() and setOneReg().
Definition at line 526 of file arm_cpu.cc.
References gem5::BaseKvmCPU::ioctl(), and panic.
|
protected |
Determine if a register is invariant.
Some registers must have the same value in both the host and the guest. Such registers are referred to as "invariant" registers in KVM. This is a restriction imposed by KVM as having different values in ID registers (e.g., the cache identification registers) would confuse the guest kernel.
Definition at line 514 of file arm_cpu.cc.
References invariant_regs.
Referenced by dumpKvmStateCoProc(), and updateKvmStateMisc().
|
protected |
Definition at line 448 of file arm_cpu.cc.
References gem5::BaseKvmCPU::init(), gem5::BaseKvmCPU::ioctl(), and panic.
|
protected |
Definition at line 436 of file arm_cpu.cc.
References gem5::BaseKvmCPU::init().
Referenced by startup().
Request KVM to run the guest for a given number of ticks.
The method returns the approximate number of ticks executed.
ticks | Number of ticks to execute, set to 0 to exit immediately after finishing pending operations. |
Reimplemented from gem5::BaseKvmCPU.
Definition at line 368 of file arm_cpu.cc.
References gem5::ArmISA::Interrupts::checkRaw(), DPRINTF, fiqAsserted, gem5::ArmISA::INT_FIQ, gem5::ArmISA::INT_IRQ, irqAsserted, gem5::BaseKvmCPU::kvmRun(), gem5::KvmVM::setIRQLine(), gem5::BaseKvmCPU::vcpuID, and gem5::BaseKvmCPU::vm.
void gem5::ArmKvmCPU::startup | ( | ) |
Definition at line 353 of file arm_cpu.cc.
References kvmArmVCpuInit(), and gem5::BaseKvmCPU::startup().
|
inlineprotectedvirtual |
Modify a PCStatePtr's value so that its next PC is the current PC.
This needs to be implemented in KVM base classes since modifying the next PC value is an ISA specific operation. This is only used in doMMIOAccess, for reasons explained in a comment there.
Implements gem5::BaseKvmCPU.
Definition at line 101 of file arm_cpu.hh.
References gem5::MipsISA::pc.
|
protectedvirtual |
Update the KVM state from the current thread context.
The base CPU calls this method before starting the guest CPU when the contextDirty flag is set. The architecture dependent CPU implementation is expected to update all guest state (registers, special registers, and FPU state).
Implements gem5::BaseKvmCPU.
Definition at line 396 of file arm_cpu.cc.
References DPRINTF, updateKvmStateCore(), and updateKvmStateMisc().
|
private |
Definition at line 726 of file arm_cpu.cc.
References decodeCoProcReg(), hack, gem5::KVM_REG64_TTBR0(), gem5::KVM_REG64_TTBR1(), gem5::ArmISA::MISCREG_TTBR0, gem5::ArmISA::MISCREG_TTBR1, gem5::ArmISA::miscRegName, gem5::ArmISA::NUM_MISCREGS, gem5::ThreadContext::readMiscRegNoEffect(), gem5::X86ISA::reg, gem5::BaseKvmCPU::setOneReg(), gem5::BaseKvmCPU::tc, and warn.
Referenced by updateKvmStateMisc().
|
private |
Definition at line 662 of file arm_cpu.cc.
References DPRINTF, dumpKvmStateCore(), gem5::PCStateBase::instAddr(), kvmCoreMiscRegs, kvmIntRegs, gem5::ArmISA::NUM_MISCREGS, gem5::ThreadContext::pcState(), gem5::ThreadContext::readIntRegFlat(), gem5::ThreadContext::readMiscReg(), gem5::PowerISA::ri, gem5::BaseKvmCPU::setOneReg(), and gem5::BaseKvmCPU::tc.
Referenced by updateKvmState().
|
private |
Definition at line 688 of file arm_cpu.cc.
References DPRINTF, dumpKvmStateMisc(), getRegList(), isInvariantReg(), updateKvmStateCoProc(), updateKvmStateVFP(), and warn.
Referenced by updateKvmState().
|
private |
Definition at line 760 of file arm_cpu.cc.
References decodeVFPCtrlReg(), gem5::ArmISA::miscRegName, gem5::ArmISA::NUM_MISCREGS, gem5::ThreadContext::readFloatRegFlat(), gem5::ThreadContext::readMiscReg(), gem5::BaseKvmCPU::setOneReg(), gem5::BaseKvmCPU::tc, and warn.
Referenced by updateKvmStateMisc().
|
private |
Definition at line 865 of file arm_cpu.cc.
References decodeCoProcReg(), gem5::BaseKvmCPU::getOneRegU32(), gem5::BaseKvmCPU::getOneRegU64(), hack_once, gem5::KVM_REG64_TTBR0(), gem5::KVM_REG64_TTBR1(), gem5::ArmISA::MISCREG_TTBCR, gem5::ArmISA::MISCREG_TTBR0, gem5::ArmISA::MISCREG_TTBR1, gem5::ArmISA::miscRegName, gem5::ArmISA::NUM_MISCREGS, panic, gem5::X86ISA::reg, gem5::ThreadContext::setMiscRegNoEffect(), gem5::BaseKvmCPU::tc, warn, and warn_once.
Referenced by updateTCStateMisc().
|
private |
Definition at line 802 of file arm_cpu.cc.
References gem5::PCStateBase::as(), dumpKvmStateCore(), gem5::BaseKvmCPU::getOneRegU32(), kvmCoreMiscRegs, kvmIntRegs, gem5::ArmISA::MISCREG_CPSR, gem5::ArmISA::NUM_MISCREGS, gem5::MipsISA::pc, gem5::ThreadContext::pcState(), gem5::ThreadContext::readMiscRegNoEffect(), gem5::PowerISA::ri, gem5::ThreadContext::setIntRegFlat(), gem5::ThreadContext::setMiscReg(), gem5::ThreadContext::setMiscRegNoEffect(), and gem5::BaseKvmCPU::tc.
Referenced by updateThreadContext().
|
private |
Definition at line 832 of file arm_cpu.cc.
References dumpKvmStateMisc(), getRegList(), updateTCStateCoProc(), updateTCStateVFP(), and warn.
Referenced by updateThreadContext().
|
private |
Definition at line 901 of file arm_cpu.cc.
References decodeVFPCtrlReg(), gem5::BaseKvmCPU::getOneRegU64(), gem5::ArmISA::miscRegName, gem5::ArmISA::NUM_MISCREGS, gem5::ThreadContext::setFloatRegFlat(), gem5::ThreadContext::setMiscReg(), gem5::BaseKvmCPU::tc, and warn.
Referenced by updateTCStateMisc().
|
protectedvirtual |
Update the current thread context with the KVM state.
The base CPU after the guest updates any of the KVM state. In practice, this happens after kvmRun is called. The architecture dependent code is expected to read the state of the guest CPU and update gem5's thread state.
Implements gem5::BaseKvmCPU.
Definition at line 405 of file arm_cpu.cc.
References DPRINTF, updateTCStateCore(), and updateTCStateMisc().
|
mutableprivate |
Cached copy of the list of co-processor registers supported by KVM.
Definition at line 167 of file arm_cpu.hh.
Referenced by getRegList().
|
private |
|
staticprivate |
List of co-processor registers that KVM requires to be identical on both the host and the guest.
KVM does not allow writes to these registers.
Definition at line 174 of file arm_cpu.hh.
Referenced by isInvariantReg().
|
private |
|
staticprotected |
Definition at line 130 of file arm_cpu.hh.
Referenced by dumpKvmStateCore(), updateKvmStateCore(), and updateTCStateCore().
|
staticprotected |
Definition at line 129 of file arm_cpu.hh.
Referenced by dumpKvmStateCore(), updateKvmStateCore(), and updateTCStateCore().