#include <table_walker.hh>

Inheritance diagram for ArmISA::TableWalker:

Classes
class	DescriptorBase

class	L1Descriptor

class	L2Descriptor
	Level 2 page table descriptor. More...

class	LongDescriptor
	Long-descriptor format (LPAE) More...

class	WalkerState

Public Types
enum	GrainSize { Grain4KB = 12, Grain16KB = 14, Grain64KB = 16, ReservedGrain = 0 }

typedef ArmTableWalkerParams	Params

Public Types inherited from ClockedObject
typedef ClockedObjectParams	Params
	Parameters of ClockedObject. More...

Public Types inherited from SimObject
typedef SimObjectParams	Params

Public Member Functions
	TableWalker (const Params *p)

virtual	~TableWalker ()

const Params *	params () const

void	init () override
	init() is called after all C++ SimObjects have been created and all ports are connected. More...

bool	haveLPAE () const

bool	haveVirtualization () const

bool	haveLargeAsid64 () const

void	completeDrain ()
	Checks if all state is cleared and if so, completes drain. More...

DrainState	drain () override
	Notify an object that it needs to drain its state. More...

void	drainResume () override
	Resume execution after a successful drain. More...

Port &	getPort (const std::string &if_name, PortID idx=InvalidPortID) override
	Get a port with a given name and index. More...

void	regStats () override
	Callback to set stat parameters. More...

Fault	walk (const RequestPtr &req, ThreadContext tc, uint16_t asid, uint8_t _vmid, bool _isHyp, TLB::Mode mode, TLB::Translation _trans, bool timing, bool functional, bool secure, TLB::ArmTranslationType tranType, bool _stage2Req)

void	setTlb (TLB *_tlb)

TLB *	getTlb ()

void	setMMU (Stage2MMU *m, MasterID master_id)

void	memAttrs (ThreadContext *tc, TlbEntry &te, SCTLR sctlr, uint8_t texcb, bool s)

void	memAttrsLPAE (ThreadContext *tc, TlbEntry &te, LongDescriptor &lDescriptor)

void	memAttrsAArch64 (ThreadContext *tc, TlbEntry &te, LongDescriptor &lDescriptor)

Public Member Functions inherited from ClockedObject
	ClockedObject (const ClockedObjectParams *p)

const Params *	params () const

void	serialize (CheckpointOut &cp) const override
	Serialize an object. More...

void	unserialize (CheckpointIn &cp) override
	Unserialize an object. More...

Enums::PwrState	pwrState () const

std::string	pwrStateName () const

std::vector< double >	pwrStateWeights () const
	Returns the percentage residency for each power state. More...

void	computeStats ()
	Record stats values like state residency by computing the time difference from previous update. More...

void	pwrState (Enums::PwrState)

Public Member Functions inherited from SimObject
const Params *	params () const

	SimObject (const Params *_params)

virtual	~SimObject ()

virtual const std::string	name () const

virtual void	loadState (CheckpointIn &cp)
	loadState() is called on each SimObject when restoring from a checkpoint. More...

virtual void	initState ()
	initState() is called on each SimObject when not restoring from a checkpoint. More...

virtual void	regProbePoints ()
	Register probe points for this object. More...

virtual void	regProbeListeners ()
	Register probe listeners for this object. More...

ProbeManager *	getProbeManager ()
	Get the probe manager for this object. More...

virtual void	startup ()
	startup() is the final initialization call before simulation. More...

DrainState	drain () override
	Provide a default implementation of the drain interface for objects that don't need draining. More...

virtual void	memWriteback ()
	Write back dirty buffers to memory using functional writes. More...

virtual void	memInvalidate ()
	Invalidate the contents of memory buffers. More...

void	serialize (CheckpointOut &cp) const override
	Serialize an object. More...

void	unserialize (CheckpointIn &cp) override
	Unserialize an object. More...

Public Member Functions inherited from EventManager
	EventManager (EventManager &em)

	EventManager (EventManager *em)

	EventManager (EventQueue *eq)

EventQueue *	eventQueue () const

void	schedule (Event &event, Tick when)

void	deschedule (Event &event)

void	reschedule (Event &event, Tick when, bool always=false)

void	schedule (Event *event, Tick when)

void	deschedule (Event *event)

void	reschedule (Event *event, Tick when, bool always=false)

void	wakeupEventQueue (Tick when=(Tick) -1)

void	setCurTick (Tick newVal)

Public Member Functions inherited from Serializable
	Serializable ()

virtual	~Serializable ()

void	serializeSection (CheckpointOut &cp, const char *name) const
	Serialize an object into a new section. More...

void	serializeSection (CheckpointOut &cp, const std::string &name) const

void	unserializeSection (CheckpointIn &cp, const char *name)
	Unserialize an a child object. More...

void	unserializeSection (CheckpointIn &cp, const std::string &name)

Public Member Functions inherited from Drainable
DrainState	drainState () const
	Return the current drain state of an object. More...

virtual void	notifyFork ()
	Notify a child process of a fork. More...

Public Member Functions inherited from Stats::Group
	Group ()=delete

	Group (const Group &)=delete

