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

#include <system.hh>

Inheritance diagram for LinuxArmSystem:
GenericArmSystem ArmSystem System MemObject ClockedObject SimObject Clocked EventManager Serializable Drainable

Public Types

typedef LinuxArmSystemParams Params
 Boilerplate params code. More...
 
- Public Types inherited from GenericArmSystem
typedef GenericArmSystemParams Params
 
- Public Types inherited from ArmSystem
typedef ArmSystemParams Params
 
- Public Types inherited from System
typedef SystemParams Params
 
- Public Types inherited from MemObject
typedef MemObjectParams Params
 
- Public Types inherited from ClockedObject
typedef ClockedObjectParams Params
 Parameters of ClockedObject. More...
 
- Public Types inherited from SimObject
typedef SimObjectParams Params
 

Public Member Functions

const Paramsparams () const
 
 LinuxArmSystem (Params *p)
 
 ~LinuxArmSystem ()
 
void initState ()
 Initialise the system. More...
 
void startup ()
 startup() is the final initialization call before simulation. More...
 
void mapPid (ThreadContext *tc, uint32_t pid)
 This function creates a new task Id for the given pid. More...
 
void dumpDmesg ()
 Dump the kernel's dmesg buffer to stdout. More...
 
- Public Member Functions inherited from GenericArmSystem
const Paramsparams () const
 
 GenericArmSystem (Params *p)
 
virtual ~GenericArmSystem ()
 
- Public Member Functions inherited from ArmSystem
const Paramsparams () const
 
 ArmSystem (Params *p)
 
 ~ArmSystem ()
 
virtual Addr fixFuncEventAddr (Addr addr)
 Fix up an address used to match PCs for hooking simulator events on to target function executions. More...
 
bool haveSecurity () const
 Returns true if this system implements the Security Extensions. More...
 
bool haveLPAE () const
 Returns true if this system implements the Large Physical Address Extension. More...
 
bool haveVirtualization () const
 Returns true if this system implements the virtualization Extensions. More...
 
void setGenericTimer (GenericTimer *generic_timer)
 Sets the pointer to the Generic Timer. More...
 
GenericTimergetGenericTimer () const
 Get a pointer to the system's generic timer model. More...
 
bool highestELIs64 () const
 Returns true if the register width of the highest implemented exception level is 64 bits (ARMv8) More...
 
ExceptionLevel highestEL () const
 Returns the highest implemented exception level. More...
 
Addr resetAddr64 () const
 Returns the reset address if the highest implemented exception level is 64 bits (ARMv8) More...
 
bool haveLargeAsid64 () const
 Returns true if ASID is 16 bits in AArch64 (ARMv8) More...
 
uint8_t physAddrRange64 () const
 Returns the supported physical address range in bits if the highest implemented exception level is 64 bits (ARMv8) More...
 
uint8_t physAddrRange () const
 Returns the supported physical address range in bits. More...
 
Addr physAddrMask () const
 Returns the physical address mask. More...
 
const AddrRangem5opRange () const
 Range used by memory-mapped m5 pseudo-ops if enabled. More...
 
- Public Member Functions inherited from System
void init () override
 After all objects have been created and all ports are connected, check that the system port is connected. More...
 
MasterPortgetSystemPort ()
 Get a reference to the system port that can be used by non-structural simulation objects like processes or threads, or external entities like loaders and debuggers, etc, to access the memory system. More...
 
BaseMasterPortgetMasterPort (const std::string &if_name, PortID idx=InvalidPortID) override
 Additional function to return the Port of a memory object. More...
 
unsigned int cacheLineSize () const
 Get the cache line size of the system. More...
 
ThreadContextgetThreadContext (ContextID tid)
 
int numContexts ()
 
int numRunningContexts ()
 Return number of running (non-halted) thread contexts in system. More...
 
KvmVMgetKvmVM ()
 Get a pointer to the Kernel Virtual Machine (KVM) SimObject, if present. More...
 
