#include <base_cpu.hh>

Inheritance diagram for BaseArmKvmCPU:

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	serializeThread (CheckpointOut &cp, ThreadID tid) const override
	Serialize a single thread. More...

void	unserializeThread (CheckpointIn &cp, ThreadID tid) override
	Unserialize one thread. More...

DrainState	drain () override

void	drainResume () override

void	notifyFork () override

void	switchOut () override
	Prepare for another CPU to take over execution. More...

void	takeOverFrom (BaseCPU *cpu) override
	Load the state of a CPU from the previous CPU object, invoked on all new CPUs that are about to be switched in. More...

void	verifyMemoryMode () const override
	Verify that the system is in a memory mode supported by the CPU. More...

Port &	getDataPort () override
	Purely virtual method that returns a reference to the data port. More...

Port &	getInstPort () override
	Purely virtual method that returns a reference to the instruction port. More...

void	wakeup (ThreadID tid=0) override

void	activateContext (ThreadID thread_num) override
	Notify the CPU that the indicated context is now active. More...

void	suspendContext (ThreadID thread_num) override
	Notify the CPU that the indicated context is now suspended. More...

void	deallocateContext (ThreadID thread_num)

void	haltContext (ThreadID thread_num) override
	Notify the CPU that the indicated context is now halted. More...

long	getVCpuID () const

ThreadContext *	getContext (int tn) override
	Given a thread num get tho thread context for it. More...

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...

Public Member Functions inherited from BaseCPU
virtual PortProxy::SendFunctionalFunc	getSendFunctional ()
	Returns a sendFunctional delegate for use with port proxies. More...

int	cpuId () const
	Reads this CPU's ID. More...

uint32_t	socketId () const
	Reads this CPU's Socket ID. More...

RequestorID	dataRequestorId () const
	Reads this CPU's unique data requestor ID. More...

RequestorID	instRequestorId () const
	Reads this CPU's unique instruction requestor ID. More...

Port &	getPort (const std::string &if_name, PortID idx=InvalidPortID) override
	Get a port on this CPU. More...

uint32_t	taskId () const
	Get cpu task id. More...

void	taskId (uint32_t id)
	Set cpu task id. More...

uint32_t	getPid () const

void	setPid (uint32_t pid)

void	workItemBegin ()

void	workItemEnd ()

Tick	instCount ()

BaseInterrupts *	getInterruptController (ThreadID tid)

void	postInterrupt (ThreadID tid, int int_num, int index)

void	clearInterrupt (ThreadID tid, int int_num, int index)

void	clearInterrupts (ThreadID tid)

bool	checkInterrupts (ThreadID tid) const

Trace::InstTracer *	getTracer ()
	Provide access to the tracer pointer. More...

int	findContext (ThreadContext *tc)
	Given a Thread Context pointer return the thread num. More...

unsigned	numContexts ()
	Get the number of thread contexts available. More...

ThreadID	contextToThread (ContextID cid)
	Convert ContextID to threadID. More...

const Params *	params () const

	BaseCPU (Params *params, bool is_checker=false)

virtual	~BaseCPU ()

void	init () override

void	startup () override

void	regStats () override

void	regProbePoints () override

void	registerThreadContexts ()

void	deschedulePowerGatingEvent ()

void	schedulePowerGatingEvent ()

void	flushTLBs ()
	Flush all TLBs in the CPU. More...

bool	switchedOut () const
	Determine if the CPU is switched out. More...

unsigned int	cacheLineSize () const
	Get the cache line size of the system. More...

void	serialize (CheckpointOut &cp) const override
	Serialize this object to the given output stream. More...

void	unserialize (CheckpointIn &cp) override
	Reconstruct the state of this object from a checkpoint. More...

void	scheduleInstStop (ThreadID tid, Counter insts, const char *cause)
	Schedule an event that exits the simulation loops after a predefined number of instructions. More...

uint64_t	getCurrentInstCount (ThreadID tid)
	Get the number of instructions executed by the specified thread on this CPU. More...

void	traceFunctions (Addr pc)

void	armMonitor (ThreadID tid, Addr address)

bool	mwait (ThreadID tid, PacketPtr pkt)

void	mwaitAtomic (ThreadID tid, ThreadContext tc, BaseTLB dtb)

AddressMonitor *	getCpuAddrMonitor (ThreadID tid)

bool	waitForRemoteGDB () const

virtual void	probeInstCommit (const StaticInstPtr &inst, Addr pc)
	Helper method to trigger PMU probes for a committed instruction. More...