Group &	operator= (const Group &)=delete

	Group (Group parent, const char name=nullptr)
	Construct a new statistics group. More...

virtual	~Group ()

virtual void	resetStats ()
	Callback to reset stats. More...

virtual void	preDumpStats ()
	Callback before stats are dumped. More...

void	addStat (Stats::Info *info)
	Register a stat with this group. More...

const std::map< std::string, Group * > &	getStatGroups () const
	Get all child groups associated with this object. More...

const std::vector< Info * > &	getStats () const
	Get all stats associated with this object. More...

void	addStatGroup (const char name, Group block)
	Add a stat block as a child of this block. More...

Public Member Functions inherited from Clocked
void	updateClockPeriod ()
	Update the tick to the current tick. More...

Tick	clockEdge (Cycles cycles=Cycles(0)) const
	Determine the tick when a cycle begins, by default the current one, but the argument also enables the caller to determine a future cycle. More...

Cycles	curCycle () const
	Determine the current cycle, corresponding to a tick aligned to a clock edge. More...

Tick	nextCycle () const
	Based on the clock of the object, determine the start tick of the first cycle that is at least one cycle in the future. More...

uint64_t	frequency () const

Tick	clockPeriod () const

double	voltage () const

Cycles	ticksToCycles (Tick t) const

Tick	cyclesToTicks (Cycles c) const

Static Public Member Functions
static LookupLevel	toLookupLevel (uint8_t lookup_level_as_int)

Static Public Member Functions inherited from SimObject
static void	serializeAll (CheckpointOut &cp)
	Serialize all SimObjects in the system. More...

static SimObject *	find (const char *name)
	Find the SimObject with the given name and return a pointer to it. More...

Static Public Member Functions inherited from Serializable
static const std::string &	currentSection ()
	Get the fully-qualified name of the active section. More...

static void	serializeAll (const std::string &cpt_dir)

static void	unserializeGlobals (CheckpointIn &cp)

Protected Attributes
std::list< WalkerState * >	stateQueues [MAX_LOOKUP_LEVELS]
	Queues of requests for all the different lookup levels. More...

std::list< WalkerState * >	pendingQueue
	Queue of requests that have passed are waiting because the walker is currently busy. More...

Stage2MMU *	stage2Mmu
	The MMU to forward second stage look upts to. More...

DmaPort *	port
	Port shared by the two table walkers. More...

MasterID	masterId
	Master id assigned by the MMU. More...

const bool	isStage2
	Indicates whether this table walker is part of the stage 2 mmu. More...

TLB *	tlb
	TLB that is initiating these table walks. More...

SCTLR	sctlr
	Cached copy of the sctlr as it existed when translation began. More...

WalkerState *	currState

bool	pending
	If a timing translation is currently in progress. More...

unsigned	numSquashable
	The number of walks belonging to squashed instructions that can be removed from the pendingQueue per cycle. More...

bool	haveSecurity
	Cached copies of system-level properties. More...

bool	_haveLPAE

bool	_haveVirtualization

uint8_t	physAddrRange

bool	_haveLargeAsid64

Stats::Scalar	statWalks
	Statistics. More...

Stats::Scalar	statWalksShortDescriptor

Stats::Scalar	statWalksLongDescriptor

Stats::Vector	statWalksShortTerminatedAtLevel

Stats::Vector	statWalksLongTerminatedAtLevel

Stats::Scalar	statSquashedBefore

Stats::Scalar	statSquashedAfter

Stats::Histogram	statWalkWaitTime

Stats::Histogram	statWalkServiceTime

Stats::Histogram	statPendingWalks

Stats::Vector	statPageSizes

Stats::Vector2d	statRequestOrigin

unsigned	pendingReqs

Tick	pendingChangeTick

Protected Attributes inherited from ClockedObject
Enums::PwrState	_currPwrState
	To keep track of the current power state. More...

Tick	prvEvalTick

ClockedObject::ClockedObjectStats	stats

Protected Attributes inherited from SimObject
const SimObjectParams *	_params
	Cached copy of the object parameters. More...

Protected Attributes inherited from EventManager
EventQueue *	eventq
	A pointer to this object's event queue. More...

Static Protected Attributes
static const unsigned	REQUESTED = 0

static const unsigned	COMPLETED = 1

Private Member Functions
void	doL1Descriptor ()

void	doL1DescriptorWrapper ()

void	doL2Descriptor ()

void	doL2DescriptorWrapper ()

void	doLongDescriptor ()

void	doL0LongDescriptorWrapper ()

void	doL1LongDescriptorWrapper ()

void	doL2LongDescriptorWrapper ()

void	doL3LongDescriptorWrapper ()

void	doLongDescriptorWrapper (LookupLevel curr_lookup_level)

bool	fetchDescriptor (Addr descAddr, uint8_t data, int numBytes, Request::Flags flags, int queueIndex, Event event, void(TableWalker::*doDescriptor)())

Fault	generateLongDescFault (ArmFault::FaultSource src)

void	insertTableEntry (DescriptorBase &descriptor, bool longDescriptor)

Fault	processWalk ()

Fault	processWalkLPAE ()

Fault	processWalkAArch64 ()

void	processWalkWrapper ()

void	nextWalk (ThreadContext *tc)