PhysicalMemorygetPhysMem ()
 Get a pointer to access the physical memory of the system. More...
 
Addr freeMemSize () const
 Amount of physical memory that is still free. More...
 
Addr memSize () const
 Amount of physical memory that exists. More...
 
bool isMemAddr (Addr addr) const
 Check if a physical address is within a range of a memory that is part of the global address map. More...
 
Arch getArch () const
 Get the architecture. More...
 
Addr getPageBytes () const
 Get the page bytes for the ISA. More...
 
Addr getPageShift () const
 Get the number of bits worth of in-page address for the ISA. More...
 
ThermalModelgetThermalModel () const
 The thermal model used for this system (if any). More...
 
MasterID getMasterId (std::string req_name)
 Request an id used to create a request object in the system. More...
 
std::string getMasterName (MasterID master_id)
 Get the name of an object for a given request id. More...
 
MasterID maxMasters ()
 Get the number of masters registered in the system. More...
 
void regStats () override
 Register statistics for this object. More...
 
uint64_t incWorkItemsBegin ()
 Called by pseudo_inst to track the number of work items started by this system. More...
 
uint64_t incWorkItemsEnd ()
 Called by pseudo_inst to track the number of work items completed by this system. More...
 
int markWorkItem (int index)
 Called by pseudo_inst to mark the cpus actively executing work items. More...
 
void workItemBegin (uint32_t tid, uint32_t workid)
 
void workItemEnd (uint32_t tid, uint32_t workid)
 
bool breakpoint ()
 
 System (Params *p)
 
 ~System ()
 
void initState () override
 initState() is called on each SimObject when not restoring from a checkpoint. More...
 
const Paramsparams () const
 
Addr getKernelStart () const
 Returns the address the kernel starts at. More...
 
Addr getKernelEnd () const
 Returns the address the kernel ends at. More...
 
Addr getKernelEntry () const
 Returns the address the entry point to the kernel code. More...
 
Addr allocPhysPages (int npages)
 Allocate npages contiguous unused physical pages. More...
 
ContextID registerThreadContext (ThreadContext *tc, ContextID assigned=InvalidContextID)
 
void replaceThreadContext (ThreadContext *tc, ContextID context_id)
 
void serialize (CheckpointOut &cp) const override
 Serialize an object. More...
 
void unserialize (CheckpointIn &cp) override
 Unserialize an object. More...
 
void drainResume () override
 Resume execution after a successful drain. More...
 
bool isAtomicMode () const
 Is the system in atomic mode? More...
 
bool isTimingMode () const
 Is the system in timing mode? More...
 
bool bypassCaches () const
 Should caches be bypassed? More...
 
Enums::MemoryMode getMemoryMode () const
 Get the memory mode of the system. More...
 
void setMemoryMode (Enums::MemoryMode mode)
 Change the memory mode of the system. More...
 
template<class T , typename... Args>
T * addFuncEvent (const SymbolTable *symtab, const char *lbl, const std::string &desc, Args...args)
 Add a function-based event to the given function, to be looked up in the specified symbol table. More...
 
template<class T >
T * addFuncEvent (const SymbolTable *symtab, const char *lbl)
 
template<class T , typename... Args>
T * addFuncEventOrPanic (const SymbolTable *symtab, const char *lbl, Args...args)
 
template<class T , typename... Args>
T * addKernelFuncEvent (const char *lbl, Args...args)
 Add a function-based event to a kernel symbol. More...
 
template<class T , typename... Args>
T * addKernelFuncEventOrPanic (const char *lbl, Args...args)
 
- Public Member Functions inherited from MemObject
const Paramsparams () const
 
 MemObject (const Params *params)
 
virtual BaseSlavePortgetSlavePort (const std::string &if_name, PortID idx=InvalidPortID)
 Get a slave port with a given name and index. More...
 
- Public Member Functions inherited from ClockedObject
 ClockedObject (const ClockedObjectParams *p)
 
const Paramsparams () const
 
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 Paramsparams () 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 resetStats ()
 Reset statistics associated with this object. More...
 