Protected Types
typedef std::vector< uint64_t >	RegIndexVector

Protected Types inherited from BaseKvmCPU
enum	Status { Idle, Running, RunningService, RunningMMIOPending, RunningServiceCompletion }

Protected Types inherited from BaseCPU
enum	CPUState { CPU_STATE_ON, CPU_STATE_SLEEP, CPU_STATE_WAKEUP }

Protected Member Functions
Tick	kvmRun (Tick ticks) override
	Request KVM to run the guest for a given number of ticks. More...

const RegIndexVector &	getRegList () 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...

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...

Protected Member Functions inherited from BaseCPU
void	updateCycleCounters (CPUState state)
	base method keeping track of cycle progression More...

void	enterPwrGating ()

ProbePoints::PMUUPtr	pmuProbePoint (const char *name)
	Helper method to instantiate probe points belonging to this object. More...

Protected Attributes
bool	irqAsserted
	Cached state of the IRQ line. More...

bool	fiqAsserted
	Cached state of the FIQ line. More...

ArmInterruptPin *	virtTimerPin
	If the user-space GIC and the kernel-space timer are used simultaneously, set up this interrupt pin to forward interrupt from the timer to the GIC when timer IRQ level change is intercepted. More...

uint64_t	prevDeviceIRQLevel
	KVM records whether each in-kernel device IRQ is asserted or disasserted in the kvmRunState->s.regs.device_irq_level bit map, and guarantees at least one KVM exit when the level changes. 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...

Protected Attributes inherited from BaseCPU
Tick	instCnt
	Instruction count used for SPARC misc register. More...

int	_cpuId

const uint32_t	_socketId
	Each cpu will have a socket ID that corresponds to its physical location in the system. More...

RequestorID	_instRequestorId
	instruction side request id that must be placed in all requests More...

RequestorID	_dataRequestorId
	data side request id that must be placed in all requests More...

uint32_t	_taskId
	An intrenal representation of a task identifier within gem5. More...

uint32_t	_pid
	The current OS process ID that is executing on this processor. More...

bool	_switchedOut
	Is the CPU switched out or active? More...

const unsigned int	_cacheLineSize
	Cache the cache line size that we get from the system. More...

std::vector< BaseInterrupts * >	interrupts

std::vector< ThreadContext * >	threadContexts

Trace::InstTracer *	tracer

Cycles	previousCycle

CPUState	previousState

const Cycles	pwrGatingLatency

const bool	powerGatingOnIdle

EventFunctionWrapper	enterPwrGatingEvent

ProbePoints::PMUUPtr	ppRetiredInsts
	Instruction commit probe point. More...

ProbePoints::PMUUPtr	ppRetiredInstsPC

ProbePoints::PMUUPtr	ppRetiredLoads
	Retired load instructions. More...

ProbePoints::PMUUPtr	ppRetiredStores
	Retired store instructions. More...

ProbePoints::PMUUPtr	ppRetiredBranches
	Retired branches (any type) More...

ProbePoints::PMUUPtr	ppAllCycles
	CPU cycle counter even if any thread Context is suspended. More...

ProbePoints::PMUUPtr	ppActiveCycles
	CPU cycle counter, only counts if any thread contexts is active. More...

ProbePointArg< bool > *	ppSleeping
	ProbePoint that signals transitions of threadContexts sets. 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
Public Types inherited from BaseCPU
typedef BaseCPUParams	Params

Static Public Member Functions inherited from BaseCPU
static int	numSimulatedInsts ()

static int	numSimulatedOps ()

static void	wakeup (ThreadID tid)

static int	numSimulatedCPUs ()

static Counter	numSimulatedInsts ()

static Counter	numSimulatedOps ()

Public Attributes inherited from BaseKvmCPU
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

BaseKvmCPU::StatGroup	stats

Counter	ctrInsts
	Number of instructions executed by the CPU. More...

Public Attributes inherited from BaseCPU
ThreadID	numThreads
	Number of threads we're actually simulating (<= SMT_MAX_THREADS). More...

System *	system

Stats::Scalar	numCycles

Stats::Scalar	numWorkItemsStarted

Stats::Scalar	numWorkItemsCompleted

Cycles	syscallRetryLatency

Static Public Attributes inherited from BaseCPU
static const uint32_t	invldPid = std::numeric_limits<uint32_t>::max()
	Invalid or unknown Pid. More...

static const Addr	PCMask = ~((Addr)sizeof(TheISA::MachInst) - 1)

Detailed Description

Definition at line 48 of file base_cpu.hh.

Member Typedef Documentation