void	pendingChange ()

Fault	testWalk (Addr pa, Addr size, TlbEntry::DomainType domain, LookupLevel lookup_level)

Static Private Member Functions
static unsigned	adjustTableSizeAArch64 (unsigned tsz)

static bool	checkAddrSizeFaultAArch64 (Addr addr, int currPhysAddrRange)
	Returns true if the address exceeds the range permitted by the system-wide setting or by the TCR_ELx IPS/PS setting. More...

static uint8_t	pageSizeNtoStatBin (uint8_t N)

Private Attributes
EventFunctionWrapper	doL1DescEvent

EventFunctionWrapper	doL2DescEvent

EventFunctionWrapper	doL0LongDescEvent

EventFunctionWrapper	doL1LongDescEvent

EventFunctionWrapper	doL2LongDescEvent

EventFunctionWrapper	doL3LongDescEvent

Event *	LongDescEventByLevel [4]

EventFunctionWrapper	doProcessEvent

Additional Inherited Members
Static Public Attributes inherited from Serializable
static int	ckptCount = 0

static int	ckptMaxCount = 0

static int	ckptPrevCount = -1

Protected Member Functions inherited from Drainable
	Drainable ()

virtual	~Drainable ()

void	signalDrainDone () const
	Signal that an object is drained. More...

Protected Member Functions inherited from Clocked
	Clocked (ClockDomain &clk_domain)
	Create a clocked object and set the clock domain based on the parameters. More...

	Clocked (Clocked &)=delete

Clocked &	operator= (Clocked &)=delete

virtual	~Clocked ()
	Virtual destructor due to inheritance. More...

void	resetClock () const
	Reset the object's clock using the current global tick value. More...

virtual void	clockPeriodUpdated ()
	A hook subclasses can implement so they can do any extra work that's needed when the clock rate is changed. More...

Detailed Description

Definition at line 64 of file table_walker.hh.

Member Typedef Documentation

◆ Params

typedef ArmTableWalkerParams ArmISA::TableWalker::Params

Definition at line 884 of file table_walker.hh.

Member Enumeration Documentation

◆ GrainSize

enum ArmISA::TableWalker::GrainSize

Enumerator
Grain4KB
Grain16KB
Grain64KB
ReservedGrain

Definition at line 370 of file table_walker.hh.

Constructor & Destructor Documentation

◆ TableWalker()

TableWalker::TableWalker ( const Params * p )

◆ ~TableWalker()

TableWalker::~TableWalker ( )

virtual

Definition at line 96 of file table_walker.cc.

Member Function Documentation

◆ adjustTableSizeAArch64()

unsigned TableWalker::adjustTableSizeAArch64 ( unsigned tsz )

staticprivate

Definition at line 737 of file table_walker.cc.

Referenced by processWalkAArch64().

◆ checkAddrSizeFaultAArch64()

bool TableWalker::checkAddrSizeFaultAArch64	(	Addr	addr,
		int	currPhysAddrRange
	)

staticprivate

Returns true if the address exceeds the range permitted by the system-wide setting or by the TCR_ELx IPS/PS setting.

Definition at line 747 of file table_walker.cc.

References bits(), and ArmISA::MaxPhysAddrRange.

Referenced by doLongDescriptor(), and processWalkAArch64().

◆ completeDrain()

void TableWalker::completeDrain ( )

Checks if all state is cleared and if so, completes drain.

Definition at line 147 of file table_walker.cc.

References DPRINTF, Draining, Drainable::drainState(), ArmISA::L0, ArmISA::L1, ArmISA::L2, ArmISA::L3, pendingQueue, Drainable::signalDrainDone(), and stateQueues.

Referenced by haveLargeAsid64(), and nextWalk().

◆ doL0LongDescriptorWrapper()

void TableWalker::doL0LongDescriptorWrapper ( )

private

Definition at line 1917 of file table_walker.cc.

References doLongDescriptorWrapper(), and ArmISA::L0.

Referenced by TableWalker().

◆ doL1Descriptor()

void TableWalker::doL1Descriptor ( )

private

Todo:: : check sctlr.ha (bit[17]) if Hardware Access Flag is enabled if set, do l1.Desc.setAp0() instead of generating AccessFlag0

Definition at line 1477 of file table_walker.cc.

Referenced by getTlb(), and processWalk().

◆ doL1DescriptorWrapper()

void TableWalker::doL1DescriptorWrapper ( )

private

Definition at line 1820 of file table_walker.cc.

Referenced by getTlb(), and TableWalker().

◆ doL1LongDescriptorWrapper()

void TableWalker::doL1LongDescriptorWrapper ( )

private

Definition at line 1923 of file table_walker.cc.

References doLongDescriptorWrapper(), and ArmISA::L1.

Referenced by TableWalker().

◆ doL2Descriptor()

void TableWalker::doL2Descriptor ( )

private

Todo:: : check sctlr.ha (bit[17]) if Hardware Access Flag is enabled if set, do l2.Desc.setAp0() instead of generating AccessFlag0

Definition at line 1764 of file table_walker.cc.

Referenced by doL1Descriptor().

◆ doL2DescriptorWrapper()