virtual void regProbePoints ()
 Register probe points for this object. More...
 
virtual void regProbeListeners ()
 Register probe listeners for this object. More...
 
ProbeManagergetProbeManager ()
 Get the probe manager for this object. 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...
 
- Public Member Functions inherited from EventManager
 EventManager (EventManager &em)
 
 EventManager (EventManager *em)
 
 EventManager (EventQueue *eq)
 
EventQueueeventQueue () 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 Clocked
void updateClockPeriod () const
 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
 

Public Attributes

bool enableContextSwitchStatsDump
 When enabled, dump stats/task info on context switches for Streamline and per-thread cache occupancy studies, etc. More...
 
std::map< uint32_t, uint32_t > taskMap
 This map stores a mapping of OS process IDs to internal Task IDs. More...
 
OutputStreamtaskFile
 This is a file that is placed in the run directory that prints out mappings between taskIds and OS process IDs. More...
 
- Public Attributes inherited from ArmSystem
bool multiProc
 true if this a multiprocessor system More...
 
- Public Attributes inherited from System
std::vector< ThreadContext * > threadContexts
 
int _numContexts
 
const bool multiThread
 
Addr pagePtr
 
uint64_t init_param
 
PortProxy physProxy
 Port to physical memory used for writing object files into ram at boot. More...
 
SymbolTablekernelSymtab
 kernel symbol table More...
 
ObjectFilekernel
 Object pointer for the kernel code. More...
 
Addr kernelStart
 Beginning of kernel code. More...
 
Addr kernelEnd
 End of kernel code. More...
 
Addr kernelEntry
 Entry point in the kernel to start at. More...
 
Addr loadAddrMask
 Mask that should be anded for binary/symbol loading. More...
 
Addr loadAddrOffset
 Offset that should be used for binary/symbol loading. More...
 
std::vector< BaseRemoteGDB * > remoteGDB
 
std::vector< GDBListener * > gdbListen
 
Counter totalNumInsts
 
EventQueue instEventQueue
 
std::map< std::pair< uint32_t,
uint32_t >, Tick
lastWorkItemStarted
 
std::map< uint32_t,
Stats::Histogram * > 
workItemStats
 
FutexMap futexMap
 
std::set< int > PIDs
 Process set to track which PIDs have already been allocated. More...
 
std::list< BasicSignalsignalList
 

Protected Attributes

DumpStatsPCEventdumpStatsPCEvent
 
- Protected Attributes inherited from ArmSystem
Linux::DebugPrintkEventdebugPrintkEvent
 PC based event to skip the dprink() call and emulate its functionality. More...
 
std::vector< std::unique_ptr
< ObjectFile > > 
bootLoaders
 Bootloaders. More...
 
ObjectFilebootldr
 Pointer to the bootloader object. More...
 
const bool _haveSecurity
 True if this system implements the Security Extensions. More...
 
const bool _haveLPAE
 True if this system implements the Large Physical Address Extension. More...
 
const bool _haveVirtualization
 True if this system implements the virtualization Extensions. More...
 
GenericTimer_genericTimer
 Pointer to the Generic Timer wrapper. More...
 
bool _highestELIs64
 True if the register width of the highest implemented exception level is 64 bits (ARMv8) More...
 
const Addr _resetAddr64
 Reset address if the highest implemented exception level is 64 bits (ARMv8) More...
 
const uint8_t _physAddrRange64
 Supported physical address range in bits if the highest implemented exception level is 64 bits (ARMv8) More...
 
const bool _haveLargeAsid64
 True if ASID is 16 bits in AArch64 (ARMv8) More...
 
const AddrRange _m5opRange
 Range for memory-mapped m5 pseudo ops. More...
 
- Protected Attributes inherited from System
KvmVM *const kvmVM
 
PhysicalMemory physmem
 
Enums::MemoryMode memoryMode
 
const unsigned int _cacheLineSize
 
uint64_t workItemsBegin
 
uint64_t workItemsEnd
 
