X-Git-Url: http://info.iut-bm.univ-fcomte.fr/pub/gitweb/simgrid.git/blobdiff_plain/2539fff313cbd67c45b8490f7961e45e358d9ba2..5e61205077b453d1460c7008d1af3a68e6667db6:/src/xbt/config.c diff --git a/src/xbt/config.c b/src/xbt/config.c index 3f8b43d245..0e532308ef 100644 --- a/src/xbt/config.c +++ b/src/xbt/config.c @@ -1,1103 +1,1501 @@ -/* $Id$ */ - -/* config - Dictionnary where the type of each cell is provided. */ +/* config - Dictionnary where the type of each variable is provided. */ /* This is useful to build named structs, like option or property sets. */ -/* Authors: Martin Quinson */ -/* Copyright (C) 2001,2002,2003,2004 the OURAGAN project. */ +/* Copyright (c) 2004, 2005, 2006, 2007, 2008, 2009, 2010. 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. */ + * under the terms of the license (GNU LGPL) which comes with this package. */ +#include #include "xbt/misc.h" #include "xbt/sysdep.h" #include "xbt/log.h" -#include "xbt/error.h" +#include "xbt/ex.h" #include "xbt/dynar.h" #include "xbt/dict.h" +#include "xbt/peer.h" + +#include "xbt/config.h" /* prototypes of this module */ +#include "surf/surf_routing.h" /* COORD_HOST_LEVEL and COORD_ASR_LEVEL */ -#include "xbt/config.h" /* prototypes of this module */ +xbt_lib_t host_lib; +int COORD_HOST_LEVEL; //Coordinates level +xbt_lib_t as_router_lib; +int COORD_ASR_LEVEL; //Coordinates level -XBT_LOG_NEW_DEFAULT_SUBCATEGORY(config,xbt,"configuration support"); +XBT_LOG_NEW_DEFAULT_SUBCATEGORY(xbt_cfg, xbt, "configuration support"); -/* xbt_cfgelm_t: the typedef corresponding to a config cell. +/* xbt_cfgelm_t: the typedef corresponding to a config variable. Both data and DTD are mixed, but fixing it now would prevent me to ever defend my thesis. */ typedef struct { - /* Allowed type of the cell */ + /* Description */ + char *desc; + + /* Allowed type of the variable */ e_xbt_cfgelm_type_t type; - int min,max; + int min, max; + int isdefault:1; + + /* Callbacks */ + xbt_cfg_cb_t cb_set; + xbt_cfg_cb_t cb_rm; - /* actual content - (cannot be an union because type host uses both str and i) */ + /* actual content + (cannot be an union because type peer uses both str and i) */ xbt_dynar_t content; -} s_xbt_cfgelm_t,*xbt_cfgelm_t; +} s_xbt_cfgelm_t, *xbt_cfgelm_t; -static const char *xbt_cfgelm_type_name[xbt_cfgelm_type_count]= - {"int","double","string","host"}; +static const char *xbt_cfgelm_type_name[xbt_cfgelm_type_count] = + { "int", "double", "string", "peer", "any" }; -/* Internal stuff used in cache to free a cell */ +/* Internal stuff used in cache to free a variable */ static void xbt_cfgelm_free(void *data); -/* Retrieve the cell we'll modify */ -static xbt_error_t xbt_cfgelm_get(xbt_cfg_t cfg, const char *name, - e_xbt_cfgelm_type_t type, - /* OUT */ xbt_cfgelm_t *whereto); - -void xbt_cfg_str_free(void *d); -void xbt_cfg_host_free(void *d); - -void xbt_cfg_str_free(void *d){ - xbt_free(*(void**)d); -} -void xbt_cfg_host_free(void *d){ - xbt_host_t *h=(xbt_host_t*) *(void**)d; - if (h) { - if (h->name) xbt_free(h->name); - xbt_free(h); - } -} +/* Retrieve the variable we'll modify */ +static xbt_cfgelm_t xbt_cfgelm_get(xbt_cfg_t cfg, const char *name, + e_xbt_cfgelm_type_t type); /*----[ Memory management ]-----------------------------------------------*/ -/** - * xbt_cfg_new: - * - * @whereto: +/** @brief Constructor * * Initialise an config set */ -xbt_cfg_t xbt_cfg_new(void) { - return (xbt_cfg_t)xbt_dict_new(); +xbt_cfg_t xbt_cfg_new(void) +{ + return (xbt_cfg_t) xbt_dict_new(); } -/** - * xbt_cfg_cpy: +/** \brief Copy an existing configuration set * - * @whereto: the config set to be created - * @tocopy: the source data + * \arg whereto the config set to be created + * \arg tocopy the source data * + * This only copy the registrations, not the actual content */ -void -xbt_cfg_cpy(xbt_cfg_t tocopy,xbt_cfg_t *whereto) { - xbt_dict_cursor_t cursor=NULL; - xbt_cfgelm_t cell=NULL; - char *name=NULL; - - *whereto=NULL; - xbt_assert0(tocopy,"cannot copy NULL config"); - - xbt_dict_foreach((xbt_dict_t)tocopy,cursor,name,cell) { - xbt_cfg_register(*whereto, name, cell->type, cell->min, cell->max); +void xbt_cfg_cpy(xbt_cfg_t tocopy, xbt_cfg_t * whereto) +{ + xbt_dict_cursor_t cursor = NULL; + xbt_cfgelm_t variable = NULL; + char *name = NULL; + + XBT_DEBUG("Copy cfg set %p", tocopy); + *whereto = NULL; + xbt_assert(tocopy, "cannot copy NULL config"); + + xbt_dict_foreach((xbt_dict_t) tocopy, cursor, name, variable) { + xbt_cfg_register(whereto, name, variable->desc, variable->type, NULL, + variable->min, variable->max, variable->cb_set, + variable->cb_rm); } } -void xbt_cfg_free(xbt_cfg_t *cfg) { - xbt_dict_free((xbt_dict_t*)cfg); +/** @brief Destructor */ +void xbt_cfg_free(xbt_cfg_t * cfg) +{ + XBT_DEBUG("Frees cfg set %p", cfg); + xbt_dict_free((xbt_dict_t *) cfg); } -/** - * xbt_cfg_dump: - * @name: The name to give to this config set - * @indent: what to write at the begining of each line (right number of spaces) - * @cfg: the config set +/** @brief Dump a config set for debuging purpose * - * Dumps a config set for debuging purpose + * \arg name The name to give to this config set + * \arg indent what to write at the begining of each line (right number of spaces) + * \arg cfg the config set */ -void -xbt_cfg_dump(const char *name,const char *indent,xbt_cfg_t cfg) { +void xbt_cfg_dump(const char *name, const char *indent, xbt_cfg_t cfg) +{ xbt_dict_t dict = (xbt_dict_t) cfg; - xbt_dict_cursor_t cursor=NULL; - xbt_cfgelm_t cell=NULL; - char *key=NULL; - int i; - xbt_error_t errcode; + xbt_dict_cursor_t cursor = NULL; + xbt_cfgelm_t variable = NULL; + char *key = NULL; + int i; int size; int ival; char *sval; double dval; - xbt_host_t *hval; + xbt_peer_t hval; if (name) - printf("%s>> Dumping of the config set '%s':\n",indent,name); - xbt_dict_foreach(dict,cursor,key,cell) { + printf("%s>> Dumping of the config set '%s':\n", indent, name); + xbt_dict_foreach(dict, cursor, key, variable) { - printf("%s %s:",indent,key); + printf("%s %s:", indent, key); - size = xbt_dynar_length(cell->content); - printf("%d_to_%d_%s. Actual size=%d. List of values:\n", - cell->min,cell->max,xbt_cfgelm_type_name[cell->type], - size); + size = xbt_dynar_length(variable->content); + printf + ("%d_to_%d_%s. Actual size=%d. prerm=%p,postset=%p, List of values:\n", + variable->min, variable->max, + xbt_cfgelm_type_name[variable->type], size, variable->cb_rm, + variable->cb_set); + + switch (variable->type) { - switch (cell->type) { - case xbt_cfgelm_int: - for (i=0; icontent,i,int); - printf ("%s %d\n",indent,ival); + for (i = 0; i < size; i++) { + ival = xbt_dynar_get_as(variable->content, i, int); + printf("%s %d\n", indent, ival); } break; case xbt_cfgelm_double: - for (i=0; icontent,i,double); - printf ("%s %f\n",indent,dval); + for (i = 0; i < size; i++) { + dval = xbt_dynar_get_as(variable->content, i, double); + printf("%s %f\n", indent, dval); } break; case xbt_cfgelm_string: - for (i=0; icontent,i,char*); - printf ("%s %s\n",indent,sval); + for (i = 0; i < size; i++) { + sval = xbt_dynar_get_as(variable->content, i, char *); + printf("%s %s\n", indent, sval); } break; - case xbt_cfgelm_host: - for (i=0; icontent,i,xbt_host_t*); - printf ("%s %s:%d\n",indent,hval->name,hval->port); + case xbt_cfgelm_peer: + for (i = 0; i < size; i++) { + hval = xbt_dynar_get_as(variable->content, i, xbt_peer_t); + printf("%s %s:%d\n", indent, hval->name, hval->port); } break; default: - printf("%s Invalid type!!\n",indent); + printf("%s Invalid type!!\n", indent); } } - if (name) printf("%s<< End of the config set '%s'\n",indent,name); + if (name) + printf("%s<< End of the config set '%s'\n", indent, name); fflush(stdout); xbt_dict_cursor_free(&cursor); return; } -/** - * xbt_cfgelm_free: - * - * @data: the data to be freed (typed as void* to be usable as free funct in dict) - * +/* * free an config element */ -void xbt_cfgelm_free(void *data) { - xbt_cfgelm_t c=(xbt_cfgelm_t)data; +void xbt_cfgelm_free(void *data) +{ + xbt_cfgelm_t c = (xbt_cfgelm_t) data; - if (!c) return; + XBT_DEBUG("Frees cfgelm %p", c); + if (!c) + return; + xbt_free(c->desc); xbt_dynar_free(&(c->content)); - xbt_free(c); + free(c); } /*----[ Registering stuff ]-----------------------------------------------*/ -/** - * xbt_cfg_register: - * @cfg: the config set - * @type: the type of the config element - * @min: the minimum - * @max: the maximum +/** @brief Register an element within a config set * - * register an element within a config set + * @arg cfg the config set + * @arg type the type of the config element + * @arg min the minimum + * @arg max the maximum */ void -xbt_cfg_register(xbt_cfg_t cfg, - const char *name, e_xbt_cfgelm_type_t type, - int min, int max){ +xbt_cfg_register(xbt_cfg_t * cfg, + const char *name, const char *desc, + e_xbt_cfgelm_type_t type, void *default_value, int min, + int max, xbt_cfg_cb_t cb_set, xbt_cfg_cb_t cb_rm) +{ xbt_cfgelm_t res; - xbt_error_t errcode; - DEBUG4("Register cfg elm %s (%d to %d %s)",name,min,max,xbt_cfgelm_type_name[type]); - errcode = xbt_dict_get((xbt_dict_t)cfg,name,(void**)&res); + if (*cfg == NULL) + *cfg = xbt_cfg_new(); + xbt_assert(type >= xbt_cfgelm_int && type <= xbt_cfgelm_peer, + "type of %s not valid (%d should be between %d and %d)", + name, type, xbt_cfgelm_int, xbt_cfgelm_peer); + res = xbt_dict_get_or_null((xbt_dict_t) * cfg, name); - if (errcode == no_error) { - WARN1("Config elem %s registered twice.",name); + if (res) { + XBT_WARN("Config elem %s registered twice.", name); /* Will be removed by the insertion of the new one */ - } - xbt_assert_error(mismatch_error); + } - res=xbt_new(s_xbt_cfgelm_t,1); + res = xbt_new(s_xbt_cfgelm_t, 1); + XBT_DEBUG("Register cfg elm %s (%s) (%d to %d %s (=%d) @%p in set %p)", + name, desc, min, max, xbt_cfgelm_type_name[type], type, res, + *cfg); - res->type=type; - res->min=min; - res->max=max; + res->desc = xbt_strdup(desc); + res->type = type; + res->min = min; + res->max = max; + res->cb_set = cb_set; + res->cb_rm = cb_rm; + res->isdefault = 1; switch (type) { case xbt_cfgelm_int: res->content = xbt_dynar_new(sizeof(int), NULL); + if (default_value) + xbt_dynar_push(res->content, default_value); break; case xbt_cfgelm_double: res->content = xbt_dynar_new(sizeof(double), NULL); + if (default_value) + xbt_dynar_push(res->content, default_value); break; case xbt_cfgelm_string: - res->content = xbt_dynar_new(sizeof(char*),&xbt_cfg_str_free); - break; + res->content = xbt_dynar_new(sizeof(char *), xbt_free_ref); + if (default_value) + xbt_dynar_push(res->content, default_value); + break; - case xbt_cfgelm_host: - res->content = xbt_dynar_new(sizeof(xbt_host_t*),&xbt_cfg_host_free); - break; + case xbt_cfgelm_peer: + res->content = xbt_dynar_new(sizeof(xbt_peer_t), xbt_peer_free_voidp); + if (default_value) + xbt_dynar_push(res->content, default_value); + break; default: - ERROR1("%d is an invalide type code",type); + XBT_ERROR("%d is an invalide type code", type); } - - xbt_dict_set((xbt_dict_t)cfg,name,res,&xbt_cfgelm_free); + + xbt_dict_set((xbt_dict_t) * cfg, name, res, &xbt_cfgelm_free); } -/** - * xbt_cfg_unregister: - * - * @cfg: the config set - * @name: the name of the elem to be freed - * - * unregister an element from a config set. - * Note that it removes both the DTD and the actual content. +/** @brief Unregister an element from a config set. + * + * @arg cfg the config set + * @arg name the name of the elem to be freed + * + * Note that it removes both the description and the actual content. + * Throws not_found when no such element exists. */ -xbt_error_t -xbt_cfg_unregister(xbt_cfg_t cfg,const char *name) { - return xbt_dict_remove((xbt_dict_t)cfg,name); +void xbt_cfg_unregister(xbt_cfg_t cfg, const char *name) +{ + XBT_DEBUG("Unregister elm '%s' from set %p", name, cfg); + xbt_dict_remove((xbt_dict_t) cfg, name); } /** - * xbt_cfg_register_str: + * @brief Parse a string and register the stuff described. + * + * @arg cfg the config set + * @arg entry a string describing the element to register * - * @cfg: the config set - * @entry: a string describing the element to register + * The string may consist in several variable descriptions separated by a space. + * Each of them must use the following syntax: \:\_to_\_\ + * with type being one of 'string','int', 'peer' or 'double'. * - * Parse a string and register the stuff described. + * FIXME: this does not allow to set the description */ -xbt_error_t -xbt_cfg_register_str(xbt_cfg_t cfg,const char *entry) { - char *entrycpy=xbt_strdup(entry); +void xbt_cfg_register_str(xbt_cfg_t * cfg, const char *entry) +{ + char *entrycpy = xbt_strdup(entry); char *tok; - int min,max; + int min, max; e_xbt_cfgelm_type_t type; + XBT_DEBUG("Register string '%s'", entry); - tok=strchr(entrycpy, ':'); - if (!tok) { - ERROR3("%s%s%s", - "Invalid config element descriptor: ",entry, - "; Should be :_to__"); - xbt_free(entrycpy); - xbt_abort(); - } - *(tok++)='\0'; + tok = strchr(entrycpy, ':'); + xbt_assert(tok, "Invalid config element descriptor: %s%s", + entry, "; Should be :_to__"); + *(tok++) = '\0'; - min=strtol(tok, &tok, 10); - if (!tok) { - ERROR1("Invalid minimum in config element descriptor %s",entry); - xbt_free(entrycpy); - xbt_abort(); - } + min = strtol(tok, &tok, 10); + xbt_assert(tok, "Invalid minimum in config element descriptor %s", + entry); - if (!strcmp(tok,"_to_")){ - ERROR3("%s%s%s", - "Invalid config element descriptor: ",entry, - "; Should be :_to__"); - xbt_free(entrycpy); - xbt_abort(); - } + xbt_assert(strcmp(tok, "_to_"), + "Invalid config element descriptor : %s%s", + entry, "; Should be :_to__"); tok += strlen("_to_"); - max=strtol(tok, &tok, 10); - if (!tok) { - ERROR1("Invalid maximum in config element descriptor %s",entry); - xbt_free(entrycpy); - xbt_abort(); - } + max = strtol(tok, &tok, 10); + xbt_assert(tok, "Invalid maximum in config element descriptor %s", + entry); - if (*(tok++)!='_') { - ERROR3("%s%s%s", - "Invalid config element descriptor: ",entry, - "; Should be :_to__"); - xbt_free(entrycpy); - xbt_abort(); - } + xbt_assert(*tok == '_', + "Invalid config element descriptor: %s%s", entry, + "; Should be :_to__"); + tok++; - for (type=0; - typedesc); + printf(" Type: %s; ", xbt_cfgelm_type_name[variable->type]); + if (variable->min != 1 || variable->max != 1) { + if (variable->min == 0 && variable->max == 0) + printf("Arity: no bound; "); + else + printf("Arity: min:%d to max:%d; ", variable->min, variable->max); + } + printf("Current value: "); + size = xbt_dynar_length(variable->content); + + switch (variable->type) { + int ival; + char *sval; + double dval; + xbt_peer_t hval; + + case xbt_cfgelm_int: + for (i = 0; i < size; i++) { + ival = xbt_dynar_get_as(variable->content, i, int); + printf("%s%d\n", (i == 0 ? "" : " "), ival); + } + break; + + case xbt_cfgelm_double: + for (i = 0; i < size; i++) { + dval = xbt_dynar_get_as(variable->content, i, double); + printf("%s%f\n", (i == 0 ? "" : " "), dval); + } + break; + + case xbt_cfgelm_string: + for (i = 0; i < size; i++) { + sval = xbt_dynar_get_as(variable->content, i, char *); + printf("%s'%s'\n", (i == 0 ? "" : " "), sval); + } + break; + + case xbt_cfgelm_peer: + for (i = 0; i < size; i++) { + hval = xbt_dynar_get_as(variable->content, i, xbt_peer_t); + printf("%s%s:%d\n", (i == 0 ? "" : " "), hval->name, + hval->port); + } + break; + + default: + printf("Invalid type!!\n"); + } + + } + + xbt_dynar_free(&names); +} + +/** @brief Check that each variable have the right amount of values */ +void xbt_cfg_check(xbt_cfg_t cfg) +{ + xbt_dict_cursor_t cursor; + xbt_cfgelm_t variable; char *name; int size; - xbt_assert0(cfg,"NULL config set."); + xbt_assert(cfg, "NULL config set."); + XBT_DEBUG("Check cfg set %p", cfg); - xbt_dict_foreach((xbt_dict_t)cfg,cursor,name,cell) { - size = xbt_dynar_length(cell->content); - if (cell->min > size) { - ERROR4("Config elem %s needs at least %d %s, but there is only %d values.", - name, - cell->min, - xbt_cfgelm_type_name[cell->type], - size); + xbt_dict_foreach((xbt_dict_t) cfg, cursor, name, variable) { + size = xbt_dynar_length(variable->content); + if (variable->min > size) { xbt_dict_cursor_free(&cursor); - return mismatch_error; + THROWF(mismatch_error, 0, + "Config elem %s needs at least %d %s, but there is only %d values.", + name, variable->min, xbt_cfgelm_type_name[variable->type], + size); } - if (cell->max < size) { - ERROR4("Config elem %s accepts at most %d %s, but there is %d values.", - name, - cell->max, - xbt_cfgelm_type_name[cell->type], - size); + if (variable->max > 0 && variable->max < size) { xbt_dict_cursor_free(&cursor); - return mismatch_error; + THROWF(mismatch_error, 0, + "Config elem %s accepts at most %d %s, but there is %d values.", + name, variable->max, xbt_cfgelm_type_name[variable->type], + size); } - } xbt_dict_cursor_free(&cursor); - return no_error; } -static xbt_error_t xbt_cfgelm_get(xbt_cfg_t cfg, - const char *name, - e_xbt_cfgelm_type_t type, - /* OUT */ xbt_cfgelm_t *whereto){ - - xbt_error_t errcode = xbt_dict_get((xbt_dict_t)cfg,name, - (void**)whereto); - - if (errcode == mismatch_error) { - ERROR1("No registered cell %s in this config set", - name); - return mismatch_error; +static xbt_cfgelm_t xbt_cfgelm_get(xbt_cfg_t cfg, + const char *name, + e_xbt_cfgelm_type_t type) +{ + xbt_cfgelm_t res = NULL; + + res = xbt_dict_get_or_null((xbt_dict_t) cfg, name); + if (!res) { + xbt_cfg_help(cfg); + THROWF(not_found_error, 0, + "No registered variable '%s' in this config set", name); } - if (errcode != no_error) - return errcode; - xbt_assert3((*whereto)->type == type, - "You tried to access to the config element %s as an %s, but its type is %s.", - name, - xbt_cfgelm_type_name[type], - xbt_cfgelm_type_name[(*whereto)->type]); + xbt_assert(type == xbt_cfgelm_any || res->type == type, + "You tried to access to the config element %s as an %s, but its type is %s.", + name, + xbt_cfgelm_type_name[type], xbt_cfgelm_type_name[res->type]); - return no_error; + return res; } -/** - * xbt_cfg_get_type: +/** @brief Get the type of this variable in that configuration set * - * @cfg: the config set - * @name: the name of the element - * @type: the result + * \arg cfg the config set + * \arg name the name of the element + * \arg type the result * - * Give the type of the config element */ -xbt_error_t -xbt_cfg_get_type(xbt_cfg_t cfg, const char *name, - /* OUT */e_xbt_cfgelm_type_t *type) { +e_xbt_cfgelm_type_t xbt_cfg_get_type(xbt_cfg_t cfg, const char *name) +{ - xbt_cfgelm_t cell; - xbt_error_t errcode; + xbt_cfgelm_t variable = NULL; - TRYCATCH(mismatch_error,xbt_dict_get((xbt_dict_t)cfg,name,(void**)&cell)); + variable = xbt_dict_get_or_null((xbt_dict_t) cfg, name); + if (!variable) + THROWF(not_found_error, 0, + "Can't get the type of '%s' since this variable does not exist", + name); - if (errcode == mismatch_error) { - ERROR1("Can't get the type of '%s' since this cell does not exist", - name); - return mismatch_error; - } - - *type=cell->type; + XBT_INFO("type in variable = %d", variable->type); - return no_error; + return variable->type; } /*----[ Setting ]---------------------------------------------------------*/ -/** - * xbt_cfg_set_vargs(): - * @cfg: config set to fill - * @varargs: NULL-terminated list of pairs {(const char*)key, value} +/** @brief va_args version of xbt_cfg_set + * + * \arg cfg config set to fill + * \arg n variable name + * \arg pa variable value * * Add some values to the config set. - * @warning: if the list isn't NULL terminated, it will segfault. */ -xbt_error_t -xbt_cfg_set_vargs(xbt_cfg_t cfg, va_list pa) { - char *str,*name; +void xbt_cfg_set_vargs(xbt_cfg_t cfg, const char *name, va_list pa) +{ + char *str; int i; double d; - e_xbt_cfgelm_type_t type; - - xbt_error_t errcode; - - while ((name=va_arg(pa,char *))) { - - if (!xbt_cfg_get_type(cfg,name,&type)) { - ERROR1("Can't set the property '%s' since it's not registered",name); - return mismatch_error; + e_xbt_cfgelm_type_t type = 0; /* Set a dummy value to make gcc happy. It cannot get uninitialized */ + + xbt_ex_t e; + + TRY { + type = xbt_cfg_get_type(cfg, name); + } CATCH(e) { + if (e.category == not_found_error) { + xbt_ex_free(e); + THROWF(not_found_error, 0, + "Can't set the property '%s' since it's not registered", + name); } + RETHROW; + } - switch (type) { - case xbt_cfgelm_host: - str = va_arg(pa, char *); - i=va_arg(pa,int); - TRY(xbt_cfg_set_host(cfg,name,str,i)); - break; - - case xbt_cfgelm_string: - str=va_arg(pa, char *); - TRY(xbt_cfg_set_string(cfg, name, str)); - break; + switch (type) { + case xbt_cfgelm_peer: + str = va_arg(pa, char *); + i = va_arg(pa, int); + xbt_cfg_set_peer(cfg, name, str, i); + break; - case xbt_cfgelm_int: - i=va_arg(pa,int); - TRY(xbt_cfg_set_int(cfg,name,i)); - break; + case xbt_cfgelm_string: + str = va_arg(pa, char *); + xbt_cfg_set_string(cfg, name, str); + break; - case xbt_cfgelm_double: - d=va_arg(pa,double); - TRY(xbt_cfg_set_double(cfg,name,d)); - break; + case xbt_cfgelm_int: + i = va_arg(pa, int); + xbt_cfg_set_int(cfg, name, i); + break; - default: - RAISE1(unknown_error,"Config element cell %s not valid.",name); - } + case xbt_cfgelm_double: + d = va_arg(pa, double); + xbt_cfg_set_double(cfg, name, d); + break; + + default: + xbt_die("Config element variable %s not valid (type=%d)", name, type); } - return no_error; } -/** - * xbt_cfg_set(): - * @cfg: config set to fill - * @varargs: NULL-terminated list of pairs {(const char*)key, value} +/** @brief Add a NULL-terminated list of pairs {(char*)key, value} to the set + * + * \arg cfg config set to fill + * \arg name variable name + * \arg varargs variable value * - * Add some values to the config set. - * @warning: if the list isn't NULL terminated, it will segfault. */ -xbt_error_t xbt_cfg_set(xbt_cfg_t cfg, ...) { +void xbt_cfg_set(xbt_cfg_t cfg, const char *name, ...) +{ va_list pa; - xbt_error_t errcode; - va_start(pa,cfg); - errcode=xbt_cfg_set_vargs(cfg,pa); + va_start(pa, name); + xbt_cfg_set_vargs(cfg, name, pa); va_end(pa); - return errcode; } -/** - * xbt_cfg_set_parse(): - * @cfg: config set to fill - * @options: a string containing the content to add to the config set. This - * is a '\t',' ' or '\n' separated list of cells. Each individual cell is - * like "[name]:[value]" where [name] is the name of an already registred - * cell, and [value] conforms to the data type under which this cell was +/** @brief Add values parsed from a string into a config set + * + * \arg cfg config set to fill + * \arg options a string containing the content to add to the config set. This + * is a '\\t',' ' or '\\n' or ',' separated list of variables. Each individual variable is + * like "[name]:[value]" where [name] is the name of an already registred + * variable, and [value] conforms to the data type under which this variable was * registred. * - * Add the cells described in a string to a config set. + * @todo This is a crude manual parser, it should be a proper lexer. */ -xbt_error_t -xbt_cfg_set_parse(xbt_cfg_t cfg, const char *options) { +void xbt_cfg_set_parse(xbt_cfg_t cfg, const char *options) +{ + xbt_ex_t e; + int i; double d; char *str; - xbt_cfgelm_t cell; + xbt_cfgelm_t variable = NULL; char *optionlist_cpy; - char *option, *name,*val; + char *option, *name, *val; int len; - xbt_error_t errcode; - XBT_IN; - if (!options || !strlen(options)) { /* nothing to do */ - return no_error; + XBT_IN(""); + if (!options || !strlen(options)) { /* nothing to do */ + return; } - optionlist_cpy=xbt_strdup(options); + optionlist_cpy = xbt_strdup(options); - DEBUG1("List to parse and set:'%s'",options); - option=optionlist_cpy; - while (1) { /* breaks in the code */ + XBT_DEBUG("List to parse and set:'%s'", options); + option = optionlist_cpy; + while (1) { /* breaks in the code */ - if (!option) + if (!option) break; - name=option; - len=strlen(name); - DEBUG3("Still to parse and set: '%s'. len=%d; option-name=%ld", - name,len,(long)(option-name)); + name = option; + len = strlen(name); + XBT_DEBUG("Still to parse and set: '%s'. len=%d; option-name=%ld", + name, len, (long) (option - name)); /* Pass the value */ - while (option-name<=(len-1) && *option != ' ' && *option != '\n' && *option != '\t') { - /*fprintf(stderr,"Take %c.\n",*option);*/ + while (option - name <= (len - 1) && *option != ' ' && *option != '\n' + && *option != '\t' && *option != ',') { + XBT_DEBUG("Take %c.", *option); option++; } - if (option-name == len) { - /*fprintf(stderr,"Boundary=EOL\n");*/ - option=NULL; /* don't do next iteration */ + if (option - name == len) { + XBT_DEBUG("Boundary=EOL"); + option = NULL; /* don't do next iteration */ } else { - /*fprintf(stderr,"Boundary on '%c'. len=%d;option-name=%d\n",*option,len,option-name);*/ + XBT_DEBUG("Boundary on '%c'. len=%d;option-name=%ld", + *option, len, (long) (option - name)); /* Pass the following blank chars */ - *(option++)='\0'; - while (option-name<(len-1) && (*option == ' ' || *option == '\n' || *option == '\t')) { - /* fprintf(stderr,"Ignore a blank char.\n");*/ - option++; + *(option++) = '\0'; + while (option - name < (len - 1) && + (*option == ' ' || *option == '\n' || *option == '\t')) { + /* fprintf(stderr,"Ignore a blank char.\n"); */ + option++; } - if (option-name == len-1) - option=NULL; /* don't do next iteration */ + if (option - name == len - 1) + option = NULL; /* don't do next iteration */ } - DEBUG2("parse now:'%s'; parse later:'%s'",name,option); + XBT_DEBUG("parse now:'%s'; parse later:'%s'", name, option); if (name[0] == ' ' || name[0] == '\n' || name[0] == '\t') continue; if (!strlen(name)) break; - - val=strchr(name,':'); + + val = strchr(name, ':'); if (!val) { - xbt_free(optionlist_cpy); - xbt_assert1(FALSE, - "Malformated option: '%s'; Should be of the form 'name:value'", - name); + free(optionlist_cpy); + xbt_die("Option '%s' badly formated. Should be of the form 'name:value'", + name); } - *(val++)='\0'; - - DEBUG2("name='%s';val='%s'",name,val); - - errcode=xbt_dict_get((xbt_dict_t)cfg,name,(void**)&cell); - switch (errcode) { - case no_error: - break; - case mismatch_error: - ERROR1("No registrated cell corresponding to '%s'.",name); - xbt_free(optionlist_cpy); - return mismatch_error; - break; - default: - xbt_free(optionlist_cpy); - return errcode; + *(val++) = '\0'; + + if (!strcmp(name,"coordinates")){ + if(!strcmp(val,"yes") && !COORD_HOST_LEVEL){ + XBT_INFO("Configuration change: Set '%s' to '%s'", name, val); + COORD_HOST_LEVEL = xbt_lib_add_level(host_lib,xbt_dynar_free_voidp); + COORD_ASR_LEVEL = xbt_lib_add_level(as_router_lib,xbt_dynar_free_voidp); + free(optionlist_cpy); + return; + } + if(strcmp(val,"yes")) + xbt_die("Setting CMD prop coordinates must be \"yes\""); } - switch (cell->type) { - case xbt_cfgelm_string: - TRYCLEAN(xbt_cfg_set_string(cfg, name, val), - xbt_free(optionlist_cpy)); - break; + if (strncmp(name, "contexts/", strlen("contexts/"))) + XBT_INFO("Configuration change: Set '%s' to '%s'", name, val); - case xbt_cfgelm_int: - i=strtol(val, &val, 0); - if (val==NULL) { - xbt_free(optionlist_cpy); - xbt_assert1(FALSE, - "Value of option %s not valid. Should be an integer", - name); + TRY { + variable = xbt_dict_get((xbt_dict_t) cfg, name); + } + CATCH(e) { + if (e.category == not_found_error) { + xbt_ex_free(e); + name = xbt_strdup(name); + free(optionlist_cpy); + THROWF(not_found_error, 0, + "No registered variable corresponding to '%s'.", name); } + free(optionlist_cpy); + RETHROW; + } - TRYCLEAN(xbt_cfg_set_int(cfg,name,i), - xbt_free(optionlist_cpy)); - break; - - case xbt_cfgelm_double: - d=strtod(val, &val); - if (val==NULL) { - xbt_free(optionlist_cpy); - xbt_assert1(FALSE, - "Value of option %s not valid. Should be a double", - name); + TRY { + switch (variable->type) { + case xbt_cfgelm_string: + xbt_cfg_set_string(cfg, name, val); /* throws */ + break; + + case xbt_cfgelm_int: + i = strtol(val, &val, 0); + if (val == NULL) { + free(optionlist_cpy); + xbt_die("Value of option %s not valid. Should be an integer", name); + } + + xbt_cfg_set_int(cfg, name, i); /* throws */ + break; + + case xbt_cfgelm_double: + d = strtod(val, &val); + if (val == NULL) { + free(optionlist_cpy); + xbt_die("Value of option %s not valid. Should be a double", name); + } + + xbt_cfg_set_double(cfg, name, d); /* throws */ + break; + + case xbt_cfgelm_peer: + str = val; + val = strchr(val, ':'); + if (!val) { + free(optionlist_cpy); + xbt_die("Value of option %s not valid. Should be an peer (machine:port)", + name); + } + + *(val++) = '\0'; + i = strtol(val, &val, 0); + if (val == NULL) { + free(optionlist_cpy); + xbt_die("Value of option %s not valid. Should be an peer (machine:port)", + name); + } + + xbt_cfg_set_peer(cfg, name, str, i); /* throws */ + break; + + default: + THROWF(unknown_error, 0, "Type of config element %s is not valid.", + name); } + } + CATCH(e) { + free(optionlist_cpy); + RETHROW; + } + } + free(optionlist_cpy); - TRYCLEAN(xbt_cfg_set_double(cfg,name,d), - xbt_free(optionlist_cpy)); - break; +} - case xbt_cfgelm_host: - str=val; - val=strchr(val,':'); - if (!val) { - xbt_free(optionlist_cpy); - xbt_assert1(FALSE, - "Value of option %s not valid. Should be an host (machine:port)", - name); - } +/** @brief Set an integer value to \a name within \a cfg if it wasn't changed yet + * + * This is useful to change the default value of a variable while allowing + * users to override it with command line arguments + */ +void xbt_cfg_setdefault_int(xbt_cfg_t cfg, const char *name, int val) +{ + xbt_cfgelm_t variable = xbt_cfgelm_get(cfg, name, xbt_cfgelm_int); - *(val++)='\0'; - i=strtol(val, &val, 0); - if (val==NULL) { - xbt_free(optionlist_cpy); - xbt_assert1(FALSE, - "Value of option %s not valid. Should be an host (machine:port)", - name); - } + if (variable->isdefault){ + xbt_cfg_set_int(cfg, name, val); + variable->isdefault = 1; + } + else + XBT_DEBUG + ("Do not override configuration variable '%s' with value '%d' because it was already set.", + name, val); +} - TRYCLEAN(xbt_cfg_set_host(cfg,name,str,i), - xbt_free(optionlist_cpy)); - break; +/** @brief Set an integer value to \a name within \a cfg if it wasn't changed yet + * + * This is useful to change the default value of a variable while allowing + * users to override it with command line arguments + */ +void xbt_cfg_setdefault_double(xbt_cfg_t cfg, const char *name, double val) +{ + xbt_cfgelm_t variable = xbt_cfgelm_get(cfg, name, xbt_cfgelm_double); - default: - xbt_free(optionlist_cpy); - RAISE1(unknown_error,"Type of config element %s is not valid.",name); - } - + if (variable->isdefault) { + xbt_cfg_set_double(cfg, name, val); + variable->isdefault = 1; } - xbt_free(optionlist_cpy); - return no_error; + else + XBT_DEBUG + ("Do not override configuration variable '%s' with value '%lf' because it was already set.", + name, val); } -/** - * xbt_cfg_set_int: +/** @brief Set a string value to \a name within \a cfg if it wasn't changed yet + * + * This is useful to change the default value of a variable while allowing + * users to override it with command line arguments + */ +void xbt_cfg_setdefault_string(xbt_cfg_t cfg, const char *name, + const char *val) +{ + xbt_cfgelm_t variable = xbt_cfgelm_get(cfg, name, xbt_cfgelm_string); + + if (variable->isdefault){ + xbt_cfg_set_string(cfg, name, val); + variable->isdefault = 1; + } + else + XBT_DEBUG + ("Do not override configuration variable '%s' with value '%s' because it was already set.", + name, val); +} + +/** @brief Set a peer value to \a name within \a cfg if it wasn't changed yet * - * @cfg: the config set - * @name: the name of the cell - * @val: the value of the cell + * This is useful to change the default value of a variable while allowing + * users to override it with command line arguments + */ +void xbt_cfg_setdefault_peer(xbt_cfg_t cfg, const char *name, + const char *host, int port) +{ + xbt_cfgelm_t variable = xbt_cfgelm_get(cfg, name, xbt_cfgelm_peer); + + if (variable->isdefault){ + xbt_cfg_set_peer(cfg, name, host, port); + variable->isdefault = 1; + } + else + XBT_DEBUG + ("Do not override configuration variable '%s' with value '%s:%d' because it was already set.", + name, host, port); +} + +/** @brief Set or add an integer value to \a name within \a cfg * - * Set the value of the cell @name in @cfg with the provided value. - */ -xbt_error_t -xbt_cfg_set_int(xbt_cfg_t cfg,const char*name, int val) { - xbt_cfgelm_t cell; - xbt_error_t errcode; - - VERB2("Configuration setting: %s=%d",name,val); - TRY (xbt_cfgelm_get(cfg,name,xbt_cfgelm_int,&cell)); - - if (cell->max > 1) { - xbt_dynar_push(cell->content,&val); + * \arg cfg the config set + * \arg name the name of the variable + * \arg val the value of the variable + */ +void xbt_cfg_set_int(xbt_cfg_t cfg, const char *name, int val) +{ + xbt_cfgelm_t variable; + + XBT_VERB("Configuration setting: %s=%d", name, val); + variable = xbt_cfgelm_get(cfg, name, xbt_cfgelm_int); + + if (variable->max == 1) { + if (variable->cb_rm && xbt_dynar_length(variable->content)) + (*variable->cb_rm) (name, 0); + + xbt_dynar_set(variable->content, 0, &val); } else { - xbt_dynar_set(cell->content,0,&val); + if (variable->max + && xbt_dynar_length(variable->content) == + (unsigned long) variable->max) + THROWF(mismatch_error, 0, + "Cannot add value %d to the config element %s since it's already full (size=%d)", + val, name, variable->max); + + xbt_dynar_push(variable->content, &val); } - return no_error; + + if (variable->cb_set) + (*variable->cb_set) (name, xbt_dynar_length(variable->content) - 1); + variable->isdefault = 0; } -/** - * xbt_cfg_set_double: - * @cfg: the config set - * @name: the name of the cell - * @val: the doule to set - * - * Set the value of the cell @name in @cfg with the provided value. - */ - -xbt_error_t -xbt_cfg_set_double(xbt_cfg_t cfg,const char*name, double val) { - xbt_cfgelm_t cell; - xbt_error_t errcode; - - VERB2("Configuration setting: %s=%f",name,val); - TRY (xbt_cfgelm_get(cfg,name,xbt_cfgelm_double,&cell)); - - if (cell->max > 1) { - xbt_dynar_push(cell->content,&val); +/** @brief Set or add a double value to \a name within \a cfg + * + * \arg cfg the config set + * \arg name the name of the variable + * \arg val the doule to set + */ + +void xbt_cfg_set_double(xbt_cfg_t cfg, const char *name, double val) +{ + xbt_cfgelm_t variable; + + XBT_VERB("Configuration setting: %s=%f", name, val); + variable = xbt_cfgelm_get(cfg, name, xbt_cfgelm_double); + + if (variable->max == 1) { + if (variable->cb_rm && xbt_dynar_length(variable->content)) + (*variable->cb_rm) (name, 0); + + xbt_dynar_set(variable->content, 0, &val); } else { - xbt_dynar_set(cell->content,0,&val); + if (variable->max + && xbt_dynar_length(variable->content) == variable->max) + THROWF(mismatch_error, 0, + "Cannot add value %f to the config element %s since it's already full (size=%d)", + val, name, variable->max); + + xbt_dynar_push(variable->content, &val); } - return no_error; + + if (variable->cb_set) + (*variable->cb_set) (name, xbt_dynar_length(variable->content) - 1); + variable->isdefault = 0; } -/** - * xbt_cfg_set_string: - * - * @cfg: the config set - * @name: the name of the cell - * @val: the value to be added +/** @brief Set or add a string value to \a name within \a cfg + * + * \arg cfg the config set + * \arg name the name of the variable + * \arg val the value to be added * - * Set the value of the cell @name in @cfg with the provided value. - */ + */ -xbt_error_t -xbt_cfg_set_string(xbt_cfg_t cfg,const char*name, const char*val) { - xbt_cfgelm_t cell; - xbt_error_t errcode; +void xbt_cfg_set_string(xbt_cfg_t cfg, const char *name, const char *val) +{ + xbt_cfgelm_t variable; char *newval = xbt_strdup(val); - VERB2("Configuration setting: %s=%s",name,val); - TRY (xbt_cfgelm_get(cfg,name,xbt_cfgelm_string,&cell)); + XBT_VERB("Configuration setting: %s=%s", name, val); + variable = xbt_cfgelm_get(cfg, name, xbt_cfgelm_string); + XBT_DEBUG("Variable: %d to %d %s (=%d) @%p", + variable->min, variable->max, + xbt_cfgelm_type_name[variable->type], variable->type, variable); + + if (variable->max == 1) { + if (xbt_dynar_length(variable->content)) { + if (variable->cb_rm) + (*variable->cb_rm) (name, 0); + else if (variable->type == xbt_cfgelm_string) { + char *sval = xbt_dynar_get_as(variable->content, 0, char *); + free(sval); + } + } - if (cell->max > 1) { - xbt_dynar_push(cell->content,&newval); + xbt_dynar_set(variable->content, 0, &newval); } else { - xbt_dynar_set(cell->content,0,&newval); + if (variable->max + && xbt_dynar_length(variable->content) == variable->max) + THROWF(mismatch_error, 0, + "Cannot add value %s to the config element %s since it's already full (size=%d)", + name, val, variable->max); + + xbt_dynar_push(variable->content, &newval); } - return no_error; + + if (variable->cb_set) + (*variable->cb_set) (name, xbt_dynar_length(variable->content) - 1); + variable->isdefault = 0; } -/** - * xbt_cfg_set_host: - * - * @cfg: the config set - * @name: the name of the cell - * @host: the host - * @port: the port number +/** @brief Set or add an peer value to \a name within \a cfg * - * Set the value of the cell @name in @cfg with the provided value - * on the given @host to the given @port - */ + * \arg cfg the config set + * \arg name the name of the variable + * \arg peer the peer + * \arg port the port number + * + * \e peer values are composed of a string (peername) and an integer (port) + */ -xbt_error_t -xbt_cfg_set_host(xbt_cfg_t cfg,const char*name, - const char *host,int port) { - xbt_cfgelm_t cell; - xbt_error_t errcode; - xbt_host_t *val=xbt_new(xbt_host_t,1); +void +xbt_cfg_set_peer(xbt_cfg_t cfg, const char *name, const char *peer, + int port) +{ + xbt_cfgelm_t variable; + xbt_peer_t val = xbt_peer_new(peer, port); - VERB3("Configuration setting: %s=%s:%d",name,host,port); + XBT_VERB("Configuration setting: %s=%s:%d", name, peer, port); - val->name = xbt_strdup(name); - val->port = port; + variable = xbt_cfgelm_get(cfg, name, xbt_cfgelm_peer); - TRY (xbt_cfgelm_get(cfg,name,xbt_cfgelm_host,&cell)); + if (variable->max == 1) { + if (variable->cb_rm && xbt_dynar_length(variable->content)) + (*variable->cb_rm) (name, 0); - if (cell->max > 1) { - xbt_dynar_push(cell->content,&val); + xbt_dynar_set(variable->content, 0, &val); } else { - xbt_dynar_set(cell->content,0,&val); + if (variable->max + && xbt_dynar_length(variable->content) == variable->max) + THROWF(mismatch_error, 0, + "Cannot add value %s:%d to the config element %s since it's already full (size=%d)", + peer, port, name, variable->max); + + xbt_dynar_push(variable->content, &val); } - return no_error; + + if (variable->cb_set) + (*variable->cb_set) (name, xbt_dynar_length(variable->content) - 1); + variable->isdefault = 0; } /* ---- [ Removing ] ---- */ -/** - * xbt_cfg_rm_int: +/** @brief Remove the provided \e val integer value from a variable * - * @cfg: the config set - * @name: the name of the cell - * @val: the value to be removed - * - * Remove the provided @val from the cell @name in @cfg. + * \arg cfg the config set + * \arg name the name of the variable + * \arg val the value to be removed */ -xbt_error_t xbt_cfg_rm_int(xbt_cfg_t cfg,const char*name, int val) { +void xbt_cfg_rm_int(xbt_cfg_t cfg, const char *name, int val) +{ + + xbt_cfgelm_t variable; + unsigned int cpt; + int seen; - xbt_cfgelm_t cell; - int cpt,seen; - xbt_error_t errcode; + variable = xbt_cfgelm_get(cfg, name, xbt_cfgelm_int); - TRY (xbt_cfgelm_get(cfg,name,xbt_cfgelm_int,&cell)); - - xbt_dynar_foreach(cell->content,cpt,seen) { + if (xbt_dynar_length(variable->content) == variable->min) + THROWF(mismatch_error, 0, + "Cannot remove value %d from the config element %s since it's already at its minimal size (=%d)", + val, name, variable->min); + + xbt_dynar_foreach(variable->content, cpt, seen) { if (seen == val) { - xbt_dynar_cursor_rm(cell->content,&cpt); - return no_error; + if (variable->cb_rm) + (*variable->cb_rm) (name, cpt); + xbt_dynar_cursor_rm(variable->content, &cpt); + return; } } - ERROR2("Can't remove the value %d of config element %s: value not found.", - val,name); - return mismatch_error; + THROWF(not_found_error, 0, + "Can't remove the value %d of config element %s: value not found.", + val, name); } -/** - * xbt_cfg_rm_double: +/** @brief Remove the provided \e val double value from a variable * - * @cfg: the config set - * @name: the name of the cell - * @val: the value to be removed - * - * Remove the provided @val from the cell @name in @cfg. + * \arg cfg the config set + * \arg name the name of the variable + * \arg val the value to be removed */ -xbt_error_t xbt_cfg_rm_double(xbt_cfg_t cfg,const char*name, double val) { - xbt_cfgelm_t cell; - int cpt; +void xbt_cfg_rm_double(xbt_cfg_t cfg, const char *name, double val) +{ + xbt_cfgelm_t variable; + unsigned int cpt; double seen; - xbt_error_t errcode; - TRY (xbt_cfgelm_get(cfg,name,xbt_cfgelm_double,&cell)); - - xbt_dynar_foreach(cell->content,cpt,seen) { + variable = xbt_cfgelm_get(cfg, name, xbt_cfgelm_double); + + if (xbt_dynar_length(variable->content) == variable->min) + THROWF(mismatch_error, 0, + "Cannot remove value %f from the config element %s since it's already at its minimal size (=%d)", + val, name, variable->min); + + xbt_dynar_foreach(variable->content, cpt, seen) { if (seen == val) { - xbt_dynar_cursor_rm(cell->content,&cpt); - return no_error; + xbt_dynar_cursor_rm(variable->content, &cpt); + if (variable->cb_rm) + (*variable->cb_rm) (name, cpt); + return; } } - ERROR2("Can't remove the value %f of config element %s: value not found.", - val,name); - return mismatch_error; + THROWF(not_found_error, 0, + "Can't remove the value %f of config element %s: value not found.", + val, name); } -/** - * xbt_cfg_rm_string: +/** @brief Remove the provided \e val string value from a variable * - * @cfg: the config set - * @name: the name of the cell - * @val: the value of the string which will be removed - * - * Remove the provided @val from the cell @name in @cfg. + * \arg cfg the config set + * \arg name the name of the variable + * \arg val the value of the string which will be removed */ -xbt_error_t -xbt_cfg_rm_string(xbt_cfg_t cfg,const char*name, const char *val) { - xbt_cfgelm_t cell; - int cpt; +void xbt_cfg_rm_string(xbt_cfg_t cfg, const char *name, const char *val) +{ + xbt_cfgelm_t variable; + unsigned int cpt; char *seen; - xbt_error_t errcode; - - TRY (xbt_cfgelm_get(cfg,name,xbt_cfgelm_string,&cell)); - - xbt_dynar_foreach(cell->content,cpt,seen) { - if (!strcpy(seen,val)) { - xbt_dynar_cursor_rm(cell->content,&cpt); - return no_error; + + variable = xbt_cfgelm_get(cfg, name, xbt_cfgelm_string); + + if (xbt_dynar_length(variable->content) == variable->min) + THROWF(mismatch_error, 0, + "Cannot remove value %s from the config element %s since it's already at its minimal size (=%d)", + name, val, variable->min); + + xbt_dynar_foreach(variable->content, cpt, seen) { + if (!strcpy(seen, val)) { + if (variable->cb_rm) + (*variable->cb_rm) (name, cpt); + xbt_dynar_cursor_rm(variable->content, &cpt); + return; } } - ERROR2("Can't remove the value %s of config element %s: value not found.", - val,name); - return mismatch_error; + THROWF(not_found_error, 0, + "Can't remove the value %s of config element %s: value not found.", + val, name); } -/** - * xbt_cfg_rm_host: - * - * @cfg: the config set - * @name: the name of the cell - * @host: the hostname - * @port: the port number +/** @brief Remove the provided \e val peer value from a variable * - * Remove the provided @host:@port from the cell @name in @cfg. + * \arg cfg the config set + * \arg name the name of the variable + * \arg peer the peername + * \arg port the port number */ -xbt_error_t -xbt_cfg_rm_host(xbt_cfg_t cfg,const char*name, const char *host,int port) { - xbt_cfgelm_t cell; - int cpt; - xbt_host_t *seen; - xbt_error_t errcode; - - TRY (xbt_cfgelm_get(cfg,name,xbt_cfgelm_host,&cell)); - - xbt_dynar_foreach(cell->content,cpt,seen) { - if (!strcpy(seen->name,host) && seen->port == port) { - xbt_dynar_cursor_rm(cell->content,&cpt); - return no_error; +void +xbt_cfg_rm_peer(xbt_cfg_t cfg, const char *name, const char *peer, + int port) +{ + xbt_cfgelm_t variable; + unsigned int cpt; + xbt_peer_t seen; + + variable = xbt_cfgelm_get(cfg, name, xbt_cfgelm_peer); + + if (xbt_dynar_length(variable->content) == variable->min) + THROWF(mismatch_error, 0, + "Cannot remove value %s:%d from the config element %s since it's already at its minimal size (=%d)", + peer, port, name, variable->min); + + xbt_dynar_foreach(variable->content, cpt, seen) { + if (!strcpy(seen->name, peer) && seen->port == port) { + if (variable->cb_rm) + (*variable->cb_rm) (name, cpt); + xbt_dynar_cursor_rm(variable->content, &cpt); + return; } } - ERROR3("Can't remove the value %s:%d of config element %s: value not found.", - host,port,name); - return mismatch_error; + THROWF(not_found_error, 0, + "Can't remove the value %s:%d of config element %s: value not found.", + peer, port, name); } -/* rm everything */ +/** @brief Remove the \e pos th value from the provided variable */ -/** - * xbt_cfg_empty: - * - * @cfg: the config set - * @name: the name of the cell - * - * rm evenything - */ +void xbt_cfg_rm_at(xbt_cfg_t cfg, const char *name, int pos) +{ + + xbt_cfgelm_t variable; -xbt_error_t -xbt_cfg_empty(xbt_cfg_t cfg,const char*name) { - xbt_cfgelm_t cell; + variable = xbt_cfgelm_get(cfg, name, xbt_cfgelm_any); + + if (xbt_dynar_length(variable->content) == variable->min) + THROWF(mismatch_error, 0, + "Cannot remove %dth value from the config element %s since it's already at its minimal size (=%d)", + pos, name, variable->min); + + if (variable->cb_rm) + (*variable->cb_rm) (name, pos); + xbt_dynar_remove_at(variable->content, pos, NULL); +} - xbt_error_t errcode; +/** @brief Remove all the values from a variable + * + * \arg cfg the config set + * \arg name the name of the variable + */ - TRYCATCH(mismatch_error, - xbt_dict_get((xbt_dict_t)cfg,name,(void**)&cell)); - if (errcode == mismatch_error) { - ERROR1("Can't empty '%s' since this config element does not exist", - name); - return mismatch_error; +void xbt_cfg_empty(xbt_cfg_t cfg, const char *name) +{ + xbt_cfgelm_t variable = NULL; + xbt_ex_t e; + + TRY { + variable = xbt_dict_get((xbt_dict_t) cfg, name); + } CATCH(e) { + if (e.category != not_found_error) + RETHROW; + + xbt_ex_free(e); + THROWF(not_found_error, 0, + "Can't empty '%s' since this config element does not exist", + name); } - if (cell) { - xbt_dynar_reset(cell->content); + if (variable) { + if (variable->cb_rm) { + unsigned int cpt; + void *ignored; + xbt_dynar_foreach(variable->content, cpt, ignored) { + (*variable->cb_rm) (name, cpt); + } + } + xbt_dynar_reset(variable->content); } - return no_error; +} +/* + * Say if the value is the default value + */ +int xbt_cfg_is_default_value(xbt_cfg_t cfg, const char *name) +{ + xbt_cfgelm_t variable = xbt_cfgelm_get(cfg, name, xbt_cfgelm_any); + return variable->isdefault; } /*----[ Getting ]---------------------------------------------------------*/ -/** - * xbt_cfg_get_int: - * @cfg: the config set - * @name: the name of the cell - * @val: the wanted value +/** @brief Retrieve an integer value of a variable (get a warning if not uniq) + * + * \arg cfg the config set + * \arg name the name of the variable + * \arg val the wanted value * * Returns the first value from the config set under the given name. - * If there is more than one value, it will issue a warning. Consider using xbt_cfg_get_dynar() - * instead. + * If there is more than one value, it will issue a warning. Consider using + * xbt_cfg_get_dynar() instead. * - * @warning the returned value is the actual content of the config set + * \warning the returned value is the actual content of the config set */ -xbt_error_t -xbt_cfg_get_int (xbt_cfg_t cfg, - const char *name, - int *val) { - xbt_cfgelm_t cell; - xbt_error_t errcode; - - TRY (xbt_cfgelm_get(cfg,name,xbt_cfgelm_int,&cell)); - - if (xbt_dynar_length(cell->content) > 1) { - WARN2("You asked for the first value of the config element '%s', but there is %lu values", - name, xbt_dynar_length(cell->content)); +int xbt_cfg_get_int(xbt_cfg_t cfg, const char *name) +{ + xbt_cfgelm_t variable = xbt_cfgelm_get(cfg, name, xbt_cfgelm_int); + + if (xbt_dynar_length(variable->content) > 1) { + XBT_WARN + ("You asked for the first value of the config element '%s', but there is %lu values", + name, xbt_dynar_length(variable->content)); } - *val = xbt_dynar_get_as(cell->content, 0, int); - return no_error; + return xbt_dynar_get_as(variable->content, 0, int); } -/** - * xbt_cfg_get_double: - * @cfg: the config set - * @name: the name of the cell - * @val: the wanted value +/** @brief Retrieve a double value of a variable (get a warning if not uniq) + * + * \arg cfg the config set + * \arg name the name of the variable + * \arg val the wanted value * * Returns the first value from the config set under the given name. - * If there is more than one value, it will issue a warning. Consider using xbt_cfg_get_dynar() - * instead. + * If there is more than one value, it will issue a warning. Consider using + * xbt_cfg_get_dynar() instead. * - * @warning the returned value is the actual content of the config set + * \warning the returned value is the actual content of the config set */ -xbt_error_t -xbt_cfg_get_double(xbt_cfg_t cfg, - const char *name, - double *val) { - xbt_cfgelm_t cell; - xbt_error_t errcode; +double xbt_cfg_get_double(xbt_cfg_t cfg, const char *name) +{ + xbt_cfgelm_t variable = xbt_cfgelm_get(cfg, name, xbt_cfgelm_double); - TRY (xbt_cfgelm_get(cfg,name,xbt_cfgelm_double,&cell)); - - if (xbt_dynar_length(cell->content) > 1) { - WARN2("You asked for the first value of the config element '%s', but there is %lu values\n", - name, xbt_dynar_length(cell->content)); + if (xbt_dynar_length(variable->content) > 1) { + XBT_WARN + ("You asked for the first value of the config element '%s', but there is %lu values\n", + name, xbt_dynar_length(variable->content)); } - *val = xbt_dynar_get_as(cell->content, 0, double); - return no_error; + return xbt_dynar_get_as(variable->content, 0, double); } -/** - * xbt_cfg_get_string: +/** @brief Retrieve a string value of a variable (get a warning if not uniq) * - * @th: the config set - * @name: the name of the cell - * @val: the wanted value + * \arg th the config set + * \arg name the name of the variable + * \arg val the wanted value * * Returns the first value from the config set under the given name. - * If there is more than one value, it will issue a warning. Consider using xbt_cfg_get_dynar() - * instead. + * If there is more than one value, it will issue a warning. Consider using + * xbt_cfg_get_dynar() instead. Returns NULL if there is no value. * - * @warning the returned value is the actual content of the config set + * \warning the returned value is the actual content of the config set */ -xbt_error_t xbt_cfg_get_string(xbt_cfg_t cfg, - const char *name, - char **val) { - xbt_cfgelm_t cell; - xbt_error_t errcode; +char *xbt_cfg_get_string(xbt_cfg_t cfg, const char *name) +{ + xbt_cfgelm_t variable = xbt_cfgelm_get(cfg, name, xbt_cfgelm_string); - *val=NULL; - - TRY (xbt_cfgelm_get(cfg,name,xbt_cfgelm_string,&cell)); - - if (xbt_dynar_length(cell->content) > 1) { - WARN2("You asked for the first value of the config element '%s', but there is %lu values\n", - name, xbt_dynar_length(cell->content)); + if (xbt_dynar_length(variable->content) > 1) { + XBT_WARN + ("You asked for the first value of the config element '%s', but there is %lu values\n", + name, xbt_dynar_length(variable->content)); + } else if (xbt_dynar_length(variable->content) == 0) { + return NULL; } - *val = xbt_dynar_get_as(cell->content, 0, char *); - return no_error; + return xbt_dynar_get_as(variable->content, 0, char *); } -/** - * xbt_cfg_get_host: +/** @brief Retrieve an peer value of a variable (get a warning if not uniq) * - * @cfg: the config set - * @name: the name of the cell - * @host: the host - * @port: the port number + * \arg cfg the config set + * \arg name the name of the variable + * \arg peer the peer + * \arg port the port number * * Returns the first value from the config set under the given name. - * If there is more than one value, it will issue a warning. Consider using xbt_cfg_get_dynar() - * instead. + * If there is more than one value, it will issue a warning. Consider using + * xbt_cfg_get_dynar() instead. * - * @warning the returned value is the actual content of the config set + * \warning the returned value is the actual content of the config set */ -xbt_error_t xbt_cfg_get_host (xbt_cfg_t cfg, - const char *name, - char **host, - int *port) { - xbt_cfgelm_t cell; - xbt_error_t errcode; - xbt_host_t *val; +void xbt_cfg_get_peer(xbt_cfg_t cfg, const char *name, char **peer, + int *port) +{ + xbt_cfgelm_t variable; + xbt_peer_t val; - TRY (xbt_cfgelm_get(cfg,name,xbt_cfgelm_host,&cell)); + variable = xbt_cfgelm_get(cfg, name, xbt_cfgelm_peer); - if (xbt_dynar_length(cell->content) > 1) { - WARN2("You asked for the first value of the config element '%s', but there is %lu values\n", - name, xbt_dynar_length(cell->content)); + if (xbt_dynar_length(variable->content) > 1) { + XBT_WARN + ("You asked for the first value of the config element '%s', but there is %lu values\n", + name, xbt_dynar_length(variable->content)); } - val = xbt_dynar_get_as(cell->content, 0, xbt_host_t*); - *host=val->name; - *port=val->port; - - return no_error; + val = xbt_dynar_get_as(variable->content, 0, xbt_peer_t); + *peer = val->name; + *port = val->port; } -/** - * xbt_cfg_get_dynar: - * @cfg: where to search in - * @name: what to search for - * @dynar: result +/** @brief Retrieve the dynar of all the values stored in a variable * - * Get the data stored in the config bag. + * \arg cfg where to search in + * \arg name what to search for + * \arg dynar result * - * @warning the returned value is the actual content of the config set + * Get the data stored in the config set. + * + * \warning the returned value is the actual content of the config set */ -xbt_error_t xbt_cfg_get_dynar (xbt_cfg_t cfg, - const char *name, - xbt_dynar_t *dynar) { - xbt_cfgelm_t cell; - xbt_error_t errcode = xbt_dict_get((xbt_dict_t)cfg,name, - (void**)&cell); - - if (errcode == mismatch_error) { - ERROR1("No registered cell %s in this config set", - name); - return mismatch_error; +xbt_dynar_t xbt_cfg_get_dynar(xbt_cfg_t cfg, const char *name) +{ + xbt_cfgelm_t variable = NULL; + xbt_ex_t e; + + TRY { + variable = xbt_dict_get((xbt_dict_t) cfg, name); + } CATCH(e) { + if (e.category == not_found_error) { + xbt_ex_free(e); + THROWF(not_found_error, 0, + "No registered variable %s in this config set", name); + } + RETHROW; } - if (errcode != no_error) - return errcode; - *dynar = cell->content; - return no_error; + return variable->content; +} + + +/** @brief Retrieve one of the integer value of a variable */ +int xbt_cfg_get_int_at(xbt_cfg_t cfg, const char *name, int pos) +{ + + xbt_cfgelm_t variable = xbt_cfgelm_get(cfg, name, xbt_cfgelm_int); + return xbt_dynar_get_as(variable->content, pos, int); +} + +/** @brief Retrieve one of the double value of a variable */ +double xbt_cfg_get_double_at(xbt_cfg_t cfg, const char *name, int pos) +{ + + xbt_cfgelm_t variable = xbt_cfgelm_get(cfg, name, xbt_cfgelm_double); + return xbt_dynar_get_as(variable->content, pos, double); +} + + +/** @brief Retrieve one of the string value of a variable */ +char *xbt_cfg_get_string_at(xbt_cfg_t cfg, const char *name, int pos) +{ + + xbt_cfgelm_t variable = xbt_cfgelm_get(cfg, name, xbt_cfgelm_string); + return xbt_dynar_get_as(variable->content, pos, char *); } +/** @brief Retrieve one of the peer value of a variable */ +void +xbt_cfg_get_peer_at(xbt_cfg_t cfg, const char *name, int pos, + char **peer, int *port) +{ + + xbt_cfgelm_t variable = xbt_cfgelm_get(cfg, name, xbt_cfgelm_int); + xbt_peer_t val = xbt_dynar_get_ptr(variable->content, pos); + + *port = val->port; + *peer = val->name; +} + + +#ifdef SIMGRID_TEST +#include "xbt.h" +#include "xbt/ex.h" + +XBT_LOG_EXTERNAL_CATEGORY(xbt_cfg); +XBT_LOG_DEFAULT_CATEGORY(xbt_cfg); + +XBT_TEST_SUITE("config", "Configuration support"); + +static xbt_cfg_t make_set() +{ + xbt_cfg_t set = NULL; + + xbt_log_threshold_set(&_XBT_LOGV(xbt_cfg), xbt_log_priority_critical); + xbt_cfg_register_str(&set, "speed:1_to_2_int"); + xbt_cfg_register_str(&set, "peername:1_to_1_string"); + xbt_cfg_register_str(&set, "user:1_to_10_string"); + + return set; +} /* end_of_make_set */ + +XBT_TEST_UNIT("memuse", test_config_memuse, "Alloc and free a config set") +{ + xbt_cfg_t set = make_set(); + xbt_test_add("Alloc and free a config set"); + xbt_cfg_set_parse(set, + "peername:veloce user:mquinson\nuser:oaumage\tuser:alegrand"); + xbt_cfg_free(&set); + xbt_cfg_free(&set); +} + +XBT_TEST_UNIT("validation", test_config_validation, "Validation tests") +{ + xbt_cfg_t set = set = make_set(); + xbt_ex_t e; + + xbt_test_add("Having too few elements for speed"); + xbt_cfg_set_parse(set, + "peername:veloce user:mquinson\nuser:oaumage\tuser:alegrand"); + TRY { + xbt_cfg_check(set); + } + CATCH(e) { + if (e.category != mismatch_error || + strncmp(e.msg, "Config elem speed needs", + strlen("Config elem speed needs"))) + xbt_test_fail("Got an exception. msg=%s", e.msg); + xbt_ex_free(e); + } + xbt_cfg_free(&set); + xbt_cfg_free(&set); + + + + xbt_test_add("Having too much values of 'speed'"); + set = make_set(); + xbt_cfg_set_parse(set, "peername:toto:42 user:alegrand"); + TRY { + xbt_cfg_set_parse(set, "speed:42 speed:24 speed:34"); + } + CATCH(e) { + if (e.category != mismatch_error || + strncmp(e.msg, "Cannot add value 34 to the config elem speed", + strlen("Config elem speed needs"))) + xbt_test_fail("Got an exception. msg=%s", e.msg); + xbt_ex_free(e); + } + xbt_cfg_check(set); + xbt_cfg_free(&set); + xbt_cfg_free(&set); + +} + +XBT_TEST_UNIT("use", test_config_use, "Data retrieving tests") +{ + + xbt_test_add("Get a single value"); + { + /* get_single_value */ + int ival; + xbt_cfg_t myset = make_set(); + + xbt_cfg_set_parse(myset, "peername:toto:42 speed:42"); + ival = xbt_cfg_get_int(myset, "speed"); + if (ival != 42) + xbt_test_fail("Speed value = %d, I expected 42", ival); + xbt_cfg_free(&myset); + } + + xbt_test_add("Get multiple values"); + { + /* get_multiple_value */ + xbt_dynar_t dyn; + xbt_cfg_t myset = make_set(); + + xbt_cfg_set_parse(myset, + "peername:veloce user:foo\nuser:bar\tuser:toto"); + xbt_cfg_set_parse(myset, "speed:42"); + xbt_cfg_check(myset); + dyn = xbt_cfg_get_dynar(myset, "user"); + + if (xbt_dynar_length(dyn) != 3) + xbt_test_fail("Dynar length = %lu, I expected 3", + xbt_dynar_length(dyn)); + + if (strcmp(xbt_dynar_get_as(dyn, 0, char *), "foo")) + xbt_test_fail("Dynar[0] = %s, I expected foo", + xbt_dynar_get_as(dyn, 0, char *)); + + if (strcmp(xbt_dynar_get_as(dyn, 1, char *), "bar")) + xbt_test_fail("Dynar[1] = %s, I expected bar", + xbt_dynar_get_as(dyn, 1, char *)); + + if (strcmp(xbt_dynar_get_as(dyn, 2, char *), "toto")) + xbt_test_fail("Dynar[2] = %s, I expected toto", + xbt_dynar_get_as(dyn, 2, char *)); + xbt_cfg_free(&myset); + } + + xbt_test_add("Access to a non-existant entry"); + { + /* non-existant_entry */ + xbt_cfg_t myset = make_set(); + xbt_ex_t e; + + TRY { + xbt_cfg_set_parse(myset, "color:blue"); + } CATCH(e) { + if (e.category != not_found_error) + xbt_test_exception(e); + xbt_ex_free(e); + } + xbt_cfg_free(&myset); + } +} +#endif /* SIMGRID_TEST */