void TableWalker::doL2DescriptorWrapper ( )

private

◆ doL2LongDescriptorWrapper()

void TableWalker::doL2LongDescriptorWrapper ( )

private

Definition at line 1929 of file table_walker.cc.

References doLongDescriptorWrapper(), and ArmISA::L2.

Referenced by TableWalker().

◆ doL3LongDescriptorWrapper()

void TableWalker::doL3LongDescriptorWrapper ( )

private

Definition at line 1935 of file table_walker.cc.

References doLongDescriptorWrapper(), and ArmISA::L3.

Referenced by TableWalker().

◆ doLongDescriptor()

void TableWalker::doLongDescriptor ( )

private

Definition at line 1602 of file table_walker.cc.

Referenced by processWalkAArch64(), and processWalkLPAE().

◆ doLongDescriptorWrapper()

void TableWalker::doLongDescriptorWrapper ( LookupLevel curr_lookup_level )

private

Definition at line 1941 of file table_walker.cc.

Referenced by doL0LongDescriptorWrapper(), doL1LongDescriptorWrapper(), doL2LongDescriptorWrapper(), and doL3LongDescriptorWrapper().

◆ drain()

DrainState TableWalker::drain ( )

overridevirtual

Notify an object that it needs to drain its state.

If the object does not need further simulation to drain internal buffers, it returns DrainState::Drained and automatically switches to the Drained state. If the object needs more simulation, it returns DrainState::Draining and automatically enters the Draining state. Other return values are invalid.

Note: An object that has entered the Drained state can be disturbed by other objects in the system and consequently stop being drained. These perturbations are not visible in the drain state. The simulator therefore repeats the draining process until all objects return DrainState::Drained on the first call to drain().

Returns: DrainState::Drained if the object is drained at this point in time, DrainState::Draining if it needs further simulation.

Implements Drainable.

Definition at line 160 of file table_walker.cc.

References DPRINTF, Drained, Draining, ArmISA::i, ArmISA::MAX_LOOKUP_LEVELS, pendingQueue, and stateQueues.

Referenced by haveLargeAsid64().

◆ drainResume()

void TableWalker::drainResume ( )

overridevirtual

Resume execution after a successful drain.

Reimplemented from Drainable.

Definition at line 181 of file table_walker.cc.

References currState, params(), and pendingChange().

Referenced by haveLargeAsid64().

◆ fetchDescriptor()

bool TableWalker::fetchDescriptor	(	Addr	descAddr,
		uint8_t *	data,
		int	numBytes,
		Request::Flags	flags,
		int	queueIndex,
		Event *	event,
		void(TableWalker::*)()	doDescriptor
	)

private

Definition at line 2006 of file table_walker.cc.

Referenced by doL1Descriptor(), doLongDescriptor(), processWalk(), processWalkAArch64(), and processWalkLPAE().

◆ generateLongDescFault()

Fault TableWalker::generateLongDescFault ( ArmFault::FaultSource src )

private

Definition at line 1582 of file table_walker.cc.

References currState, ArmISA::TableWalker::WalkerState::isFetch, isStage2, ArmISA::TableWalker::WalkerState::isWrite, ArmISA::TableWalker::WalkerState::longDesc, ArmISA::TableWalker::DescriptorBase::lookupLevel, ArmISA::ArmFault::LpaeTran, ArmISA::TlbEntry::NoAccess, ArmISA::TableWalker::WalkerState::req, and ArmISA::TableWalker::WalkerState::vaddr_tainted.

Referenced by doLongDescriptor().

◆ getPort()

Port & TableWalker::getPort	(	const std::string &	if_name,
		PortID	idx = `InvalidPortID`
	)

overridevirtual

Get a port with a given name and index.

This is used at binding time and returns a reference to a protocol-agnostic port.

Parameters

if_name	Port name
idx	Index in the case of a VectorPort

Returns: A reference to the given port

Reimplemented from SimObject.

Definition at line 118 of file table_walker.cc.

References fatal, SimObject::getPort(), isStage2, and port.

Referenced by haveLargeAsid64().

◆ getTlb()

TLB* ArmISA::TableWalker::getTlb ( )

inline

Definition at line 916 of file table_walker.hh.

References doL1Descriptor(), doL1DescriptorWrapper(), ArmISA::m, memAttrs(), memAttrsAArch64(), memAttrsLPAE(), ArmISA::s, setMMU(), ArmISA::te, ArmISA::TableWalker::DescriptorBase::texcb(), tlb, and toLookupLevel().

◆ haveLargeAsid64()

bool ArmISA::TableWalker::haveLargeAsid64 ( ) const

inline

Definition at line 898 of file table_walker.hh.

References _haveLargeAsid64, ArmISA::asid, completeDrain(), drain(), drainResume(), getPort(), InvalidPortID, ArmISA::mode, regStats(), ArmISA::TableWalker::DescriptorBase::secure(), and walk().

Referenced by ArmISA::TLB::TLB().

◆ haveLPAE()

bool ArmISA::TableWalker::haveLPAE ( ) const

inline

Definition at line 896 of file table_walker.hh.

References _haveLPAE.

Referenced by ArmISA::TLB::TLB().

◆ haveVirtualization()

