These methods related to the "Serialize" interface. More...

Macros
#define	UNSERIALIZE_OPT_SCALAR(scalar) optParamIn(cp, #scalar, scalar)

#define	SERIALIZE_ENUM(scalar) paramOut(cp, #scalar, (int)scalar)

#define	UNSERIALIZE_ENUM(scalar)

#define	SERIALIZE_ARRAY(member, size) arrayParamOut(cp, #member, member, size)

#define	UNSERIALIZE_ARRAY(member, size) arrayParamIn(cp, #member, member, size)

#define	SERIALIZE_CONTAINER(member) arrayParamOut(cp, #member, member)

#define	UNSERIALIZE_CONTAINER(member) arrayParamIn(cp, #member, member)

#define	SERIALIZE_EVENT(event) event.serializeSection(cp, #event);

#define	UNSERIALIZE_EVENT(event)

#define	SERIALIZE_OBJ(obj) obj.serializeSection(cp, #obj)

#define	UNSERIALIZE_OBJ(obj) obj.unserializeSection(cp, #obj)

#define	SERIALIZE_OBJPTR(objptr) paramOut(cp, #objptr, (objptr)->name())

#define	UNSERIALIZE_OBJPTR(objptr)

Functions
static std::string	CheckpointIn::setDir (const std::string &base_name)
	Set the current directory. More...

static std::string	CheckpointIn::dir ()
	Get the current checkout directory name. More...

	Serializable::Serializable ()

virtual void	Serializable::serialize (CheckpointOut &cp) const =0
	Serialize an object. More...

virtual void	Serializable::unserialize (CheckpointIn &cp)=0
	Unserialize an object. More...

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

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

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

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

static const std::string &	Serializable::currentSection ()
	Gets the fully-qualified name of the active section. More...

static void	Serializable::serializeAll (const std::string &cpt_dir)
	Serializes all the SimObjects. More...

static void	Serializable::unserializeGlobals (CheckpointIn &cp)

template<class T >
bool	parseParam (const std::string &s, T &value)

template<class T >
void	showParam (CheckpointOut &os, const T &value)

template<class T >
bool	parseParam (const std::string &s, BitUnionType< T > &value)

template<class T >
void	showParam (CheckpointOut &os, const BitUnionType< T > &value)

template<>
void	showParam (CheckpointOut &os, const char &value)

template<>
void	showParam (CheckpointOut &os, const signed char &value)

template<>
void	showParam (CheckpointOut &os, const unsigned char &value)

template<>
bool	parseParam (const std::string &s, float &value)

template<>
bool	parseParam (const std::string &s, double &value)

template<>
bool	parseParam (const std::string &s, bool &value)

template<>
void	showParam (CheckpointOut &os, const bool &value)

template<>
bool	parseParam (const std::string &s, std::string &value)

template<class T >
void	paramOut (CheckpointOut &os, const std::string &name, const T &param)
	This function is used for writing parameters to a checkpoint. More...

template<class T >
void	paramIn (CheckpointIn &cp, const std::string &name, T &param)
	This function is used for restoring parameters from a checkpoint. More...

template<class T >
bool	optParamIn (CheckpointIn &cp, const std::string &name, T &param, bool warn=true)
	This function is used for restoring optional parameters from the checkpoint. More...

template<class T >
void	arrayParamOut (CheckpointOut &os, const std::string &name, const std::vector< T > &param)

template<class T >
void	arrayParamOut (CheckpointOut &os, const std::string &name, const std::list< T > &param)

template<class T >
void	arrayParamOut (CheckpointOut &os, const std::string &name, const std::set< T > &param)

template<class T >
void	arrayParamOut (CheckpointOut &os, const std::string &name, const T *param, unsigned size)

template<class T >
void	arrayParamIn (CheckpointIn &cp, const std::string &name, T *param, unsigned size)
	Extract values stored in the checkpoint, and assign them to the provided array container. More...

template<class T >
void	arrayParamIn (CheckpointIn &cp, const std::string &name, std::vector< T > &param)

template<class T >
void	arrayParamIn (CheckpointIn &cp, const std::string &name, std::list< T > &param)

template<class T >
void	arrayParamIn (CheckpointIn &cp, const std::string &name, std::set< T > &param)

void	objParamIn (CheckpointIn &cp, const std::string &name, SimObject *&param)

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

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

