X-Git-Url: http://info.iut-bm.univ-fcomte.fr/pub/gitweb/simgrid.git/blobdiff_plain/77bbf3027c4240a2e833209a3a3f186589da8577..ab4d43a39df33bb5f24c3b2cc6d576130b16a649:/src/xbt/config.cpp diff --git a/src/xbt/config.cpp b/src/xbt/config.cpp index cb26929e8c..84c6b7b10a 100644 --- a/src/xbt/config.cpp +++ b/src/xbt/config.cpp @@ -1,4 +1,4 @@ -/* Copyright (c) 2004-2017. The SimGrid Team. All rights reserved. */ +/* Copyright (c) 2004-2018. The SimGrid Team. All rights reserved. */ /* This program is free software; you can redistribute it and/or modify it * under the terms of the license (GNU LGPL) which comes with this package. */ @@ -19,26 +19,22 @@ #include #include -#include -#include -#include +#include "simgrid/sg_config.hpp" +#include "xbt/dynar.h" +#include "xbt/log.h" #include "xbt/misc.h" #include "xbt/sysdep.h" -#include "xbt/log.h" -#include "xbt/dynar.h" +#include +#include +#include XBT_LOG_NEW_DEFAULT_SUBCATEGORY(xbt_cfg, xbt, "configuration support"); -XBT_EXPORT_NO_IMPORT(xbt_cfg_t) simgrid_config = nullptr; -extern "C" { - XBT_PUBLIC(void) sg_config_finalize(); -} +XBT_EXPORT_NO_IMPORT xbt_cfg_t simgrid_config = nullptr; namespace simgrid { namespace config { -missing_key_error::~missing_key_error() = default; - namespace { const char* true_values[] = { @@ -48,7 +44,7 @@ const char* false_values[] = { "no", "off", "false", "0" }; -static bool parseBool(const char* value) +static bool parse_bool(const char* value) { for (const char* const& true_value : true_values) if (std::strcmp(true_value, value) == 0) @@ -59,7 +55,7 @@ static bool parseBool(const char* value) throw std::range_error("not a boolean"); } -static double parseDouble(const char* value) +static double parse_double(const char* value) { char* end; errno = 0; @@ -74,7 +70,7 @@ static double parseDouble(const char* value) return res; } -static long int parseLong(const char* value) +static long int parse_long(const char* value) { char* end; errno = 0; @@ -102,7 +98,7 @@ public: static constexpr const char* type_name = "int"; static inline double parse(const char* value) { - return parseLong(value); + return parse_long(value); } }; template <> class ConfigType { @@ -110,7 +106,7 @@ public: static constexpr const char* type_name = "double"; static inline double parse(const char* value) { - return parseDouble(value); + return parse_double(value); } }; template <> class ConfigType { @@ -126,7 +122,7 @@ public: static constexpr const char* type_name = "boolean"; static inline bool parse(const char* value) { - return parseBool(value); + return parse_bool(value); } }; @@ -151,32 +147,29 @@ public: ConfigurationElement(const char* key, const char* desc, xbt_cfg_cb_t cb) : key(key ? key : ""), desc(desc ? desc : ""), old_callback(cb) {} - virtual ~ConfigurationElement()=default; + virtual ~ConfigurationElement() = default; - virtual std::string getStringValue() = 0; - virtual void setStringValue(const char* value) = 0; - virtual const char* getTypeName() = 0; + virtual std::string get_string_value() = 0; + virtual void set_string_value(const char* value) = 0; + virtual const char* get_type_name() = 0; - template - T const& getValue() const + template T const& get_value() const { - return dynamic_cast&>(*this).getValue(); + return dynamic_cast&>(*this).get_value(); } - template - void setValue(T value) + template void set_value(T value) { - dynamic_cast&>(*this).setValue(std::move(value)); + dynamic_cast&>(*this).set_value(std::move(value)); } - template - void setDefaultValue(T value) + template void set_default_value(T value) { - dynamic_cast&>(*this).setDefaultValue(std::move(value)); + dynamic_cast&>(*this).set_default_value(std::move(value)); } - void unsetDefault() { isdefault = false; } - bool isDefault() const { return isdefault; } + void unset_default() { isdefault = false; } + bool is_default() const { return isdefault; } - std::string const& getDescription() const { return desc; } - std::string const& getKey() const { return key; } + std::string const& get_description() const { return desc; } + std::string const& get_key() const { return key; } }; // **** TypedConfigurationElement **** @@ -200,54 +193,52 @@ public: {} ~TypedConfigurationElement() = default; - std::string getStringValue() override; - const char* getTypeName() override; - void setStringValue(const char* value) override; + std::string get_string_value() override; + const char* get_type_name() override; + void set_string_value(const char* value) override; void update() { if (old_callback) - this->old_callback(getKey().c_str()); + this->old_callback(get_key().c_str()); if (this->callback) this->callback(this->content); } - T const& getValue() const { return content; } + T const& get_value() const { return content; } - void setValue(T value) + void set_value(T value) { this->content = std::move(value); this->update(); + this->unset_default(); } - void setDefaultValue(T value) + void set_default_value(T value) { - if (this->isDefault()) { + if (this->is_default()) { this->content = std::move(value); this->update(); } else { XBT_DEBUG("Do not override configuration variable '%s' with value '%s' because it was already set.", - getKey().c_str(), to_string(value).c_str()); + get_key().c_str(), to_string(value).c_str()); } } }; -template -std::string TypedConfigurationElement::getStringValue() // override +template std::string TypedConfigurationElement::get_string_value() // override { return to_string(content); } -template -void TypedConfigurationElement::setStringValue(const char* value) // override +template void TypedConfigurationElement::set_string_value(const char* value) // override { this->content = ConfigType::parse(value); - this->unsetDefault(); + this->unset_default(); this->update(); } -template -const char* TypedConfigurationElement::getTypeName() // override +template const char* TypedConfigurationElement::get_type_name() // override { return ConfigType::type_name; } @@ -265,7 +256,7 @@ private: bool warn_for_aliases = true; public: - Config() = default; + Config(); ~Config(); // No copy: @@ -273,18 +264,15 @@ public: Config& operator=(Config const&) = delete; ConfigurationElement& operator[](const char* name); - template - TypedConfigurationElement& getTyped(const char* name); void alias(const char* realname, const char* aliasname); - template - simgrid::config::TypedConfigurationElement* - registerOption(const char* name, A&&... a) + template + simgrid::config::TypedConfigurationElement* register_option(const char* name, A&&... a) { xbt_assert(options.find(name) == options.end(), "Refusing to register the config element '%s' twice.", name); TypedConfigurationElement* variable = new TypedConfigurationElement(name, std::forward(a)...); - XBT_DEBUG("Register cfg elm %s (%s) of type %s @%p in set %p)", name, variable->getDescription().c_str(), - variable->getTypeName(), variable, this); + XBT_DEBUG("Register cfg elm %s (%s) of type %s @%p in set %p)", name, variable->get_description().c_str(), + variable->get_type_name(), variable, this); options.insert({name, variable}); variable->update(); return variable; @@ -292,13 +280,17 @@ public: // Debug: void dump(const char *name, const char *indent); - void showAliases(); + void show_aliases(); void help(); protected: - ConfigurationElement* getDictElement(const char* name); + ConfigurationElement* get_dict_element(const char* name); }; +Config::Config() +{ + atexit(&sg_config_finalize); +} Config::~Config() { XBT_DEBUG("Frees cfg set %p", this); @@ -306,7 +298,7 @@ Config::~Config() delete elm.second; } -inline ConfigurationElement* Config::getDictElement(const char* name) +inline ConfigurationElement* Config::get_dict_element(const char* name) { auto opt = options.find(name); if (opt != options.end()) { @@ -316,23 +308,23 @@ inline ConfigurationElement* Config::getDictElement(const char* name) if (als != aliases.end()) { ConfigurationElement* res = als->second; if (warn_for_aliases) - XBT_INFO("Option %s has been renamed to %s. Consider switching.", name, res->getKey().c_str()); + XBT_INFO("Option %s has been renamed to %s. Consider switching.", name, res->get_key().c_str()); return res; } else { - throw simgrid::config::missing_key_error(std::string("Bad config key: ") + name); + THROWF(not_found_error, 0, "Bad config key: %s", name); } } } inline ConfigurationElement& Config::operator[](const char* name) { - return *(getDictElement(name)); + return *(get_dict_element(name)); } void Config::alias(const char* realname, const char* aliasname) { xbt_assert(aliases.find(aliasname) == aliases.end(), "Alias '%s' already.", aliasname); - ConfigurationElement* element = this->getDictElement(realname); + ConfigurationElement* element = this->get_dict_element(realname); xbt_assert(element, "Cannot define an alias to the non-existing option '%s'.", realname); this->aliases.insert({aliasname, element}); } @@ -348,22 +340,19 @@ void Config::dump(const char *name, const char *indent) printf("%s>> Dumping of the config set '%s':\n", indent, name); for (auto const& elm : options) - printf("%s %s: ()%s) %s", indent, elm.first.c_str(), elm.second->getTypeName(), - elm.second->getStringValue().c_str()); + printf("%s %s: ()%s) %s", indent, elm.first.c_str(), elm.second->get_type_name(), + elm.second->get_string_value().c_str()); if (name) printf("%s<< End of the config set '%s'\n", indent, name); fflush(stdout); } -/** @brief Displays the declared aliases and their description */ -void Config::showAliases() +/** @brief Displays the declared aliases and their replacement */ +void Config::show_aliases() { - bool old_warn_for_aliases = false; - std::swap(warn_for_aliases, old_warn_for_aliases); for (auto const& elm : aliases) - printf(" %s: %s\n", elm.first.c_str(), (*this)[elm.first.c_str()].getDescription().c_str()); - std::swap(warn_for_aliases, old_warn_for_aliases); + printf(" %-40s %s\n", elm.first.c_str(), elm.second->get_key().c_str()); } /** @brief Displays the declared options and their description */ @@ -371,61 +360,59 @@ void Config::help() { for (auto const& elm : options) { simgrid::config::ConfigurationElement* variable = this->options.at(elm.first); - printf(" %s: %s\n", elm.first.c_str(), variable->getDescription().c_str()); - printf(" Type: %s; ", variable->getTypeName()); - printf("Current value: %s\n", variable->getStringValue().c_str()); + printf(" %s: %s\n", elm.first.c_str(), variable->get_description().c_str()); + printf(" Type: %s; ", variable->get_type_name()); + printf("Current value: %s\n", variable->get_string_value().c_str()); } } -// ***** getConfig ***** +// ***** get_config ***** -template -XBT_PUBLIC(T const&) getConfig(const char* name) +template XBT_PUBLIC T const& get_config(const char* name) { - return (*simgrid_config)[name].getValue(); + return (*simgrid_config)[name].get_value(); } -template XBT_PUBLIC(int const&) getConfig(const char* name); -template XBT_PUBLIC(double const&) getConfig(const char* name); -template XBT_PUBLIC(bool const&) getConfig(const char* name); -template XBT_PUBLIC(std::string const&) getConfig(const char* name); +template XBT_PUBLIC int const& get_config(const char* name); +template XBT_PUBLIC double const& get_config(const char* name); +template XBT_PUBLIC bool const& get_config(const char* name); +template XBT_PUBLIC std::string const& get_config(const char* name); // ***** alias ***** -void alias(const char* realname, const char* aliasname) +void alias(const char* realname, std::initializer_list aliases) { - simgrid_config->alias(realname, aliasname); + for (auto const& aliasname : aliases) + simgrid_config->alias(realname, aliasname); } -// ***** declareFlag ***** +// ***** declare_flag ***** -template -XBT_PUBLIC(void) declareFlag(const char* name, const char* description, - T value, std::function callback) +template +XBT_PUBLIC void declare_flag(const char* name, const char* description, T value, std::function callback) { - if (simgrid_config == nullptr) { + if (simgrid_config == nullptr) simgrid_config = xbt_cfg_new(); - atexit(sg_config_finalize); - } - simgrid_config->registerOption( - name, description, std::move(value), std::move(callback)); + simgrid_config->register_option(name, description, std::move(value), std::move(callback)); } -template XBT_PUBLIC(void) declareFlag(const char* name, - const char* description, int value, std::function callback); -template XBT_PUBLIC(void) declareFlag(const char* name, - const char* description, double value, std::function callback); -template XBT_PUBLIC(void) declareFlag(const char* name, - const char* description, bool value, std::function callback); -template XBT_PUBLIC(void) declareFlag(const char* name, - const char* description, std::string value, std::function callback); - +template XBT_PUBLIC void declare_flag(const char* name, const char* description, int value, + std::function callback); +template XBT_PUBLIC void declare_flag(const char* name, const char* description, double value, + std::function callback); +template XBT_PUBLIC void declare_flag(const char* name, const char* description, bool value, + std::function callback); +template XBT_PUBLIC void declare_flag(const char* name, const char* description, std::string value, + std::function callback); } } // ***** C bindings ***** -xbt_cfg_t xbt_cfg_new() { return new simgrid::config::Config(); } +xbt_cfg_t xbt_cfg_new() +{ + return new simgrid::config::Config(); +} void xbt_cfg_free(xbt_cfg_t * cfg) { delete *cfg; } void xbt_cfg_dump(const char *name, const char *indent, xbt_cfg_t cfg) @@ -440,47 +427,45 @@ void xbt_cfg_register_double(const char *name, double default_value, { if (simgrid_config == nullptr) simgrid_config = xbt_cfg_new(); - simgrid_config->registerOption(name, desc, default_value, cb_set); + simgrid_config->register_option(name, desc, default_value, cb_set); } void xbt_cfg_register_int(const char *name, int default_value,xbt_cfg_cb_t cb_set, const char *desc) { - if (simgrid_config == nullptr) { + if (simgrid_config == nullptr) simgrid_config = xbt_cfg_new(); - atexit(&sg_config_finalize); - } - simgrid_config->registerOption(name, desc, default_value, cb_set); + simgrid_config->register_option(name, desc, default_value, cb_set); } void xbt_cfg_register_string(const char *name, const char *default_value, xbt_cfg_cb_t cb_set, const char *desc) { - if (simgrid_config == nullptr) { + if (simgrid_config == nullptr) simgrid_config = xbt_cfg_new(); - atexit(sg_config_finalize); - } - simgrid_config->registerOption(name, desc, default_value ? default_value : "", cb_set); + simgrid_config->register_option(name, desc, default_value ? default_value : "", cb_set); } void xbt_cfg_register_boolean(const char *name, const char*default_value,xbt_cfg_cb_t cb_set, const char *desc) { - if (simgrid_config == nullptr) { + if (simgrid_config == nullptr) simgrid_config = xbt_cfg_new(); - atexit(sg_config_finalize); - } - simgrid_config->registerOption(name, desc, simgrid::config::parseBool(default_value), cb_set); + simgrid_config->register_option(name, desc, simgrid::config::parse_bool(default_value), cb_set); } void xbt_cfg_register_alias(const char *realname, const char *aliasname) { - if (simgrid_config == nullptr) { + if (simgrid_config == nullptr) simgrid_config = xbt_cfg_new(); - atexit(sg_config_finalize); - } simgrid_config->alias(realname, aliasname); } -void xbt_cfg_aliases() { simgrid_config->showAliases(); } -void xbt_cfg_help() { simgrid_config->help(); } +void xbt_cfg_aliases() +{ + simgrid_config->show_aliases(); +} +void xbt_cfg_help() +{ + simgrid_config->help(); +} /*----[ Setting ]---------------------------------------------------------*/ @@ -526,31 +511,10 @@ void xbt_cfg_set_parse(const char *options) if (name.compare(0, path.length(), path) != 0) XBT_INFO("Configuration change: Set '%s' to '%s'", name.c_str(), val.c_str()); - try { - (*simgrid_config)[name.c_str()].setStringValue(val.c_str()); - } - catch (simgrid::config::missing_key_error& e) { - goto on_missing_key; - } - catch (...) { - goto on_exception; - } + (*simgrid_config)[name.c_str()].set_string_value(val.c_str()); } - return; - - /* Do not THROWF from a C++ exception catching context, or some cleanups will be missing */ -on_missing_key: - THROWF(not_found_error, 0, "Could not set variables %s", options); -on_exception: - THROWF(unknown_error, 0, "Could not set variables %s", options); } -// Horrible mess to translate C++ exceptions to C exceptions: -// Exit from the catch block (and do the correct exception cleaning) before attempting to THROWF. -#define TRANSLATE_EXCEPTIONS(...) \ - catch(simgrid::config::missing_key_error& e) { THROWF(not_found_error, 0, __VA_ARGS__); abort(); } \ - catch(...) { THROWF(not_found_error, 0, __VA_ARGS__); abort(); } - /** @brief Set the value of a variable, using the string representation of that value * * @param key name of the variable to modify @@ -559,11 +523,7 @@ on_exception: void xbt_cfg_set_as_string(const char *key, const char *value) { - try { - (*simgrid_config)[key].setStringValue(value); - return; - } - TRANSLATE_EXCEPTIONS("Could not set variable %s as string %s", key, value); + (*simgrid_config)[key].set_string_value(value); } /** @brief Set an integer value to \a name within \a cfg if it wasn't changed yet @@ -573,11 +533,7 @@ void xbt_cfg_set_as_string(const char *key, const char *value) */ void xbt_cfg_setdefault_int(const char *key, int value) { - try { - (*simgrid_config)[key].setDefaultValue(value); - return; - } - TRANSLATE_EXCEPTIONS("Could not set variable %s to default integer %i", key, value); + (*simgrid_config)[key].set_default_value(value); } /** @brief Set an integer value to \a name within \a cfg if it wasn't changed yet @@ -587,11 +543,7 @@ void xbt_cfg_setdefault_int(const char *key, int value) */ void xbt_cfg_setdefault_double(const char *key, double value) { - try { - (*simgrid_config)[key].setDefaultValue(value); - return; - } - TRANSLATE_EXCEPTIONS("Could not set variable %s to default double %f", key, value); + (*simgrid_config)[key].set_default_value(value); } /** @brief Set a string value to \a name within \a cfg if it wasn't changed yet @@ -601,11 +553,7 @@ void xbt_cfg_setdefault_double(const char *key, double value) */ void xbt_cfg_setdefault_string(const char *key, const char *value) { - try { - (*simgrid_config)[key].setDefaultValue(value ? value : ""); - return; - } - TRANSLATE_EXCEPTIONS("Could not set variable %s to default string %s", key, value); + (*simgrid_config)[key].set_default_value(value ? value : ""); } /** @brief Set an boolean value to \a name within \a cfg if it wasn't changed yet @@ -615,11 +563,7 @@ void xbt_cfg_setdefault_string(const char *key, const char *value) */ void xbt_cfg_setdefault_boolean(const char *key, const char *value) { - try { - (*simgrid_config)[key].setDefaultValue(simgrid::config::parseBool(value)); - return; - } - TRANSLATE_EXCEPTIONS("Could not set variable %s to default boolean %s", key, value); + (*simgrid_config)[key].set_default_value(simgrid::config::parse_bool(value)); } /** @brief Set an integer value to \a name within \a cfg @@ -629,11 +573,7 @@ void xbt_cfg_setdefault_boolean(const char *key, const char *value) */ void xbt_cfg_set_int(const char *key, int value) { - try { - (*simgrid_config)[key].setValue(value); - return; - } - TRANSLATE_EXCEPTIONS("Could not set variable %s to integer %i", key, value); + (*simgrid_config)[key].set_value(value); } /** @brief Set or add a double value to \a name within \a cfg @@ -643,11 +583,7 @@ void xbt_cfg_set_int(const char *key, int value) */ void xbt_cfg_set_double(const char *key, double value) { - try { - (*simgrid_config)[key].setValue(value); - return; - } - TRANSLATE_EXCEPTIONS("Could not set variable %s to double %f", key, value); + (*simgrid_config)[key].set_value(value); } /** @brief Set or add a string value to \a name within \a cfg @@ -658,11 +594,7 @@ void xbt_cfg_set_double(const char *key, double value) */ void xbt_cfg_set_string(const char* key, const char* value) { - try { - (*simgrid_config)[key].setValue(value); - return; - } - TRANSLATE_EXCEPTIONS("Could not set variable %s to string %s", key, value); + (*simgrid_config)[key].set_value(value); } /** @brief Set or add a boolean value to \a name within \a cfg @@ -672,21 +604,14 @@ void xbt_cfg_set_string(const char* key, const char* value) */ void xbt_cfg_set_boolean(const char *key, const char *value) { - try { - (*simgrid_config)[key].setValue(simgrid::config::parseBool(value)); - return; - } - TRANSLATE_EXCEPTIONS("Could not set variable %s to boolean %s", key, value); + (*simgrid_config)[key].set_value(simgrid::config::parse_bool(value)); } /* Say if the value is the default value */ int xbt_cfg_is_default_value(const char *key) { - try { - return (*simgrid_config)[key].isDefault() ? 1 : 0; - } - TRANSLATE_EXCEPTIONS("Could not get variable %s", key); + return (*simgrid_config)[key].is_default() ? 1 : 0; } /*----[ Getting ]---------------------------------------------------------*/ @@ -698,10 +623,7 @@ int xbt_cfg_is_default_value(const char *key) */ int xbt_cfg_get_int(const char *key) { - try { - return (*simgrid_config)[key].getValue(); - } - TRANSLATE_EXCEPTIONS("Could not get variable %s", key); + return (*simgrid_config)[key].get_value(); } /** @brief Retrieve a double value of a variable (get a warning if not uniq) @@ -712,10 +634,7 @@ int xbt_cfg_get_int(const char *key) */ double xbt_cfg_get_double(const char *key) { - try { - return (*simgrid_config)[key].getValue(); - } - TRANSLATE_EXCEPTIONS("Could not get variable %s", key); + return (*simgrid_config)[key].get_value(); } /** @brief Retrieve a string value of a variable (get a warning if not uniq) @@ -730,10 +649,7 @@ double xbt_cfg_get_double(const char *key) */ std::string xbt_cfg_get_string(const char* key) { - try { - return (*simgrid_config)[key].getValue(); - } - TRANSLATE_EXCEPTIONS("Could not get variable %s", key); + return (*simgrid_config)[key].get_value(); } /** @brief Retrieve a boolean value of a variable (get a warning if not uniq) @@ -745,10 +661,7 @@ std::string xbt_cfg_get_string(const char* key) */ int xbt_cfg_get_boolean(const char *key) { - try { - return (*simgrid_config)[key].getValue() ? 1 : 0; - } - TRANSLATE_EXCEPTIONS("Could not get variable %s", key); + return (*simgrid_config)[key].get_value() ? 1 : 0; } #ifdef SIMGRID_TEST @@ -765,15 +678,15 @@ XBT_LOG_EXTERNAL_DEFAULT_CATEGORY(xbt_cfg); XBT_TEST_SUITE("config", "Configuration support"); -XBT_PUBLIC_DATA(xbt_cfg_t) simgrid_config; +XBT_PUBLIC_DATA xbt_cfg_t simgrid_config; static void make_set() { simgrid_config = nullptr; xbt_log_threshold_set(&_XBT_LOGV(xbt_cfg), xbt_log_priority_critical); - xbt_cfg_register_int("speed", 0, nullptr, ""); - xbt_cfg_register_string("peername", "", nullptr, ""); - xbt_cfg_register_string("user", "", nullptr, ""); + simgrid::config::declare_flag("speed", "description", 0); + simgrid::config::declare_flag("peername", "description", ""); + simgrid::config::declare_flag("user", "description", ""); } /* end_of_make_set */ XBT_TEST_UNIT("memuse", test_config_memuse, "Alloc and free a config set") @@ -794,7 +707,7 @@ XBT_TEST_UNIT("use", test_config_use, "Data retrieving tests") { /* get_single_value */ xbt_cfg_set_parse("peername:toto:42 speed:42"); - int ival = xbt_cfg_get_int("speed"); + int ival = simgrid::config::get_config("speed"); if (ival != 42) xbt_test_fail("Speed value = %d, I expected 42", ival); }