bool ArmISA::TableWalker::haveVirtualization ( ) const

inline

Definition at line 897 of file table_walker.hh.

References _haveVirtualization.

Referenced by ArmISA::TLB::TLB().

◆ init()

void TableWalker::init ( )

overridevirtual

init() is called after all C++ SimObjects have been created and all ports are connected.

Initializations that are independent of unserialization but rely on a fully instantiated and connected SimObject graph should be done here.

Reimplemented from SimObject.

Definition at line 110 of file table_walker.cc.

References fatal_if, port, stage2Mmu, and tlb.

Referenced by params().

◆ insertTableEntry()

void TableWalker::insertTableEntry	(	DescriptorBase &	descriptor,
		bool	longDescriptor
	)

private

Definition at line 2079 of file table_walker.cc.

Referenced by doL1Descriptor(), doL2Descriptor(), and doLongDescriptor().

◆ memAttrs()

void TableWalker::memAttrs	(	ThreadContext *	tc,
		TlbEntry &	te,
		SCTLR	sctlr,
		uint8_t	texcb,
		bool	s
	)

◆ memAttrsAArch64()

void TableWalker::memAttrsAArch64	(	ThreadContext *	tc,
		TlbEntry &	te,
		LongDescriptor &	lDescriptor
	)

Definition at line 1378 of file table_walker.cc.

References ArmISA::attr, ArmISA::TlbEntry::attributes, ArmISA::TableWalker::LongDescriptor::attrIndx(), bits(), currState, ArmISA::TlbEntry::Device, DPRINTF, ArmISA::TableWalker::WalkerState::el, ArmISA::EL0, ArmISA::EL1, ArmISA::EL2, ArmISA::EL3, ArmISA::TlbEntry::innerAttrs, isStage2, M5_FALLTHROUGH, ArmISA::TableWalker::LongDescriptor::memAttr(), ArmISA::MISCREG_MAIR_EL1, ArmISA::MISCREG_MAIR_EL2, ArmISA::MISCREG_MAIR_EL3, ArmISA::TlbEntry::mtype, ArmISA::TlbEntry::nonCacheable, ArmISA::TlbEntry::Normal, ArmISA::TlbEntry::ns, ArmISA::TlbEntry::outerAttrs, ArmISA::TlbEntry::outerShareable, panic, ThreadContext::readMiscReg(), ArmISA::TableWalker::LongDescriptor::sh(), ArmISA::sh, ArmISA::TlbEntry::shareable, ArmISA::TlbEntry::StronglyOrdered, and warn_if.

Referenced by getTlb(), and insertTableEntry().

◆ memAttrsLPAE()

void TableWalker::memAttrsLPAE	(	ThreadContext *	tc,
		TlbEntry &	te,
		LongDescriptor &	lDescriptor
	)

Definition at line 1252 of file table_walker.cc.

Referenced by getTlb(), and insertTableEntry().

◆ nextWalk()

void TableWalker::nextWalk ( ThreadContext * tc )

private

Definition at line 1997 of file table_walker.cc.

References Clocked::clockEdge(), completeDrain(), doProcessEvent, pendingQueue, and EventManager::schedule().

Referenced by doL1DescriptorWrapper(), doL2DescriptorWrapper(), doLongDescriptorWrapper(), processWalk(), processWalkAArch64(), processWalkLPAE(), and processWalkWrapper().

◆ pageSizeNtoStatBin()

uint8_t TableWalker::pageSizeNtoStatBin ( uint8_t N )

staticprivate

Definition at line 2202 of file table_walker.cc.

References panic.

Referenced by insertTableEntry().

◆ params()

const Params* ArmISA::TableWalker::params ( ) const

inline

Definition at line 889 of file table_walker.hh.

References SimObject::_params, and init().

Referenced by drainResume().

◆ pendingChange()

void TableWalker::pendingChange ( )

private

Definition at line 2177 of file table_walker.cc.

References currState, curTick(), ArmISA::n, pendingChangeTick, pendingQueue, pendingReqs, Stats::DistBase< Derived, Stor >::sample(), and statPendingWalks.

Referenced by drainResume(), processWalkWrapper(), and walk().

◆ processWalk()

Fault TableWalker::processWalk ( )

private

Definition at line 456 of file table_walker.cc.

Referenced by processWalkWrapper(), and walk().

◆ processWalkAArch64()

Fault TableWalker::processWalkAArch64 ( )

private

Definition at line 754 of file table_walker.cc.

Referenced by processWalkWrapper(), and walk().

◆ processWalkLPAE()

Fault TableWalker::processWalkLPAE ( )

private

Definition at line 565 of file table_walker.cc.

Referenced by processWalkWrapper(), and walk().

◆ processWalkWrapper()

void TableWalker::processWalkWrapper ( )

private

Definition at line 365 of file table_walker.cc.

Referenced by TableWalker().

◆ regStats()

void TableWalker::regStats ( )

overridevirtual

Callback to set stat parameters.

This callback is typically used for complex stats (e.g., distributions) that need parameters in addition to a name and a description. Stat names and descriptions should typically be set from the constructor usingo from the constructor using the ADD_STAT macro.

Reimplemented from Stats::Group.