uint32_t numWorkIds
 
std::vector< bool > activeCpus
 
std::vector< std::string > masterIds
 This array is a per-system list of all devices capable of issuing a memory system request and an associated string for each master id. More...
 
ThermalModelthermalModel
 
Params_params
 
- Protected Attributes inherited from ClockedObject
Enums::PwrState _currPwrState
 To keep track of the current power state. More...
 
Tick prvEvalTick
 
Stats::Scalar numPwrStateTransitions
 
Stats::Distribution pwrStateClkGateDist
 
Stats::Vector pwrStateResidencyTicks
 
- Protected Attributes inherited from SimObject
const SimObjectParams * _params
 Cached copy of the object parameters. More...
 
- Protected Attributes inherited from EventManager
EventQueueeventq
 A pointer to this object's event queue. More...
 

Private Attributes

PCEventkernelPanicEvent
 Event to halt the simulator if the kernel calls panic() More...
 
PCEventkernelOopsEvent
 Event to halt the simulator if the kernel calls oopses. More...
 
Linux::UDelayEventuDelaySkipEvent
 PC based event to skip udelay(<time>) calls and quiesce the processor for the appropriate amount of time. More...
 
Linux::UDelayEventconstUDelaySkipEvent
 Another PC based skip event for const_udelay(). More...
 

Additional Inherited Members

- Static Public Member Functions inherited from ArmSystem
static bool haveSecurity (ThreadContext *tc)
 Returns true if the system of a specific thread context implements the Security Extensions. More...
 
static bool haveVirtualization (ThreadContext *tc)
 Returns true if the system of a specific thread context implements the virtualization Extensions. More...
 
static bool haveLPAE (ThreadContext *tc)
 Returns true if the system of a specific thread context implements the Large Physical Address Extension. More...
 
static bool highestELIs64 (ThreadContext *tc)
 Returns true if the register width of the highest implemented exception level for the system of a specific thread context is 64 bits (ARMv8) More...
 
static ExceptionLevel highestEL (ThreadContext *tc)
 Returns the highest implemented exception level for the system of a specific thread context. More...
 
static Addr resetAddr64 (ThreadContext *tc)
 Returns the reset address if the highest implemented exception level for the system of a specific thread context is 64 bits (ARMv8) More...
 
static uint8_t physAddrRange (ThreadContext *tc)
 Returns the supported physical address range in bits for the system of a specific thread context. More...
 
static Addr physAddrMask (ThreadContext *tc)
 Returns the physical address mask for the system of a specific thread context. More...
 
static bool haveLargeAsid64 (ThreadContext *tc)
 Returns true if ASID is 16 bits for the system of a specific thread context while in AArch64 (ARMv8) More...
 
- Static Public Member Functions inherited from System
static void printSystems ()
 
- Static Public Member Functions inherited from SimObject
static void serializeAll (CheckpointOut &cp)
 Serialize all SimObjects in the system. More...
 
static SimObjectfind (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)
 
- Static Public Attributes inherited from System
static std::vector< System * > systemList
 
static int numSystemsRunning = 0
 
static const int maxPID = 32768
 
- Static Public Attributes inherited from Serializable
static int ckptCount = 0
 
static int ckptMaxCount = 0
 
static int ckptPrevCount = -1
 
- Protected Member Functions inherited from ArmSystem
ObjectFilegetBootLoader (ObjectFile *const obj)
 Get a boot loader that matches the kernel. More...
 
- Protected Member Functions inherited from System
virtual void serializeSymtab (CheckpointOut &os) const
 If needed, serialize additional symbol table entries for a specific subclass of this system. More...
 
virtual void unserializeSymtab (CheckpointIn &cp)
 If needed, unserialize additional symbol table entries for a specific subclass of this system. More...
 
- 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
 