◆ RegIndexVector

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

protected

Definition at line 83 of file base_cpu.hh.

Constructor & Destructor Documentation

◆ BaseArmKvmCPU()

BaseArmKvmCPU::BaseArmKvmCPU ( BaseArmKvmCPUParams * params )

Definition at line 62 of file base_cpu.cc.

◆ ~BaseArmKvmCPU()

BaseArmKvmCPU::~BaseArmKvmCPU ( )

virtual

Definition at line 69 of file base_cpu.cc.

Member Function Documentation

◆ getRegList() [1/2]

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 151 of file base_cpu.cc.

References _regIndexList, and panic.

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

◆ getRegList() [2/2]

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 186 of file base_cpu.cc.

References BaseKvmCPU::ioctl(), and panic.

◆ kvmArmVCpuInit()

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

target CPU type to emulate

Definition at line 179 of file base_cpu.cc.

References BaseKvmCPU::init(), BaseKvmCPU::ioctl(), and panic.

Referenced by startup().

◆ kvmRun()

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

ticks Number 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 97 of file base_cpu.cc.

References ArmInterruptPin::clear(), DPRINTF, fiqAsserted, BaseKvmCPU::getKvmRunState(), KvmVM::hasKernelIRQChip(), ArmISA::INT_FIQ, ArmISA::INT_IRQ, INTERRUPT_VCPU_FIQ, INTERRUPT_VCPU_IRQ, BaseCPU::interrupts, irqAsserted, BaseKvmCPU::kvmRun(), prevDeviceIRQLevel, ArmInterruptPin::raise(), KvmVM::setIRQLine(), BaseKvmCPU::vcpuID, virtTimerPin, BaseKvmCPU::vm, and warn_if.

◆ startup()

void BaseArmKvmCPU::startup ( )

override

Definition at line 74 of file base_cpu.cc.

References KvmVM::hasKernelIRQChip(), kvmArmVCpuInit(), ArmSystem::params(), BaseKvmCPU::startup(), BaseCPU::system, BaseKvmCPU::tc, virtTimerPin, and BaseKvmCPU::vm.

Referenced by ArmV8KvmCPU::startup().

◆ tryGetRegList()

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

private

Member Data Documentation

◆ _regIndexList

RegIndexVector BaseArmKvmCPU::_regIndexList

mutableprivate

Cached copy of the list of registers supported by KVM.

Definition at line 124 of file base_cpu.hh.

Referenced by getRegList().

◆ fiqAsserted

bool BaseArmKvmCPU::fiqAsserted

protected

Cached state of the FIQ line.

Definition at line 63 of file base_cpu.hh.

Referenced by kvmRun().

◆ irqAsserted

bool BaseArmKvmCPU::irqAsserted

protected

Cached state of the IRQ line.

Definition at line 61 of file base_cpu.hh.

Referenced by kvmRun().

◆ prevDeviceIRQLevel

uint64_t BaseArmKvmCPU::prevDeviceIRQLevel

protected

KVM records whether each in-kernel device IRQ is asserted or disasserted in the kvmRunState->s.regs.device_irq_level bit map, and guarantees at least one KVM exit when the level changes.

We use only the KVM_ARM_DEV_EL1_VTIMER bit field currently to track the level of the in-kernel timer, and preserve the last level in this class member.

Definition at line 80 of file base_cpu.hh.

Referenced by kvmRun().

◆ virtTimerPin

ArmInterruptPin* BaseArmKvmCPU::virtTimerPin

protected

If the user-space GIC and the kernel-space timer are used simultaneously, set up this interrupt pin to forward interrupt from the timer to the GIC when timer IRQ level change is intercepted.

Definition at line 70 of file base_cpu.hh.

Referenced by kvmRun(), and startup().

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

arch/arm/kvm/base_cpu.hh
arch/arm/kvm/base_cpu.cc

Public Member Functions

Protected Types

Protected Member Functions

Protected Attributes

Private Member Functions

Private Attributes

Additional Inherited Members

Detailed Description

Member Typedef Documentation

◆ RegIndexVector

Constructor & Destructor Documentation

◆ BaseArmKvmCPU()

◆ ~BaseArmKvmCPU()

Member Function Documentation

◆ getRegList() [1/2]

◆ getRegList() [2/2]

◆ kvmArmVCpuInit()

◆ kvmRun()

◆ startup()

◆ tryGetRegList()

Member Data Documentation

◆ _regIndexList

◆ fiqAsserted

◆ irqAsserted

◆ prevDeviceIRQLevel

◆ virtTimerPin