Definition at line 2222 of file table_walker.cc.

References Stats::DataWrap< Derived, InfoProxyType >::desc(), Stats::dist, Stats::DataWrap< Derived, InfoProxyType >::flags(), Stats::VectorBase< Derived, Stor >::init(), Stats::Vector2dBase< Derived, Stor >::init(), Stats::Histogram::init(), Stats::DataWrap< Derived, InfoProxyType >::name(), ArmISA::TableWalker::WalkerState::name(), Stats::nonan, Stats::nozero, Stats::pdf, Stats::Group::regStats(), statPageSizes, statPendingWalks, statRequestOrigin, statSquashedAfter, statSquashedBefore, statWalks, statWalkServiceTime, statWalksLongDescriptor, statWalksLongTerminatedAtLevel, statWalksShortDescriptor, statWalksShortTerminatedAtLevel, statWalkWaitTime, Stats::DataWrapVec< Derived, InfoProxyType >::subname(), Stats::total, and Stats::DataWrapVec2d< Derived, InfoProxyType >::ysubname().

Referenced by haveLargeAsid64().

◆ setMMU()

void TableWalker::setMMU	(	Stage2MMU *	m,
		MasterID	master_id
	)

Definition at line 102 of file table_walker.cc.

References ArmISA::Stage2MMU::getDMAPort(), ArmISA::m, masterId, port, and stage2Mmu.

Referenced by getTlb(), and ArmISA::TLB::setMMU().

◆ setTlb()

void ArmISA::TableWalker::setTlb ( TLB * _tlb )

inline

Definition at line 915 of file table_walker.hh.

Referenced by ArmISA::TLB::TLB().

◆ testWalk()

Fault TableWalker::testWalk	(	Addr	pa,
		Addr	size,
		TlbEntry::DomainType	domain,
		LookupLevel	lookup_level
	)

private

Definition at line 2193 of file table_walker.cc.

References currState, ArmISA::TableWalker::WalkerState::isSecure, ArmISA::TableWalker::WalkerState::mode, ArmISA::TLB::testWalk(), tlb, and ArmISA::TableWalker::WalkerState::vaddr.

Referenced by doL1Descriptor(), doLongDescriptor(), processWalk(), processWalkAArch64(), and processWalkLPAE().

◆ toLookupLevel()

LookupLevel TableWalker::toLookupLevel ( uint8_t lookup_level_as_int )

static

Definition at line 2160 of file table_walker.cc.

References ArmISA::L1, ArmISA::L2, ArmISA::L3, and panic.

Referenced by doLongDescriptor(), and getTlb().

◆ walk()

Fault TableWalker::walk	(	const RequestPtr &	req,
		ThreadContext *	tc,
		uint16_t	asid,
		uint8_t	_vmid,
		bool	_isHyp,
		TLB::Mode	mode,
		TLB::Translation *	_trans,
		bool	timing,
		bool	functional,
		bool	secure,
		TLB::ArmTranslationType	tranType,
		bool	_stage2Req
	)

Todo:: These should be cached or grabbed from cached copies in the TLB, all these miscreg reads are expensive

Definition at line 191 of file table_walker.cc.

Referenced by ArmISA::TLB::getTE(), and haveLargeAsid64().

Member Data Documentation

◆ _haveLargeAsid64

bool ArmISA::TableWalker::_haveLargeAsid64

protected

Definition at line 861 of file table_walker.hh.

Referenced by haveLargeAsid64(), and TableWalker().

◆ _haveLPAE

bool ArmISA::TableWalker::_haveLPAE

protected

Definition at line 858 of file table_walker.hh.

Referenced by haveLPAE(), memAttrsLPAE(), and TableWalker().

◆ _haveVirtualization

bool ArmISA::TableWalker::_haveVirtualization

protected

Definition at line 859 of file table_walker.hh.

Referenced by haveVirtualization(), TableWalker(), and walk().

◆ COMPLETED

const unsigned ArmISA::TableWalker::COMPLETED = 1

staticprotected

Definition at line 881 of file table_walker.hh.

Referenced by insertTableEntry().

◆ currState

WalkerState* ArmISA::TableWalker::currState

protected

Definition at line 847 of file table_walker.hh.

Referenced by doL1Descriptor(), doL1DescriptorWrapper(), doL2Descriptor(), doL2DescriptorWrapper(), doLongDescriptor(), doLongDescriptorWrapper(), drainResume(), fetchDescriptor(), generateLongDescFault(), insertTableEntry(), memAttrs(), memAttrsAArch64(), memAttrsLPAE(), pendingChange(), processWalk(), processWalkAArch64(), processWalkLPAE(), processWalkWrapper(), testWalk(), and walk().

◆ doL0LongDescEvent

EventFunctionWrapper ArmISA::TableWalker::doL0LongDescEvent

private

Definition at line 940 of file table_walker.hh.

Referenced by TableWalker().

◆ doL1DescEvent

EventFunctionWrapper ArmISA::TableWalker::doL1DescEvent

private

Definition at line 931 of file table_walker.hh.

Referenced by processWalk().

◆ doL1LongDescEvent

EventFunctionWrapper ArmISA::TableWalker::doL1LongDescEvent