Clockedoperator= (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...
 

Detailed Description

Definition at line 59 of file system.hh.

Member Typedef Documentation

typedef LinuxArmSystemParams LinuxArmSystem::Params

Boilerplate params code.

Definition at line 66 of file system.hh.

Constructor & Destructor Documentation

LinuxArmSystem::LinuxArmSystem ( Params p)
LinuxArmSystem::~LinuxArmSystem ( )

Definition at line 218 of file system.cc.

References constUDelaySkipEvent, dumpStatsPCEvent, and uDelaySkipEvent.

Member Function Documentation

void LinuxArmSystem::dumpDmesg ( )

Dump the kernel's dmesg buffer to stdout.

Definition at line 274 of file system.cc.

References Linux::dumpDmesg(), and System::getThreadContext().

void LinuxArmSystem::initState ( )
virtual
void LinuxArmSystem::mapPid ( ThreadContext tc,
uint32_t  pid 
)

This function creates a new task Id for the given pid.

Parameters
tcthread context that is currentyl executing

Definition at line 258 of file system.cc.

References ContextSwitchTaskId::MaxNormalTaskId, taskMap, ContextSwitchTaskId::Unknown, and warn_once.

Referenced by DumpStatsPCEvent::process(), and startup().

const Params* LinuxArmSystem::params ( ) const
inline

Definition at line 68 of file system.hh.

References System::_params.

Referenced by initState().

void LinuxArmSystem::startup ( )
virtual

startup() is the final initialization call before simulation.

All state is initialized (including unserialized state, if any, such as the curTick() value), so this is the appropriate place to schedule initial event(s) for objects that need them.

Reimplemented from SimObject.

Definition at line 236 of file system.cc.

References System::_numContexts, OutputDirectory::create(), dumpStatsPCEvent, enableContextSwitchStatsDump, ThreadContext::getCpuPtr(), ArmISA::i, mapPid(), SimObject::name(), panic, simout, taskFile, taskMap, and System::threadContexts.

Member Data Documentation

Linux::UDelayEvent* LinuxArmSystem::constUDelaySkipEvent
private

Another PC based skip event for const_udelay().

Similar to the udelay skip, but this function precomputes the first multiply that is done in the generic case since the parameter is known at compile time. Thus we need to do some division to get back to us.

Definition at line 123 of file system.hh.

Referenced by LinuxArmSystem(), and ~LinuxArmSystem().

DumpStatsPCEvent* LinuxArmSystem::dumpStatsPCEvent
protected

Definition at line 62 of file system.hh.

Referenced by startup(), and ~LinuxArmSystem().

bool LinuxArmSystem::enableContextSwitchStatsDump

When enabled, dump stats/task info on context switches for Streamline and per-thread cache occupancy studies, etc.

Definition at line 75 of file system.hh.

Referenced by startup().

PCEvent* LinuxArmSystem::kernelOopsEvent
private

Event to halt the simulator if the kernel calls oopses.

Definition at line 109 of file system.hh.

Referenced by LinuxArmSystem().

PCEvent* LinuxArmSystem::kernelPanicEvent
private

Event to halt the simulator if the kernel calls panic()

Definition at line 106 of file system.hh.

Referenced by LinuxArmSystem().

OutputStream* LinuxArmSystem::taskFile

This is a file that is placed in the run directory that prints out mappings between taskIds and OS process IDs.

Definition at line 85 of file system.hh.

Referenced by DumpStatsPCEvent::process(), and startup().

std::map<uint32_t, uint32_t> LinuxArmSystem::taskMap

This map stores a mapping of OS process IDs to internal Task IDs.

The mapping is done because the stats system doesn't tend to like vectors that are much greater than 1000 items and the entire process space is 65K.

Definition at line 81 of file system.hh.

Referenced by mapPid(), DumpStatsPCEvent::process(), and startup().

Linux::UDelayEvent* LinuxArmSystem::uDelaySkipEvent
private

PC based event to skip udelay(<time>) calls and quiesce the processor for the appropriate amount of time.

This is not functionally required but does speed up simulation.

Definition at line 116 of file system.hh.

Referenced by LinuxArmSystem(), and ~LinuxArmSystem().


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

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