/*
+ * Copyright (c) 2015, 2018 ARM Limited
+ * All rights reserved
+ *
+ * The license below extends only to copyright in the software and shall
+ * not be construed as granting a license to any other intellectual
+ * property including but not limited to intellectual property relating
+ * to a hardware implementation of the functionality of the software
+ * licensed hereunder. You may use the software subject to the license
+ * terms below provided that you ensure that this notice is replicated
+ * unmodified and in its entirety in all distributions of the software,
+ * modified or unmodified, in source code or in binary form.
+ *
* Copyright (c) 2002-2005 The Regents of The University of Michigan
* All rights reserved.
*
* THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
* (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
* OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
- *
- * Authors: Nathan Binkert
- * Erik Hallnor
- * Steve Reinhardt
*/
/* @file
#define __SERIALIZE_HH__
+#include <algorithm>
#include <iostream>
#include <list>
#include <map>
+#include <stack>
+#include <set>
#include <vector>
-#include "base/types.hh"
+#include "base/bitunion.hh"
+#include "base/logging.hh"
+#include "base/str.hh"
class IniFile;
-class Serializable;
-class Checkpoint;
class SimObject;
+class SimObjectResolver;
-/** The current version of the checkpoint format.
- * This should be incremented by 1 and only 1 for every new version, where a new
- * version is defined as a checkpoint created before this version won't work on
- * the current version until the checkpoint format is updated. Adding a new
- * SimObject shouldn't cause the version number to increase, only changes to
- * existing objects such as serializing/unserializing more state, changing sizes
- * of serialized arrays, etc. */
-static const uint64_t gem5CheckpointVersion = 0x0000000000000006;
+typedef std::ostream CheckpointOut;
-template <class T>
-void paramOut(std::ostream &os, const std::string &name, const T ¶m);
+class CheckpointIn
+{
+ private:
+
+ IniFile *db;
+
+ SimObjectResolver &objNameResolver;
+
+ const std::string _cptDir;
+
+ public:
+ CheckpointIn(const std::string &cpt_dir, SimObjectResolver &resolver);
+ ~CheckpointIn();
+
+ /**
+ * @ingroup api_serialize
+ * @{
+ */
+ const std::string getCptDir() { return _cptDir; }
+
+ bool find(const std::string §ion, const std::string &entry,
+ std::string &value);
+
+ bool findObj(const std::string §ion, const std::string &entry,
+ SimObject *&value);
+
+ bool entryExists(const std::string §ion, const std::string &entry);
+ bool sectionExists(const std::string §ion);
+ /** @}*/ //end of api_checkout group
+
+ // The following static functions have to do with checkpoint
+ // creation rather than restoration. This class makes a handy
+ // namespace for them though. Currently no Checkpoint object is
+ // created on serialization (only unserialization) so we track the
+ // directory name as a global. It would be nice to change this
+ // someday
+
+ private:
+ // current directory we're serializing into.
+ static std::string currentDirectory;
+
+
+ public:
+ /**
+ * 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.
+ *
+ * @ingroup api_serialize
+ */
+ static std::string setDir(const std::string &base_name);
+
+ /**
+ * 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.
+ *
+ * @ingroup api_serialize
+ */
+ static std::string dir();
+ // Filename for base checkpoint file within directory.
+ static const char *baseFilename;
+};
+
+/**
+ * Basic support for object serialization.
+ *
+ * Objects that support serialization should derive from this
+ * class. Such objects can largely be divided into two categories: 1)
+ * True SimObjects (deriving from SimObject), and 2) child objects
+ * (non-SimObjects).
+ *
+ * SimObjects are serialized automatically into their own sections
+ * automatically by the SimObject base class (see
+ * SimObject::serializeAll().
+ *
+ * SimObjects can contain other serializable objects that are not
+ * SimObjects. Much like normal serialized members are not serialized
+ * automatically, these objects will not be serialized automatically
+ * and it is expected that the objects owning such serializable
+ * objects call the required serialization/unserialization methods on
+ * child objects. The preferred method to serialize a child object is
+ * to call serializeSection() on the child, which serializes the
+ * object into a new subsection in the current section. Another option
+ * is to call serialize() directly, which serializes the object into
+ * the current section. The latter is not recommended as it can lead
+ * to naming clashes between objects.
+ *
+ * @note Many objects that support serialization need to be put in a
+ * consistent state when serialization takes place. We refer to the
+ * action of forcing an object into a consistent state as
+ * 'draining'. Objects that need draining inherit from Drainable. See
+ * Drainable for more information.
+ */
+class Serializable
+{
+ protected:
+ /**
+ * Scoped checkpoint section helper class
+ *
+ * This 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.
+ */
+ class ScopedCheckpointSection {
+ public:
+ /**
+ * @ingroup api_serialize
+ * @{
+ */
+ template<class CP>
+ ScopedCheckpointSection(CP &cp, const char *name) {
+ pushName(name);
+ nameOut(cp);
+ }
+
+ template<class CP>
+ ScopedCheckpointSection(CP &cp, const std::string &name) {
+ pushName(name.c_str());
+ nameOut(cp);
+ }
+ /** @}*/ //end of api_serialize group
+
+ ~ScopedCheckpointSection();
+
+ ScopedCheckpointSection() = delete;
+ ScopedCheckpointSection(const ScopedCheckpointSection &) = delete;
+ ScopedCheckpointSection &operator=(
+ const ScopedCheckpointSection &) = delete;
+ ScopedCheckpointSection &operator=(
+ ScopedCheckpointSection &&) = delete;
+
+ private:
+ void pushName(const char *name);
+ void nameOut(CheckpointOut &cp);
+ void nameOut(CheckpointIn &cp) {};
+ };
+
+ public:
+ /**
+ * @ingroup api_serialize
+ */
+ Serializable();
+ virtual ~Serializable();
+
+ /**
+ * Serialize an object
+ *
+ * Output an object's state into the current checkpoint section.
+ *
+ * @param cp Checkpoint state
+ *
+ * @ingroup api_serialize
+ */
+ virtual void serialize(CheckpointOut &cp) const = 0;
+
+ /**
+ * Unserialize an object
+ *
+ * Read an object's state from the current checkpoint section.
+ *
+ * @param cp Checkpoint state
+ *
+ * @ingroup api_serialize
+ */
+ virtual void unserialize(CheckpointIn &cp) = 0;
+
+ /**
+ * 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.
+ *
+ * @param cp Checkpoint state
+ * @param name Name to append to the active path
+ *
+ * @ingroup api_serialize
+ */
+ void serializeSection(CheckpointOut &cp, const char *name) const;
+
+ /**
+ * @ingroup api_serialize
+ */
+ void serializeSection(CheckpointOut &cp, const std::string &name) const {
+ serializeSection(cp, name.c_str());
+ }
+
+ /**
+ * 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.
+ *
+ * @param cp Checkpoint state
+ * @param name Name to append to the active path
+ *
+ * @ingroup api_serialize
+ */
+ void unserializeSection(CheckpointIn &cp, const char *name);
+
+ /**
+ * @ingroup api_serialize
+ */
+ void unserializeSection(CheckpointIn &cp, const std::string &name) {
+ unserializeSection(cp, name.c_str());
+ }
+
+ /**
+ * Gets the fully-qualified name of the active section
+ *
+ * @ingroup api_serialize
+ */
+ static const std::string ¤tSection();
+
+ /**
+ * @ingroup api_serialize
+ */
+ static void serializeAll(const std::string &cpt_dir);
+
+ /**
+ * @ingroup api_serialize
+ */
+ static void unserializeGlobals(CheckpointIn &cp);
+
+ private:
+ static std::stack<std::string> path;
+};
+
+/**
+ * @ingroup api_serialize
+ */
template <class T>
-void paramIn(Checkpoint *cp, const std::string §ion,
- const std::string &name, T ¶m);
+bool
+parseParam(const std::string &s, T &value)
+{
+ // The base implementations use to_number for parsing and '<<' for
+ // displaying, suitable for integer types.
+ return to_number(s, value);
+}
+/**
+ * @ingroup api_serialize
+ */
template <class T>
-bool optParamIn(Checkpoint *cp, const std::string §ion,
- const std::string &name, T ¶m);
+void
+showParam(CheckpointOut &os, const T &value)
+{
+ os << value;
+}
+/**
+ * @ingroup api_serialize
+ */
template <class T>
-void arrayParamOut(std::ostream &os, const std::string &name,
- const T *param, unsigned size);
+bool
+parseParam(const std::string &s, BitUnionType<T> &value)
+{
+ // Zero initialize storage to avoid leaking an uninitialized value
+ BitUnionBaseType<T> storage = BitUnionBaseType<T>();
+ auto res = to_number(s, storage);
+ value = storage;
+ return res;
+}
+/**
+ * @ingroup api_serialize
+ */
template <class T>
-void arrayParamOut(std::ostream &os, const std::string &name,
- const std::vector<T> ¶m);
+void
+showParam(CheckpointOut &os, const BitUnionType<T> &value)
+{
+ auto storage = static_cast<BitUnionBaseType<T>>(value);
+
+ // For a BitUnion8, the storage type is an unsigned char.
+ // Since we want to serialize a number we need to cast to
+ // unsigned int
+ os << ((sizeof(storage) == 1) ?
+ static_cast<unsigned int>(storage) : storage);
+}
+
+/**
+ * @ingroup api_serialize
+ */
+template <>
+inline void
+showParam(CheckpointOut &os, const char &value)
+{
+ // Treat 8-bit ints (chars) as ints on output, not as chars
+ os << (int)value;
+}
+
+/**
+ * @ingroup api_serialize
+ */
+template <>
+inline void
+showParam(CheckpointOut &os, const signed char &value)
+{
+ os << (int)value;
+}
+
+/**
+ * @ingroup api_serialize
+ */
+template <>
+inline void
+showParam(CheckpointOut &os, const unsigned char &value)
+{
+ os << (unsigned int)value;
+}
+
+/**
+ * @ingroup api_serialize
+ */
+template <>
+inline bool
+parseParam(const std::string &s, float &value)
+{
+ return to_number(s, value);
+}
+
+/**
+ * @ingroup api_serialize
+ */
+template <>
+inline bool
+parseParam(const std::string &s, double &value)
+{
+ return to_number(s, value);
+}
+
+/**
+ * @ingroup api_serialize
+ */
+template <>
+inline bool
+parseParam(const std::string &s, bool &value)
+{
+ return to_bool(s, value);
+}
+
+/**
+ * @ingroup api_serialize
+ */
+template <>
+inline void
+showParam(CheckpointOut &os, const bool &value)
+{
+ // Display bools as strings
+ os << (value ? "true" : "false");
+}
+/**
+ * @ingroup api_serialize
+ */
+template <>
+inline bool
+parseParam(const std::string &s, std::string &value)
+{
+ // String requires no processing to speak of
+ value = s;
+ return true;
+}
+
+/**
+ * @ingroup api_serialize
+ */
template <class T>
-void arrayParamOut(std::ostream &os, const std::string &name,
- const std::list<T> ¶m);
+void
+paramOut(CheckpointOut &os, const std::string &name, const T ¶m)
+{
+ os << name << "=";
+ showParam(os, param);
+ os << "\n";
+}
+/**
+ * @ingroup api_serialize
+ */
template <class T>
-void arrayParamIn(Checkpoint *cp, const std::string §ion,
- const std::string &name, T *param, unsigned size);
+void
+paramIn(CheckpointIn &cp, const std::string &name, T ¶m)
+{
+ const std::string §ion(Serializable::currentSection());
+ std::string str;
+ if (!cp.find(section, name, str) || !parseParam(str, param)) {
+ fatal("Can't unserialize '%s:%s'\n", section, name);
+ }
+}
+/**
+ * @ingroup api_serialize
+ */
template <class T>
-void arrayParamIn(Checkpoint *cp, const std::string §ion,
- const std::string &name, std::vector<T> ¶m);
+bool
+optParamIn(CheckpointIn &cp, const std::string &name,
+ T ¶m, bool warn = true)
+{
+ const std::string §ion(Serializable::currentSection());
+ std::string str;
+ if (!cp.find(section, name, str) || !parseParam(str, param)) {
+ if (warn)
+ warn("optional parameter %s:%s not present\n", section, name);
+ return false;
+ } else {
+ return true;
+ }
+}
+/**
+ * @ingroup api_serialize
+ */
template <class T>
-void arrayParamIn(Checkpoint *cp, const std::string §ion,
- const std::string &name, std::list<T> ¶m);
+void
+arrayParamOut(CheckpointOut &os, const std::string &name,
+ const std::vector<T> ¶m)
+{
+ typename std::vector<T>::size_type size = param.size();
+ os << name << "=";
+ if (size > 0)
+ showParam(os, param[0]);
+ for (typename std::vector<T>::size_type i = 1; i < size; ++i) {
+ os << " ";
+ showParam(os, param[i]);
+ }
+ os << "\n";
+}
+/**
+ * @ingroup api_serialize
+ */
+template <class T>
void
-objParamIn(Checkpoint *cp, const std::string §ion,
- const std::string &name, SimObject * ¶m);
+arrayParamOut(CheckpointOut &os, const std::string &name,
+ const std::list<T> ¶m)
+{
+ typename std::list<T>::const_iterator it = param.begin();
+
+ os << name << "=";
+ if (param.size() > 0)
+ showParam(os, *it);
+ it++;
+ while (it != param.end()) {
+ os << " ";
+ showParam(os, *it);
+ it++;
+ }
+ os << "\n";
+}
-template <typename T>
-void fromInt(T &t, int i)
+/**
+ * @ingroup api_serialize
+ */
+template <class T>
+void
+arrayParamOut(CheckpointOut &os, const std::string &name,
+ const std::set<T> ¶m)
{
- t = (T)i;
+ typename std::set<T>::const_iterator it = param.begin();
+
+ os << name << "=";
+ if (param.size() > 0)
+ showParam(os, *it);
+ it++;
+ while (it != param.end()) {
+ os << " ";
+ showParam(os, *it);
+ it++;
+ }
+ os << "\n";
}
-template <typename T>
-void fromSimObject(T &t, SimObject *s)
+/**
+ * @ingroup api_serialize
+ */
+template <class T>
+void
+arrayParamOut(CheckpointOut &os, const std::string &name,
+ const T *param, unsigned size)
{
- t = dynamic_cast<T>(s);
+ os << name << "=";
+ if (size > 0)
+ showParam(os, param[0]);
+ for (unsigned i = 1; i < size; ++i) {
+ os << " ";
+ showParam(os, param[i]);
+ }
+ os << "\n";
}
-//
-// These macros are streamlined to use in serialize/unserialize
-// functions. It's assumed that serialize() has a parameter 'os' for
-// the ostream, and unserialize() has parameters 'cp' and 'section'.
-#define SERIALIZE_SCALAR(scalar) paramOut(os, #scalar, scalar)
+/**
+ * Extract values stored in the checkpoint, and assign them to the provided
+ * array container.
+ *
+ * @param cp The checkpoint to be parsed.
+ * @param name Name of the container.
+ * @param param The array container.
+ * @param size The expected number of entries to be extracted.
+ *
+ * @ingroup api_serialize
+ */
+template <class T>
+void
+arrayParamIn(CheckpointIn &cp, const std::string &name,
+ T *param, unsigned size)
+{
+ const std::string §ion(Serializable::currentSection());
+ std::string str;
+ if (!cp.find(section, name, str)) {
+ fatal("Can't unserialize '%s:%s'\n", section, name);
+ }
-#define UNSERIALIZE_SCALAR(scalar) paramIn(cp, section, #scalar, scalar)
-#define UNSERIALIZE_OPT_SCALAR(scalar) optParamIn(cp, section, #scalar, scalar)
+ // code below stolen from VectorParam<T>::parse().
+ // it would be nice to unify these somehow...
-// ENUMs are like SCALARs, but we cast them to ints on the way out
-#define SERIALIZE_ENUM(scalar) paramOut(os, #scalar, (int)scalar)
+ std::vector<std::string> tokens;
-#define UNSERIALIZE_ENUM(scalar) \
- do { \
- int tmp; \
- paramIn(cp, section, #scalar, tmp); \
- fromInt(scalar, tmp); \
- } while (0)
+ tokenize(tokens, str, ' ');
-#define SERIALIZE_ARRAY(member, size) \
- arrayParamOut(os, #member, member, size)
+ // Need this if we were doing a vector
+ // value.resize(tokens.size());
-#define UNSERIALIZE_ARRAY(member, size) \
- arrayParamIn(cp, section, #member, member, size)
+ fatal_if(tokens.size() != size,
+ "Array size mismatch on %s:%s (Got %u, expected %u)'\n",
+ section, name, tokens.size(), size);
-#define SERIALIZE_OBJPTR(objptr) paramOut(os, #objptr, (objptr)->name())
+ for (std::vector<std::string>::size_type i = 0; i < tokens.size(); i++) {
+ // need to parse into local variable to handle vector<bool>,
+ // for which operator[] returns a special reference class
+ // that's not the same as 'bool&', (since it's a packed
+ // vector)
+ T scalar_value;
+ if (!parseParam(tokens[i], scalar_value)) {
+ std::string err("could not parse \"");
-#define UNSERIALIZE_OBJPTR(objptr) \
- do { \
- SimObject *sptr; \
- objParamIn(cp, section, #objptr, sptr); \
- fromSimObject(objptr, sptr); \
- } while (0)
+ err += str;
+ err += "\"";
+
+ fatal(err);
+ }
+
+ // assign parsed value to vector
+ param[i] = scalar_value;
+ }
+}
/**
- * Basic support for object serialization.
- *
- * @note Many objects that support serialization need to be put in a
- * consistent state when serialization takes place. We refer to the
- * action of forcing an object into a consistent state as
- * 'draining'. Objects that need draining inherit from Drainable. See
- * Drainable for more information.
+ * @ingroup api_serialize
*/
-class Serializable
+template <class T>
+void
+arrayParamIn(CheckpointIn &cp, const std::string &name, std::vector<T> ¶m)
{
- protected:
- void nameOut(std::ostream &os);
- void nameOut(std::ostream &os, const std::string &_name);
+ const std::string §ion(Serializable::currentSection());
+ std::string str;
+ if (!cp.find(section, name, str)) {
+ fatal("Can't unserialize '%s:%s'\n", section, name);
+ }
- public:
- Serializable();
- virtual ~Serializable();
+ // code below stolen from VectorParam<T>::parse().
+ // it would be nice to unify these somehow...
- // manditory virtual function, so objects must provide names
- virtual const std::string name() const = 0;
+ std::vector<std::string> tokens;
- virtual void serialize(std::ostream &os);
- virtual void unserialize(Checkpoint *cp, const std::string §ion);
+ tokenize(tokens, str, ' ');
- static Serializable *create(Checkpoint *cp, const std::string §ion);
+ // Need this if we were doing a vector
+ // value.resize(tokens.size());
- static int ckptCount;
- static int ckptMaxCount;
- static int ckptPrevCount;
- static void serializeAll(const std::string &cpt_dir);
- static void unserializeGlobals(Checkpoint *cp);
-};
+ param.resize(tokens.size());
-void debug_serialize(const std::string &cpt_dir);
+ for (std::vector<std::string>::size_type i = 0; i < tokens.size(); i++) {
+ // need to parse into local variable to handle vector<bool>,
+ // for which operator[] returns a special reference class
+ // that's not the same as 'bool&', (since it's a packed
+ // vector)
+ T scalar_value;
+ if (!parseParam(tokens[i], scalar_value)) {
+ std::string err("could not parse \"");
-//
-// A SerializableBuilder serves as an evaluation context for a set of
-// parameters that describe a specific instance of a Serializable. This
-// evaluation context corresponds to a section in the .ini file (as
-// with the base ParamContext) plus an optional node in the
-// configuration hierarchy (the configNode member) for resolving
-// Serializable references. SerializableBuilder is an abstract superclass;
-// derived classes specialize the class for particular subclasses of
-// Serializable (e.g., BaseCache).
-//
-// For typical usage, see the definition of
-// SerializableClass::createObject().
-//
-class SerializableBuilder
-{
- public:
+ err += str;
+ err += "\"";
- SerializableBuilder() {}
+ fatal(err);
+ }
- virtual ~SerializableBuilder() {}
+ // assign parsed value to vector
+ param[i] = scalar_value;
+ }
+}
- // Create the actual Serializable corresponding to the parameter
- // values in this context. This function is overridden in derived
- // classes to call a specific constructor for a particular
- // subclass of Serializable.
- virtual Serializable *create() = 0;
-};
+/**
+ * @ingroup api_serialize
+ */
+template <class T>
+void
+arrayParamIn(CheckpointIn &cp, const std::string &name, std::list<T> ¶m)
+{
+ const std::string §ion(Serializable::currentSection());
+ std::string str;
+ if (!cp.find(section, name, str)) {
+ fatal("Can't unserialize '%s:%s'\n", section, name);
+ }
+ param.clear();
+
+ std::vector<std::string> tokens;
+ tokenize(tokens, str, ' ');
+
+ for (std::vector<std::string>::size_type i = 0; i < tokens.size(); i++) {
+ T scalar_value;
+ if (!parseParam(tokens[i], scalar_value)) {
+ std::string err("could not parse \"");
+
+ err += str;
+ err += "\"";
+
+ fatal(err);
+ }
+
+ // assign parsed value to vector
+ param.push_back(scalar_value);
+ }
+}
-//
-// An instance of SerializableClass corresponds to a class derived from
-// Serializable. The SerializableClass instance serves to bind the string
-// name (found in the config file) to a function that creates an
-// instance of the appropriate derived class.
-//
-// This would be much cleaner in Smalltalk or Objective-C, where types
-// are first-class objects themselves.
-//
-class SerializableClass
+/**
+ * @ingroup api_serialize
+ */
+template <class T>
+void
+arrayParamIn(CheckpointIn &cp, const std::string &name, std::set<T> ¶m)
{
- public:
+ const std::string §ion(Serializable::currentSection());
+ std::string str;
+ if (!cp.find(section, name, str)) {
+ fatal("Can't unserialize '%s:%s'\n", section, name);
+ }
+ param.clear();
+
+ std::vector<std::string> tokens;
+ tokenize(tokens, str, ' ');
+
+ for (std::vector<std::string>::size_type i = 0; i < tokens.size(); i++) {
+ T scalar_value;
+ if (!parseParam(tokens[i], scalar_value)) {
+ std::string err("could not parse \"");
+
+ err += str;
+ err += "\"";
+
+ fatal(err);
+ }
+
+ // assign parsed value to vector
+ param.insert(scalar_value);
+ }
+}
- // Type CreateFunc is a pointer to a function that creates a new
- // simulation object builder based on a .ini-file parameter
- // section (specified by the first string argument), a unique name
- // for the object (specified by the second string argument), and
- // an optional config hierarchy node (specified by the third
- // argument). A pointer to the new SerializableBuilder is returned.
- typedef Serializable *(*CreateFunc)(Checkpoint *cp,
- const std::string §ion);
-
- static std::map<std::string,CreateFunc> *classMap;
-
- // Constructor. For example:
- //
- // SerializableClass baseCacheSerializableClass("BaseCacheSerializable",
- // newBaseCacheSerializableBuilder);
- //
- SerializableClass(const std::string &className, CreateFunc createFunc);
-
- // create Serializable given name of class and pointer to
- // configuration hierarchy node
- static Serializable *createObject(Checkpoint *cp,
- const std::string §ion);
-};
+void
+debug_serialize(const std::string &cpt_dir);
+
+
+/**
+ * @ingroup api_serialize
+ */
+void
+objParamIn(CheckpointIn &cp, const std::string &name, SimObject * ¶m);
//
-// Macros to encapsulate the magic of declaring & defining
-// SerializableBuilder and SerializableClass objects
-//
+// These macros are streamlined to use in serialize/unserialize
+// functions. It's assumed that serialize() has a parameter 'os' for
+// the ostream, and unserialize() has parameters 'cp' and 'section'.
-#define REGISTER_SERIALIZEABLE(CLASS_NAME, OBJ_CLASS) \
-SerializableClass the##OBJ_CLASS##Class(CLASS_NAME, \
- OBJ_CLASS::createForUnserialize);
-class Checkpoint
-{
- private:
+/**
+ * \def SERIALIZE_SCALER(scaler)
+ *
+ * @ingroup api_serialize
+ */
+#define SERIALIZE_SCALAR(scalar) paramOut(cp, #scalar, scalar)
- IniFile *db;
+/**
+ * \def UNSERIALIZE_SCALER(scalar)
+ *
+ * @ingroup api_serialize
+ */
+#define UNSERIALIZE_SCALAR(scalar) paramIn(cp, #scalar, scalar)
- public:
- Checkpoint(const std::string &cpt_dir);
- ~Checkpoint();
+/**
+ * \def UNSERIALIZE_OPT_SCALAR(scalar)
+ *
+ * @ingroup api_serialize
+ */
+#define UNSERIALIZE_OPT_SCALAR(scalar) optParamIn(cp, #scalar, scalar)
- const std::string cptDir;
+// ENUMs are like SCALARs, but we cast them to ints on the way out
- bool find(const std::string §ion, const std::string &entry,
- std::string &value);
+/**
+ * \def SERIALIZE_ENUM(scalar)
+ *
+ * @ingroup api_serialize
+ */
+#define SERIALIZE_ENUM(scalar) paramOut(cp, #scalar, (int)scalar)
- bool findObj(const std::string §ion, const std::string &entry,
- SimObject *&value);
+/**
+ * \def UNSERIALIZE_ENUM(scaler)
+ *
+ * @ingroup api_serialize
+ */
+#define UNSERIALIZE_ENUM(scalar) \
+ do { \
+ int tmp; \
+ paramIn(cp, #scalar, tmp); \
+ scalar = static_cast<decltype(scalar)>(tmp); \
+ } while (0)
- bool sectionExists(const std::string §ion);
+/**
+ * \def SERIALIZE_ARRAY(member, size)
+ *
+ * @ingroup api_serialize
+ */
+#define SERIALIZE_ARRAY(member, size) \
+ arrayParamOut(cp, #member, member, size)
- // The following static functions have to do with checkpoint
- // creation rather than restoration. This class makes a handy
- // namespace for them though. Currently no Checkpoint object is
- // created on serialization (only unserialization) so we track the
- // directory name as a global. It would be nice to change this
- // someday
+/**
+ * \def UNSERIALIZE_ARRAY(member, size)
+ *
+ * @ingroup api_serialize
+ */
+#define UNSERIALIZE_ARRAY(member, size) \
+ arrayParamIn(cp, #member, member, size)
- private:
- // current directory we're serializing into.
- static std::string currentDirectory;
+/**
+ * \def SERIALIZE_CONTAINER(member)
+ *
+ * @ingroup api_serialize
+ */
+#define SERIALIZE_CONTAINER(member) \
+ arrayParamOut(cp, #member, member)
- public:
- // 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.
- static std::string setDir(const std::string &base_name);
+/**
+ * \def UNSERIALIZE_CONTAINER(member)
+ *
+ * @ingroup api_serialize
+ */
+#define UNSERIALIZE_CONTAINER(member) \
+ arrayParamIn(cp, #member, member)
- // Export current checkpoint 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.
- static std::string dir();
+/**
+ * \def SERIALIZE_EVENT(event)
+ *
+ * @ingroup api_serialize
+ */
+#define SERIALIZE_EVENT(event) event.serializeSection(cp, #event);
- // Filename for base checkpoint file within directory.
- static const char *baseFilename;
-};
+/**
+ * \def UNSERIALIZE_EVENT(event)
+ *
+ * @ingroup api_serialize
+ */
+#define UNSERIALIZE_EVENT(event) \
+ do { \
+ event.unserializeSection(cp, #event); \
+ eventQueue()->checkpointReschedule(&event); \
+ } while (0)
+
+/**
+ * \def SERIALIZE_OBJ(obj)
+ *
+ * @ingroup api_serialize
+ */
+#define SERIALIZE_OBJ(obj) obj.serializeSection(cp, #obj)
+
+/**
+ * \def UNSERIALIZE_OBJ(obj)
+ *
+ * @ingroup api_serialize
+ */
+#define UNSERIALIZE_OBJ(obj) obj.unserializeSection(cp, #obj)
+
+/**
+ * \def SERIALIZE_OBJPTR(objptr)
+ *
+ * @ingroup api_serialize
+ */
+#define SERIALIZE_OBJPTR(objptr) paramOut(cp, #objptr, (objptr)->name())
+
+/**
+ * \def UNSERIALIZE_OBJPTR(objptr)
+ *
+ * @ingroup api_serialize
+ */
+#define UNSERIALIZE_OBJPTR(objptr) \
+ do { \
+ SimObject *sptr; \
+ objParamIn(cp, #objptr, sptr); \
+ objptr = dynamic_cast<decltype(objptr)>(sptr); \
+ } while (0)
#endif // __SERIALIZE_HH__