private

Definition at line 942 of file table_walker.hh.

Referenced by TableWalker().

◆ doL2DescEvent

EventFunctionWrapper ArmISA::TableWalker::doL2DescEvent

private

Definition at line 935 of file table_walker.hh.

Referenced by doL1Descriptor(), and TableWalker().

◆ doL2LongDescEvent

EventFunctionWrapper ArmISA::TableWalker::doL2LongDescEvent

private

Definition at line 944 of file table_walker.hh.

Referenced by TableWalker().

◆ doL3LongDescEvent

EventFunctionWrapper ArmISA::TableWalker::doL3LongDescEvent

private

Definition at line 946 of file table_walker.hh.

Referenced by TableWalker().

◆ doProcessEvent

EventFunctionWrapper ArmISA::TableWalker::doProcessEvent

private

Definition at line 967 of file table_walker.hh.

Referenced by nextWalk(), and TableWalker().

◆ haveSecurity

bool ArmISA::TableWalker::haveSecurity

protected

Cached copies of system-level properties.

Definition at line 857 of file table_walker.hh.

Referenced by insertTableEntry(), processWalk(), TableWalker(), and walk().

◆ isStage2

const bool ArmISA::TableWalker::isStage2

protected

Indicates whether this table walker is part of the stage 2 mmu.

Definition at line 839 of file table_walker.hh.

Referenced by doL1Descriptor(), doL2Descriptor(), generateLongDescFault(), getPort(), insertTableEntry(), memAttrsAArch64(), memAttrsLPAE(), processWalk(), processWalkAArch64(), processWalkLPAE(), processWalkWrapper(), and walk().

◆ LongDescEventByLevel

Event* ArmISA::TableWalker::LongDescEventByLevel[4]

private

Definition at line 949 of file table_walker.hh.

Referenced by doLongDescriptor(), processWalkAArch64(), processWalkLPAE(), and TableWalker().

◆ masterId

MasterID ArmISA::TableWalker::masterId

protected

Master id assigned by the MMU.

Definition at line 836 of file table_walker.hh.

Referenced by fetchDescriptor(), and setMMU().

◆ numSquashable

unsigned ArmISA::TableWalker::numSquashable

protected

The number of walks belonging to squashed instructions that can be removed from the pendingQueue per cycle.

Definition at line 854 of file table_walker.hh.

Referenced by processWalkWrapper().

◆ pending

bool ArmISA::TableWalker::pending

protected

If a timing translation is currently in progress.

Definition at line 850 of file table_walker.hh.

Referenced by doL1DescriptorWrapper(), doL2DescriptorWrapper(), doLongDescriptorWrapper(), processWalk(), processWalkAArch64(), processWalkLPAE(), processWalkWrapper(), and walk().

◆ pendingChangeTick

Tick ArmISA::TableWalker::pendingChangeTick

mutableprotected

Definition at line 878 of file table_walker.hh.

Referenced by pendingChange().

◆ pendingQueue

std::list<WalkerState *> ArmISA::TableWalker::pendingQueue

protected

Queue of requests that have passed are waiting because the walker is currently busy.

Definition at line 827 of file table_walker.hh.

Referenced by completeDrain(), drain(), nextWalk(), pendingChange(), processWalkWrapper(), and walk().

◆ pendingReqs

unsigned ArmISA::TableWalker::pendingReqs

mutableprotected

Definition at line 877 of file table_walker.hh.

Referenced by pendingChange().

◆ physAddrRange

uint8_t ArmISA::TableWalker::physAddrRange

protected

Definition at line 860 of file table_walker.hh.

Referenced by TableWalker().

◆ port

DmaPort* ArmISA::TableWalker::port

protected

Port shared by the two table walkers.

Definition at line 833 of file table_walker.hh.

Referenced by fetchDescriptor(), getPort(), init(), and setMMU().

◆ REQUESTED

const unsigned ArmISA::TableWalker::REQUESTED = 0

staticprotected

Definition at line 880 of file table_walker.hh.

Referenced by walk().

◆ sctlr

SCTLR ArmISA::TableWalker::sctlr

protected

Cached copy of the sctlr as it existed when translation began.

Definition at line 845 of file table_walker.hh.

Referenced by TableWalker().

◆ stage2Mmu

Stage2MMU* ArmISA::TableWalker::stage2Mmu

protected

The MMU to forward second stage look upts to.

Definition at line 830 of file table_walker.hh.

Referenced by fetchDescriptor(), init(), and setMMU().

◆ stateQueues

std::list<WalkerState *> ArmISA::TableWalker::stateQueues[MAX_LOOKUP_LEVELS]

protected

Queues of requests for all the different lookup levels.

Definition at line 823 of file table_walker.hh.

Referenced by completeDrain(), doL1DescriptorWrapper(), doL2DescriptorWrapper(), doLongDescriptorWrapper(), drain(), and fetchDescriptor().

◆ statPageSizes

Stats::Vector ArmISA::TableWalker::statPageSizes

protected

Definition at line 874 of file table_walker.hh.

Referenced by insertTableEntry(), and regStats().

◆ statPendingWalks

Stats::Histogram ArmISA::TableWalker::statPendingWalks