virtual SimObject *	SimObjectResolver::resolveSimObject (const std::string &name)=0
	Find a SimObject given a full path name. More...

const std::string	CheckpointIn::getCptDir ()

bool	CheckpointIn::find (const std::string &section, const std::string &entry, std::string &value)

bool	CheckpointIn::findObj (const std::string &section, const std::string &entry, SimObject *&value)

bool	CheckpointIn::entryExists (const std::string &section, const std::string &entry)

bool	CheckpointIn::sectionExists (const std::string &section)

template<class CP >
	Serializable::ScopedCheckpointSection::ScopedCheckpointSection (CP &cp, const char *name)
	This is the constructor for Scoped checkpoint section helper class. More...

template<class CP >
	Serializable::ScopedCheckpointSection::ScopedCheckpointSection (CP &cp, const std::string &name)

Detailed Description

These methods related to the "Serialize" interface.

Macro Definition Documentation

◆ SERIALIZE_ARRAY

#define SERIALIZE_ARRAY	(	member,
		size
	)	arrayParamOut(cp, #member, member, size)

Definition at line 832 of file serialize.hh.

◆ SERIALIZE_CONTAINER

#define SERIALIZE_CONTAINER ( member ) arrayParamOut(cp, #member, member)

Definition at line 848 of file serialize.hh.

◆ SERIALIZE_ENUM

#define SERIALIZE_ENUM ( scalar ) paramOut(cp, #scalar, (int)scalar)

Definition at line 813 of file serialize.hh.

◆ SERIALIZE_EVENT

#define SERIALIZE_EVENT ( event ) event.serializeSection(cp, #event);

Definition at line 864 of file serialize.hh.

◆ SERIALIZE_OBJ

#define SERIALIZE_OBJ ( obj ) obj.serializeSection(cp, #obj)

Definition at line 882 of file serialize.hh.

◆ SERIALIZE_OBJPTR

#define SERIALIZE_OBJPTR ( objptr ) paramOut(cp, #objptr, (objptr)->name())

Definition at line 896 of file serialize.hh.

◆ UNSERIALIZE_ARRAY

#define UNSERIALIZE_ARRAY	(	member,
		size
	)	arrayParamIn(cp, #member, member, size)

Definition at line 840 of file serialize.hh.

◆ UNSERIALIZE_CONTAINER

#define UNSERIALIZE_CONTAINER ( member ) arrayParamIn(cp, #member, member)

Definition at line 856 of file serialize.hh.

◆ UNSERIALIZE_ENUM

#define UNSERIALIZE_ENUM ( scalar )

Value:

    do {                                                \
        int tmp;                                        \
        paramIn(cp, #scalar, tmp);                      \
        scalar = static_cast<decltype(scalar)>(tmp);    \
    } while (0)

Definition at line 820 of file serialize.hh.

◆ UNSERIALIZE_EVENT

#define UNSERIALIZE_EVENT ( event )

Value:

    do {                                                \
        event.unserializeSection(cp, #event);           \
        eventQueue()->checkpointReschedule(&event);     \
    } while (0)

Definition at line 871 of file serialize.hh.

◆ UNSERIALIZE_OBJ

#define UNSERIALIZE_OBJ ( obj ) obj.unserializeSection(cp, #obj)

Definition at line 889 of file serialize.hh.

◆ UNSERIALIZE_OBJPTR

#define UNSERIALIZE_OBJPTR ( objptr )

Value:

    do {                                                \
        SimObject *sptr;                                \
        objParamIn(cp, #objptr, sptr);                  \
        objptr = dynamic_cast<decltype(objptr)>(sptr);  \
    } while (0)

Definition at line 903 of file serialize.hh.

◆ UNSERIALIZE_OPT_SCALAR

#define UNSERIALIZE_OPT_SCALAR ( scalar ) optParamIn(cp, #scalar, scalar)

Definition at line 804 of file serialize.hh.

Function Documentation

◆ arrayParamIn() [1/4]

template<class T >

void arrayParamIn	(	CheckpointIn &	cp,
		const std::string &	name,
		std::list< T > &	param
	)

Definition at line 708 of file serialize.hh.

References Serializable::currentSection(), ArmISA::err, fatal, ArmISA::i, name(), parseParam(), and tokenize().

◆ arrayParamIn() [2/4]

template<class T >

void arrayParamIn	(	CheckpointIn &	cp,
		const std::string &	name,
		std::set< T > &	param
	)

Definition at line 741 of file serialize.hh.

References Serializable::currentSection(), ArmISA::err, fatal, ArmISA::i, name(), parseParam(), and tokenize().

◆ arrayParamIn() [3/4]

template<class T >

void arrayParamIn	(	CheckpointIn &	cp,
		const std::string &	name,
		std::vector< T > &	param
	)

Definition at line 663 of file serialize.hh.

References Serializable::currentSection(), ArmISA::err, fatal, ArmISA::i, name(), parseParam(), and tokenize().

◆ arrayParamIn() [4/4]

template<class T >

void arrayParamIn	(	CheckpointIn &	cp,
		const std::string &	name,
		T *	param,
		unsigned	size
	)

Extract values stored in the checkpoint, and assign them to the provided array container.

Parameters

cp	The checkpoint to be parsed.
name	Name of the container.
param	The array container.
size	The expected number of entries to be extracted.

Definition at line 615 of file serialize.hh.

References Serializable::currentSection(), ArmISA::err, fatal, fatal_if, ArmISA::i, name(), parseParam(), and tokenize().

◆ arrayParamOut() [1/4]

template<class T >

void arrayParamOut	(	CheckpointOut &	os,
		const std::string &	name,
		const std::list< T > &	param
	)

Definition at line 545 of file serialize.hh.

References name(), X86ISA::os, and showParam().

◆ arrayParamOut() [2/4]

template<class T >

void arrayParamOut	(	CheckpointOut &	os,
		const std::string &	name,
		const std::set< T > &	param
	)

Definition at line 567 of file serialize.hh.

References name(), X86ISA::os, and showParam().

◆ arrayParamOut() [3/4]

template<class T >

void arrayParamOut	(	CheckpointOut &	os,
		const std::string &	name,
		const std::vector< T > &	param
	)

Definition at line 526 of file serialize.hh.

References ArmISA::i, name(), X86ISA::os, and showParam().

◆ arrayParamOut() [4/4]

template<class T >

void arrayParamOut	(	CheckpointOut &	os,
		const std::string &	name,
		const T *	param,
		unsigned	size
	)

Definition at line 589 of file serialize.hh.

References ArmISA::i, name(), X86ISA::os, and showParam().

◆ currentSection()

const std::string & Serializable::currentSection ( )

static

Gets the fully-qualified name of the active section.

Definition at line 239 of file serialize.cc.

Referenced by arrayParamIn(), ArmSemihosting::FileBase::create(), Serializable::ScopedCheckpointSection::nameOut(), objParamIn(), optParamIn(), paramIn(), Globals::unserialize(), HDLcd::unserialize(), and GicV2::unserialize().

◆ dir()

string CheckpointIn::dir ( )

static

Get the current checkout directory name.

This function exports the current checkout point directory name so other objects can derive filenames from it (e.g., memory). The return value is guaranteed to end in '/' so filenames can be directly appended. This function is only valid while a checkpoint is being created.

Definition at line 263 of file serialize.cc.

Referenced by CowDiskImage::serialize(), PhysicalMemory::serializeStore(), and RubySystem::writeCompressedTrace().

◆ entryExists()

bool CheckpointIn::entryExists	(	const std::string &	section,
		const std::string &	entry
	)

Parameters

section	Here we mention the section we are looking for (example: currentsection).
entry	Mention the entry we are looking for (example: interrupt time) in the section.

Returns: Returns true if the entry exists in the named section we are looking in.

Definition at line 291 of file serialize.cc.

References CheckpointIn::db, and IniFile::entryExists().

◆ find()

bool CheckpointIn::find	(	const std::string &	section,
		const std::string &	entry,
		std::string &	value
	)

Parameters

section	Here we mention the section we are looking for (example: currentsection).
entry	Mention the entry we are looking for (example: Cache line size etc) in the section.
value	Give the value at the said entry.

Returns: Returns true if the searched parameter exists with the value, given the section .

Definition at line 306 of file serialize.cc.

References CheckpointIn::db, and IniFile::find().

◆ findObj()

bool CheckpointIn::findObj	(	const std::string &	section,
		const std::string &	entry,
		SimObject *&	value
	)

Parameters

section	Here we mention the section we are looking for (example: currentsection).
entry	Mention the SimObject we are looking for (example: interruput time) in the section.
value	Give the value at the said entry.

Returns: Returns true if a SimObject exists in the section.

Definition at line 321 of file serialize.cc.

References CheckpointIn::db, IniFile::find(), CheckpointIn::objNameResolver, and SimObjectResolver::resolveSimObject().

◆ getCptDir()

const std::string CheckpointIn::getCptDir ( )

inline

Returns: Returns the current directory being used for creating checkpoints or restoring checkpoints.

Definition at line 87 of file serialize.hh.

References CheckpointIn::_cptDir.

Referenced by CheckpointIn::CheckpointIn().

◆ initState()

void SimObject::initState ( )

virtual

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

This provides a hook for state initializations that are only required for a "cold start".

Reimplemented in AbstractMemory, Sparc64Process, X86ISA::I386Process, Sparc32Process, TrafficGen, X86ISA::X86_64Process, ArmProcess64, ArmISA::FsWorkload, ArmISA::FsLinux, KernelWorkload, ArmFreebsdProcess64, ArmLinuxProcess64, RiscvProcess32, RiscvProcess64, X86ISA::FsWorkload, ArmFreebsdProcess32, ArmLinuxProcess32, ArmProcess32, Process, ArmISA::FsFreebsd, X86ISA::FsLinux, SparcProcess, PowerProcess, RiscvISA::BareMetal, SparcISA::FsWorkload, PowerLinuxProcess, and MipsProcess.

Definition at line 91 of file sim_object.cc.

Referenced by SparcISA::FsWorkload::initState(), RiscvISA::BareMetal::initState(), TrafficGen::initState(), AbstractMemory::initState(), and CxxConfigManager::initState().

◆ loadState()

void SimObject::loadState ( CheckpointIn & cp )

virtual

loadState() is called on each SimObject when restoring from a checkpoint.

The default implementation simply calls unserialize() if there is a corresponding section in the checkpoint. However, objects can override loadState() to get other behaviors, e.g., doing other programmed initializations after unserialize(), or complaining if no checkpoint section is found.

Parameters

cp	Checkpoint to restore the state from.

Definition at line 78 of file sim_object.cc.

References DPRINTF, SimObject::name(), and Serializable::unserializeSection().

◆ objParamIn()

void objParamIn	(	CheckpointIn &	cp,
		const std::string &	name,
		SimObject *&	param
	)

◆ optParamIn()

template<class T >

bool optParamIn	(	CheckpointIn &	cp,
		const std::string &	name,
		T &	param,
		bool	warn = `true`
	)

This function is used for restoring optional parameters from the checkpoint.

Parameters

cp	The checkpoint to be written to.
name	Name of the parameter to be written.
param	Value of the parameter to be written.
warn	If the warn is set to true then the function prints the warning message.

Returns: If the parameter we are searching for does not exist the function returns false else it returns true.

Definition at line 507 of file serialize.hh.

References Serializable::currentSection(), name(), parseParam(), and warn.

Referenced by EthPacketData::unserialize(), Random::unserialize(), EtherLink::Link::unserialize(), Ticked::unserialize(), Loader::SymbolTable::unserialize(), and System::unserialize().

◆ paramIn()

template<class T >

void paramIn	(	CheckpointIn &	cp,
		const std::string &	name,
		T &	param
	)

This function is used for restoring parameters from a checkpoint.

Parameters

os	The checkpoint to be restored from.
name	Name of the parameter to be set.
param	Value of the parameter to be restored.

Definition at line 483 of file serialize.hh.

References Serializable::currentSection(), fatal, name(), and parseParam().

◆ paramOut()

template<class T >

void paramOut	(	CheckpointOut &	os,
		const std::string &	name,
		const T &	param
	)

This function is used for writing parameters to a checkpoint.

Parameters

os	The checkpoint to be written to.
name	Name of the parameter to be set.
param	Value of the parameter to be written.

Definition at line 467 of file serialize.hh.

References name(), X86ISA::os, and showParam().

◆ parseParam() [1/6]

template<class T >

bool parseParam	(	const std::string &	s,
		BitUnionType< T > &	value
	)

Definition at line 349 of file serialize.hh.

References ArmISA::s, and to_number().

◆ parseParam() [2/6]

template<>

bool parseParam	(	const std::string &	s,
		bool &	value
	)

inline

Definition at line 430 of file serialize.hh.

References ArmISA::s, and to_bool().

◆ parseParam() [3/6]

template<>

bool parseParam	(	const std::string &	s,
		double &	value
	)

inline

Definition at line 420 of file serialize.hh.

References ArmISA::s, and to_number().

◆ parseParam() [4/6]

template<>

bool parseParam	(	const std::string &	s,
		float &	value
	)

inline

Definition at line 410 of file serialize.hh.

References ArmISA::s, and to_number().

◆ parseParam() [5/6]

template<>

bool parseParam	(	const std::string &	s,
		std::string &	value
	)

inline

Definition at line 451 of file serialize.hh.

References ArmISA::s.

◆ parseParam() [6/6]

template<class T >

bool parseParam	(	const std::string &	s,
		T &	value
	)

Definition at line 327 of file serialize.hh.

References ArmISA::s, and to_number().

Referenced by arrayParamIn(), optParamIn(), and paramIn().

◆ resolveSimObject()

virtual SimObject* SimObjectResolver::resolveSimObject ( const std::string & name )

pure virtual

Find a SimObject given a full path name.

Implemented in CxxConfigManager::SimObjectResolver, and PybindSimObjectResolver.

Referenced by CheckpointIn::findObj().

◆ ScopedCheckpointSection() [1/2]

template<class CP >

Serializable::ScopedCheckpointSection::ScopedCheckpointSection	(	CP &	cp,
		const char *	name
	)

inline

This is the constructor for Scoped checkpoint section helper class.

Scoped checkpoint helper class creates a section within a checkpoint without the need for a separate serializeable object. It is mainly used within the Serializable class when serializing or unserializing section (see serializeSection() and unserializeSection()). It can also be used to maintain backwards compatibility in existing code that serializes structs that are not inheriting from Serializable into subsections.

When the class is instantiated, it appends a name to the active path in a checkpoint. The old path is later restored when the instance is destroyed. For example, serializeSection() could be implemented by instantiating a ScopedCheckpointSection and then calling serialize() on an object.

Definition at line 200 of file serialize.hh.

References name(), Serializable::ScopedCheckpointSection::nameOut(), and Serializable::ScopedCheckpointSection::pushName().

◆ ScopedCheckpointSection() [2/2]

template<class CP >

Serializable::ScopedCheckpointSection::ScopedCheckpointSection	(	CP &	cp,
		const std::string &	name
	)

inline

Definition at line 206 of file serialize.hh.

References name(), Serializable::ScopedCheckpointSection::nameOut(), and Serializable::ScopedCheckpointSection::pushName().

◆ sectionExists()

bool CheckpointIn::sectionExists ( const std::string & section )

Definition at line 334 of file serialize.cc.

References CheckpointIn::db, and IniFile::sectionExists().

◆ Serializable()

Serializable::Serializable ( )

Definition at line 162 of file serialize.cc.

◆ serialize()

virtual void Serializable::serialize ( CheckpointOut & cp ) const

pure virtual

Serialize an object.

Output an object's state into the current checkpoint section.

Parameters

cp	Checkpoint state

Implemented in DistIface::Sync, BaseCache, ArmISA::ISA, iGbReg::Regs, DistIface, System, VirtIODeviceBase, Event, IGbE, GicV2, GenericISA::DelaySlotUPCState< MachInst >, IGbE::TxDescCache, DistIface::RecvScheduler, ArmISA::PMU::CounterState, GenericTimerFrame, ArmSemihosting::File, HDLcd::DmaEngine, Pl111, ArmSemihosting::FileFeatures, GenericISA::DelaySlotPCState< MachInst >, IdeDisk, GenericTimer::CoreTimers, IGbE::RxDescCache, DistIface::RecvScheduler::Desc, NSGigE, DmaReadFifo, Gicv3CPUInterface, ArmISA::TlbEntry, VirtQueue, ArmISA::Interrupts, Sinic::Device, IGbE::DescCache< T >, IGbE::DescCache< iGbReg::TxDesc >, IGbE::DescCache< iGbReg::RxDesc >, ArmSemihosting::FileBase, GenericISA::UPCState< MachInst >, X86ISA::Interrupts, GenericTimer, DistIface::SyncSwitch, MultiLevelPageTable< EntryTypes >, BasePixelPump::PixelEvent, SimObject, BaseTrafficGen, Gicv3Distributor, SparcISA::Interrupts, PhysicalMemory, ClockedObject, ArchTimer, ArmSemihosting, DistIface::SyncNode, SrcClockDomain, DistEtherLink, PciDevice, Gicv3Redistributor, VirtIO9PProxy, X86ISA::GpuTLB, DeviceFDEntry, RealViewOsc, ArmInterruptPin, GicV2::BankedRegs, VGic, CopyEngineReg::ChanRegs, EtherSwitch, CpuLocalTimer, SMMUv3, SparcISA::TLB, MemState, RealViewCtrl, PipeFDEntry, UFSHostDevice, TickedObject, DVFSHandler, A9GlobalTimer, CopyEngine, SparcISA::ISA, ThermalModel, IdeController, PowerISA::TLB, Sp804, EmulationPageTable, SimpleThread, X86ISA::TLB, EtherLink, BasePixelPump, Gicv3Its, EtherTapStub, I2CBus, CpuLocalTimer::Timer, X86ISA::I8042, SystemCounter, Iob, Ticked, FileFDEntry, Pl050, A9GlobalTimer::Timer, CowDiskImage, MaltaCChip, EnergyCtrl, TrafficGen, MaltaIO, ThermalReference, GenericISA::PCStateBase, Malta, PL031, CopyEngineReg::Regs, VoltageDomain, X86ISA::I8259, Gicv3, Sp804::Timer, X86ISA::I8254, X86ISA::TlbEntry, Random, X86ISA::I82094AA, CopyEngine::CopyEngineChannel, KernelWorkload, Root, RiscvISA::TlbEntry, X86ISA::ISA, ArmISA::PMU, Uart8250, MipsISA::Interrupts, RiscvISA::TLB, HDLcd, X86ISA::Cmos, ThermalDomain, DistEtherLink::Link, ThermalCapacitor, MipsISA::TLB, LocalSimLoopExitEvent, RubySystem, Globals, FrameBuffer, PowerState, X86ISA::Speaker, PollEvent, Sinic::Base, Process, EtherTapBase, GPUDispatcher, FlashDevice, PS2Mouse, ThermalResistor, DisplayTimings, DumbTOD, PS2TouchKit, MmDisk, PS2Keyboard, Pl011, X86ISA::I8237, NoMaliGpu, Iris::Interrupts, Sp805, PS2Device, ThreadState, X86ISA::PCState, EtherSwitch::Interface::PortFifo, RiscvISA::Interrupts, EtherSwitch::Interface::PortFifoEntry, RiscvISA::ISA, EtherSwitch::Interface, FDEntry, and Iris::ISA.

◆ serializeAll()

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

static

Serializes all the SimObjects.

Definition at line 185 of file serialize.cc.

References CheckpointIn::baseFilename, fatal, globals, SimObject::serializeAll(), Serializable::serializeSection(), CheckpointIn::setDir(), and ArmISA::t.

Referenced by debug_serialize(), and pybind_init_core().

◆ serializeSection() [1/2]

void Serializable::serializeSection	(	CheckpointOut &	cp,
		const char *	name
	)		const

Serialize an object into a new section.

This method creates a new section in a checkpoint and calls serialize() to serialize the current object into that section. The name of the section is appended to the current checkpoint path.

Parameters

cp	Checkpoint state
name	Name to append to the active path

Definition at line 171 of file serialize.cc.

References name(), and serialize().

Referenced by ArmISA::PMU::serialize(), Gicv3::serialize(), Sp804::serialize(), CopyEngine::serialize(), CpuLocalTimer::serialize(), VGic::serialize(), DistEtherLink::serialize(), GenericTimer::serialize(), GenericTimerFrame::serialize(), IGbE::serialize(), VirtIODeviceBase::serialize(), System::serialize(), DistIface::serialize(), SimObject::serializeAll(), Serializable::serializeAll(), and Serializable::serializeSection().

◆ serializeSection() [2/2]

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

inline

Definition at line 274 of file serialize.hh.

References name(), and Serializable::serializeSection().

◆ setDir()

string CheckpointIn::setDir ( const std::string & base_name )

static

Set the current directory.

This function takes care of inserting curTick() if there's a 'd' in the argument, and appends a '/' if necessary. The final name is returned.

Definition at line 251 of file serialize.cc.

References csprintf(), curTick(), and name().

Referenced by Serializable::serializeAll().

◆ showParam() [1/6]

template<class T >

void showParam	(	CheckpointOut &	os,
		const BitUnionType< T > &	value
	)

Definition at line 363 of file serialize.hh.

References X86ISA::os.

◆ showParam() [2/6]

template<>

void showParam	(	CheckpointOut &	os,
		const bool &	value
	)

inline

Definition at line 440 of file serialize.hh.

References X86ISA::os.

◆ showParam() [3/6]

template<>

void showParam	(	CheckpointOut &	os,
		const char &	value
	)

inline

Definition at line 379 of file serialize.hh.

References X86ISA::os.

◆ showParam() [4/6]

template<>

void showParam	(	CheckpointOut &	os,
		const signed char &	value
	)

inline

Definition at line 390 of file serialize.hh.

References X86ISA::os.

◆ showParam() [5/6]

template<class T >

void showParam	(	CheckpointOut &	os,
		const T &	value
	)

Definition at line 339 of file serialize.hh.

References X86ISA::os.

Referenced by arrayParamOut(), and paramOut().

◆ showParam() [6/6]

template<>

void showParam	(	CheckpointOut &	os,
		const unsigned char &	value
	)

inline

Definition at line 400 of file serialize.hh.

References X86ISA::os.

◆ unserialize()

virtual void Serializable::unserialize ( CheckpointIn & cp )

pure virtual

Unserialize an object.

Read an object's state from the current checkpoint section.

Parameters

cp	Checkpoint state

Implemented in DistIface::Sync, BaseCache, ArmISA::ISA, iGbReg::Regs, DistIface, System, VirtIODeviceBase, Event, IGbE, GicV2, GenericISA::DelaySlotUPCState< MachInst >, IGbE::TxDescCache, DistIface::RecvScheduler, ArmISA::PMU::CounterState, GenericTimerFrame, ArmSemihosting::File, HDLcd::DmaEngine, GenericISA::DelaySlotPCState< MachInst >, Pl111, ArmSemihosting::FileFeatures, IdeDisk, GenericTimer::CoreTimers, IGbE::RxDescCache, DistIface::RecvScheduler::Desc, NSGigE, DmaReadFifo, ArmISA::TlbEntry, Gicv3CPUInterface, ArmISA::Interrupts, VirtQueue, GenericISA::UPCState< MachInst >, Sinic::Device, IGbE::DescCache< T >, IGbE::DescCache< iGbReg::TxDesc >, IGbE::DescCache< iGbReg::RxDesc >, ArmSemihosting::FileBase, MultiLevelPageTable< EntryTypes >, X86ISA::Interrupts, GenericTimer, DistIface::SyncSwitch, BasePixelPump::PixelEvent, SimObject, PhysicalMemory, SparcISA::Interrupts, BaseTrafficGen, Gicv3Distributor, ClockedObject, ArchTimer, ArmSemihosting, DistIface::SyncNode, SrcClockDomain, DistEtherLink, PciDevice, Gicv3Redistributor, VirtIO9PProxy, X86ISA::GpuTLB, DeviceFDEntry, RealViewOsc, CopyEngineReg::ChanRegs, ArmInterruptPin, MemState, GicV2::BankedRegs, VGic, EtherSwitch, CpuLocalTimer, SMMUv3, SparcISA::TLB, RealViewCtrl, PipeFDEntry, UFSHostDevice, TickedObject, DVFSHandler, A9GlobalTimer, CopyEngine, SparcISA::ISA, ThermalModel, IdeController, PowerISA::TLB, Sp804, EmulationPageTable, SimpleThread, X86ISA::TLB, EtherLink, BasePixelPump, Gicv3Its, EtherTapStub, I2CBus, CpuLocalTimer::Timer, X86ISA::I8042, SystemCounter, Iob, Ticked, FileFDEntry, GenericISA::PCStateBase, Pl050, A9GlobalTimer::Timer, CowDiskImage, MaltaCChip, CopyEngineReg::Regs, EnergyCtrl, TrafficGen, MaltaIO, ThermalReference, Malta, PL031, VoltageDomain, X86ISA::I8259, Gicv3, Sp804::Timer, X86ISA::I8254, X86ISA::TlbEntry, Random, X86ISA::I82094AA, MipsISA::Interrupts, CopyEngine::CopyEngineChannel, KernelWorkload, RiscvISA::TlbEntry, X86ISA::ISA, ArmISA::PMU, Uart8250, RiscvISA::TLB, HDLcd, X86ISA::Cmos, ThermalDomain, DistEtherLink::Link, ThermalCapacitor, MipsISA::TLB, LocalSimLoopExitEvent, RubySystem, Globals, FrameBuffer, PowerState, X86ISA::Speaker, PollEvent, Sinic::Base, Process, EtherTapBase, GPUDispatcher, FlashDevice, PS2Mouse, ThermalResistor, DisplayTimings, DumbTOD, PS2TouchKit, PS2Keyboard, Pl011, X86ISA::I8237, NoMaliGpu, Iris::Interrupts, Sp805, PS2Device, ThreadState, X86ISA::PCState, EtherSwitch::Interface::PortFifo, RiscvISA::Interrupts, EtherSwitch::Interface::PortFifoEntry, RiscvISA::ISA, EtherSwitch::Interface, and FDEntry.

◆ unserializeGlobals()

void Serializable::unserializeGlobals ( CheckpointIn & cp )

static

Definition at line 204 of file serialize.cc.

References globals, ArmISA::i, mainEventQueue, numMainEventQueues, Globals::unserializedCurTick, and Serializable::unserializeSection().

Referenced by pybind_init_core().

◆ unserializeSection() [1/2]

void Serializable::unserializeSection	(	CheckpointIn &	cp,
		const char *	name
	)

Unserialize an a child object.

This method loads a child object from a checkpoint. The object name is appended to the active path to form a fully qualified section name and unserialize() is called.

Parameters

cp	Checkpoint state
name	Name to append to the active path

Definition at line 178 of file serialize.cc.

References name(), and unserialize().

Referenced by SimObject::loadState(), RiscvISA::TLB::unserialize(), ArmISA::PMU::unserialize(), Gicv3::unserialize(), X86ISA::TLB::unserialize(), Sp804::unserialize(), EtherSwitch::Interface::PortFifo::unserialize(), CopyEngine::unserialize(), CpuLocalTimer::unserialize(), DistEtherLink::unserialize(), GenericTimer::unserialize(), GenericTimerFrame::unserialize(), DistIface::RecvScheduler::unserialize(), IGbE::unserialize(), VirtIODeviceBase::unserialize(), System::unserialize(), DistIface::unserialize(), Serializable::unserializeGlobals(), and Serializable::unserializeSection().

◆ unserializeSection() [2/2]

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

inline

Definition at line 295 of file serialize.hh.

References name(), and Serializable::unserializeSection().

Macros

Functions

Detailed Description

Macro Definition Documentation

◆ SERIALIZE_ARRAY

◆ SERIALIZE_CONTAINER

◆ SERIALIZE_ENUM

◆ SERIALIZE_EVENT

◆ SERIALIZE_OBJ

◆ SERIALIZE_OBJPTR

◆ UNSERIALIZE_ARRAY

◆ UNSERIALIZE_CONTAINER

◆ UNSERIALIZE_ENUM

◆ UNSERIALIZE_EVENT

◆ UNSERIALIZE_OBJ

◆ UNSERIALIZE_OBJPTR

◆ UNSERIALIZE_OPT_SCALAR

Function Documentation

◆ arrayParamIn() [1/4]

◆ arrayParamIn() [2/4]

◆ arrayParamIn() [3/4]

◆ arrayParamIn() [4/4]

◆ arrayParamOut() [1/4]

◆ arrayParamOut() [2/4]

◆ arrayParamOut() [3/4]

◆ arrayParamOut() [4/4]

◆ currentSection()

◆ dir()

◆ entryExists()

◆ find()

◆ findObj()

◆ getCptDir()

◆ initState()

◆ loadState()

◆ objParamIn()

◆ optParamIn()

◆ paramIn()

◆ paramOut()

◆ parseParam() [1/6]

◆ parseParam() [2/6]

◆ parseParam() [3/6]

◆ parseParam() [4/6]

◆ parseParam() [5/6]

◆ parseParam() [6/6]

◆ resolveSimObject()

◆ ScopedCheckpointSection() [1/2]

◆ ScopedCheckpointSection() [2/2]

◆ sectionExists()

◆ Serializable()

◆ serialize()

◆ serializeAll()

◆ serializeSection() [1/2]

◆ serializeSection() [2/2]

◆ setDir()

◆ showParam() [1/6]

◆ showParam() [2/6]

◆ showParam() [3/6]

◆ showParam() [4/6]

◆ showParam() [5/6]

◆ showParam() [6/6]

◆ unserialize()

◆ unserializeGlobals()

◆ unserializeSection() [1/2]

◆ unserializeSection() [2/2]