protected

Definition at line 873 of file table_walker.hh.

Referenced by pendingChange(), and regStats().

◆ statRequestOrigin

Stats::Vector2d ArmISA::TableWalker::statRequestOrigin

protected

Definition at line 875 of file table_walker.hh.

Referenced by insertTableEntry(), regStats(), and walk().

◆ statSquashedAfter

Stats::Scalar ArmISA::TableWalker::statSquashedAfter

protected

Definition at line 870 of file table_walker.hh.

Referenced by regStats().

◆ statSquashedBefore

Stats::Scalar ArmISA::TableWalker::statSquashedBefore

protected

Definition at line 869 of file table_walker.hh.

Referenced by processWalkWrapper(), regStats(), and walk().

◆ statWalks

Stats::Scalar ArmISA::TableWalker::statWalks

protected

Statistics.

Definition at line 864 of file table_walker.hh.

Referenced by regStats(), and walk().

◆ statWalkServiceTime

Stats::Histogram ArmISA::TableWalker::statWalkServiceTime

protected

Definition at line 872 of file table_walker.hh.

Referenced by doL1DescriptorWrapper(), doL2DescriptorWrapper(), doLongDescriptorWrapper(), processWalkWrapper(), and regStats().

◆ statWalksLongDescriptor

Stats::Scalar ArmISA::TableWalker::statWalksLongDescriptor

protected

Definition at line 866 of file table_walker.hh.

Referenced by regStats(), and walk().

◆ statWalksLongTerminatedAtLevel

Stats::Vector ArmISA::TableWalker::statWalksLongTerminatedAtLevel

protected

Definition at line 868 of file table_walker.hh.

Referenced by doLongDescriptorWrapper(), and regStats().

◆ statWalksShortDescriptor

Stats::Scalar ArmISA::TableWalker::statWalksShortDescriptor

protected

Definition at line 865 of file table_walker.hh.

Referenced by regStats(), and walk().

◆ statWalksShortTerminatedAtLevel

Stats::Vector ArmISA::TableWalker::statWalksShortTerminatedAtLevel

protected

Definition at line 867 of file table_walker.hh.

Referenced by doL1DescriptorWrapper(), doL2DescriptorWrapper(), and regStats().

◆ statWalkWaitTime

Stats::Histogram ArmISA::TableWalker::statWalkWaitTime

protected

Definition at line 871 of file table_walker.hh.

Referenced by processWalk(), processWalkAArch64(), processWalkLPAE(), and regStats().

◆ tlb

TLB* ArmISA::TableWalker::tlb

protected

TLB that is initiating these table walks.

Definition at line 842 of file table_walker.hh.

Referenced by doL1DescriptorWrapper(), doL2DescriptorWrapper(), doLongDescriptorWrapper(), getTlb(), init(), insertTableEntry(), processWalkWrapper(), and testWalk().

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

arch/arm/table_walker.hh
arch/arm/table_walker.cc

Classes

Public Types

Public Member Functions

Static Public Member Functions

Protected Attributes

Static Protected Attributes

Private Member Functions

Static Private Member Functions

Private Attributes

Additional Inherited Members

Detailed Description

Member Typedef Documentation

◆ Params

Member Enumeration Documentation

◆ GrainSize

Constructor & Destructor Documentation

◆ TableWalker()

◆ ~TableWalker()

Member Function Documentation

◆ adjustTableSizeAArch64()

◆ checkAddrSizeFaultAArch64()

◆ completeDrain()

◆ doL0LongDescriptorWrapper()

◆ doL1Descriptor()

◆ doL1DescriptorWrapper()

◆ doL1LongDescriptorWrapper()

◆ doL2Descriptor()

◆ doL2DescriptorWrapper()

◆ doL2LongDescriptorWrapper()

◆ doL3LongDescriptorWrapper()

◆ doLongDescriptor()

◆ doLongDescriptorWrapper()

◆ drain()

◆ drainResume()

◆ fetchDescriptor()

◆ generateLongDescFault()

◆ getPort()

◆ getTlb()

◆ haveLargeAsid64()

◆ haveLPAE()

◆ haveVirtualization()

◆ init()

◆ insertTableEntry()

◆ memAttrs()

◆ memAttrsAArch64()

◆ memAttrsLPAE()

◆ nextWalk()

◆ pageSizeNtoStatBin()

◆ params()

◆ pendingChange()

◆ processWalk()

◆ processWalkAArch64()

◆ processWalkLPAE()

◆ processWalkWrapper()

◆ regStats()

◆ setMMU()

◆ setTlb()

◆ testWalk()

◆ toLookupLevel()

◆ walk()

Member Data Documentation

◆ _haveLargeAsid64

◆ _haveLPAE

◆ _haveVirtualization

◆ COMPLETED

◆ currState

◆ doL0LongDescEvent

◆ doL1DescEvent

◆ doL1LongDescEvent

◆ doL2DescEvent

◆ doL2LongDescEvent

◆ doL3LongDescEvent

◆ doProcessEvent

◆ haveSecurity

◆ isStage2

◆ LongDescEventByLevel

◆ masterId

◆ numSquashable

◆ pending

◆ pendingChangeTick