Logo AND Algorithmique Numérique Distribuée

Public GIT Repository
make MSG_config public, document it, and implement it properly, not through a crude...
[simgrid.git] / src / xbt / config.c
1 /* config - Dictionnary where the type of each variable is provided.            */
2
3 /* This is useful to build named structs, like option or property sets.     */
4
5 /* Copyright (c) 2004, 2005, 2006, 2007, 2008, 2009, 2010. The SimGrid Team.
6  * All rights reserved.                                                     */
7
8 /* This program is free software; you can redistribute it and/or modify it
9  * under the terms of the license (GNU LGPL) which comes with this package. */
10
11 #include <stdio.h>
12 #include "xbt/misc.h"
13 #include "xbt/sysdep.h"
14 #include "xbt/log.h"
15 #include "xbt/ex.h"
16 #include "xbt/dynar.h"
17 #include "xbt/dict.h"
18 #include "xbt/peer.h"
19
20 #include "xbt/config.h"         /* prototypes of this module */
21
22 XBT_LOG_NEW_DEFAULT_SUBCATEGORY(xbt_cfg, xbt, "configuration support");
23
24 /* xbt_cfgelm_t: the typedef corresponding to a config variable.
25
26    Both data and DTD are mixed, but fixing it now would prevent me to ever
27    defend my thesis. */
28
29 typedef struct {
30   /* Description */
31   char *desc;
32
33   /* Allowed type of the variable */
34   e_xbt_cfgelm_type_t type;
35   int min, max;
36   unsigned isdefault:1;
37
38   /* Callbacks */
39   xbt_cfg_cb_t cb_set;
40   xbt_cfg_cb_t cb_rm;
41
42   /* actual content
43      (cannot be an union because type peer uses both str and i) */
44   xbt_dynar_t content;
45 } s_xbt_cfgelm_t, *xbt_cfgelm_t;
46
47 static const char *xbt_cfgelm_type_name[xbt_cfgelm_type_count] =
48     { "int", "double", "string", "peer", "any" };
49
50 /* Internal stuff used in cache to free a variable */
51 static void xbt_cfgelm_free(void *data);
52
53 /* Retrieve the variable we'll modify */
54 static xbt_cfgelm_t xbt_cfgelm_get(xbt_cfg_t cfg, const char *name,
55                                    e_xbt_cfgelm_type_t type);
56
57 /*----[ Memory management ]-----------------------------------------------*/
58
59 /** @brief Constructor
60  *
61  * Initialise an config set
62  */
63
64
65 xbt_cfg_t xbt_cfg_new(void)
66 {
67   return (xbt_cfg_t) xbt_dict_new_homogeneous(&xbt_cfgelm_free);
68 }
69
70 /** \brief Copy an existing configuration set
71  *
72  * \arg whereto the config set to be created
73  * \arg tocopy the source data
74  *
75  * This only copy the registrations, not the actual content
76  */
77
78 void xbt_cfg_cpy(xbt_cfg_t tocopy, xbt_cfg_t * whereto)
79 {
80   xbt_dict_cursor_t cursor = NULL;
81   xbt_cfgelm_t variable = NULL;
82   char *name = NULL;
83
84   XBT_DEBUG("Copy cfg set %p", tocopy);
85   *whereto = NULL;
86   xbt_assert(tocopy, "cannot copy NULL config");
87
88   xbt_dict_foreach((xbt_dict_t) tocopy, cursor, name, variable) {
89     xbt_cfg_register(whereto, name, variable->desc, variable->type, NULL,
90                      variable->min, variable->max, variable->cb_set,
91                      variable->cb_rm);
92   }
93 }
94
95 /** @brief Destructor */
96 void xbt_cfg_free(xbt_cfg_t * cfg)
97 {
98   XBT_DEBUG("Frees cfg set %p", cfg);
99   xbt_dict_free((xbt_dict_t *) cfg);
100 }
101
102 /** @brief Dump a config set for debuging purpose
103  *
104  * \arg name The name to give to this config set
105  * \arg indent what to write at the begining of each line (right number of spaces)
106  * \arg cfg the config set
107  */
108 void xbt_cfg_dump(const char *name, const char *indent, xbt_cfg_t cfg)
109 {
110   xbt_dict_t dict = (xbt_dict_t) cfg;
111   xbt_dict_cursor_t cursor = NULL;
112   xbt_cfgelm_t variable = NULL;
113   char *key = NULL;
114   int i;
115   int size;
116   int ival;
117   char *sval;
118   double dval;
119   xbt_peer_t hval;
120
121   if (name)
122     printf("%s>> Dumping of the config set '%s':\n", indent, name);
123   xbt_dict_foreach(dict, cursor, key, variable) {
124
125     printf("%s  %s:", indent, key);
126
127     size = xbt_dynar_length(variable->content);
128     printf
129         ("%d_to_%d_%s. Actual size=%d. prerm=%p,postset=%p, List of values:\n",
130          variable->min, variable->max,
131          xbt_cfgelm_type_name[variable->type], size, variable->cb_rm,
132          variable->cb_set);
133
134     switch (variable->type) {
135
136     case xbt_cfgelm_int:
137       for (i = 0; i < size; i++) {
138         ival = xbt_dynar_get_as(variable->content, i, int);
139         printf("%s    %d\n", indent, ival);
140       }
141       break;
142
143     case xbt_cfgelm_double:
144       for (i = 0; i < size; i++) {
145         dval = xbt_dynar_get_as(variable->content, i, double);
146         printf("%s    %f\n", indent, dval);
147       }
148       break;
149
150     case xbt_cfgelm_string:
151       for (i = 0; i < size; i++) {
152         sval = xbt_dynar_get_as(variable->content, i, char *);
153         printf("%s    %s\n", indent, sval);
154       }
155       break;
156
157     case xbt_cfgelm_peer:
158       for (i = 0; i < size; i++) {
159         hval = xbt_dynar_get_as(variable->content, i, xbt_peer_t);
160         printf("%s    %s:%d\n", indent, hval->name, hval->port);
161       }
162       break;
163
164     default:
165       printf("%s    Invalid type!!\n", indent);
166     }
167
168   }
169
170   if (name)
171     printf("%s<< End of the config set '%s'\n", indent, name);
172   fflush(stdout);
173
174   xbt_dict_cursor_free(&cursor);
175   return;
176 }
177
178 /*
179  * free an config element
180  */
181
182 void xbt_cfgelm_free(void *data)
183 {
184   xbt_cfgelm_t c = (xbt_cfgelm_t) data;
185
186   XBT_DEBUG("Frees cfgelm %p", c);
187   if (!c)
188     return;
189   xbt_free(c->desc);
190   xbt_dynar_free(&(c->content));
191   free(c);
192 }
193
194 /*----[ Registering stuff ]-----------------------------------------------*/
195
196 /** @brief Register an element within a config set
197  *
198  *  @arg cfg the config set
199  *  @arg type the type of the config element
200  *  @arg min the minimum
201  *  @arg max the maximum
202  */
203
204 void
205 xbt_cfg_register(xbt_cfg_t * cfg,
206                  const char *name, const char *desc,
207                  e_xbt_cfgelm_type_t type, void *default_value, int min,
208                  int max, xbt_cfg_cb_t cb_set, xbt_cfg_cb_t cb_rm)
209 {
210   xbt_cfgelm_t res;
211
212   if (*cfg == NULL)
213     *cfg = xbt_cfg_new();
214   xbt_assert(type >= xbt_cfgelm_int && type <= xbt_cfgelm_peer,
215               "type of %s not valid (%d should be between %d and %d)",
216              name, (int)type, xbt_cfgelm_int, xbt_cfgelm_peer);
217   res = xbt_dict_get_or_null((xbt_dict_t) * cfg, name);
218
219   if (res) {
220     XBT_WARN("Config elem %s registered twice.", name);
221     /* Will be removed by the insertion of the new one */
222   }
223
224   res = xbt_new(s_xbt_cfgelm_t, 1);
225   XBT_DEBUG("Register cfg elm %s (%s) (%d to %d %s (=%d) @%p in set %p)",
226             name, desc, min, max, xbt_cfgelm_type_name[type], (int)type, res,
227          *cfg);
228
229   res->desc = xbt_strdup(desc);
230   res->type = type;
231   res->min = min;
232   res->max = max;
233   res->cb_set = cb_set;
234   res->cb_rm = cb_rm;
235   res->isdefault = 1;
236
237   switch (type) {
238   case xbt_cfgelm_int:
239     res->content = xbt_dynar_new(sizeof(int), NULL);
240     if (default_value)
241       xbt_dynar_push(res->content, default_value);
242     break;
243
244   case xbt_cfgelm_double:
245     res->content = xbt_dynar_new(sizeof(double), NULL);
246     if (default_value)
247       xbt_dynar_push(res->content, default_value);
248     break;
249
250   case xbt_cfgelm_string:
251     res->content = xbt_dynar_new(sizeof(char *), xbt_free_ref);
252     if (default_value)
253       xbt_dynar_push(res->content, default_value);
254     break;
255
256   case xbt_cfgelm_peer:
257     res->content = xbt_dynar_new(sizeof(xbt_peer_t), xbt_peer_free_voidp);
258     if (default_value)
259       xbt_dynar_push(res->content, default_value);
260     break;
261
262   default:
263     XBT_ERROR("%d is an invalide type code", (int)type);
264   }
265
266   xbt_dict_set((xbt_dict_t) * cfg, name, res, NULL);
267 }
268
269 /** @brief Unregister an element from a config set.
270  *
271  *  @arg cfg the config set
272  *  @arg name the name of the elem to be freed
273  *
274  *  Note that it removes both the description and the actual content.
275  *  Throws not_found when no such element exists.
276  */
277
278 void xbt_cfg_unregister(xbt_cfg_t cfg, const char *name)
279 {
280   XBT_DEBUG("Unregister elm '%s' from set %p", name, cfg);
281   xbt_dict_remove((xbt_dict_t) cfg, name);
282 }
283
284 /**
285  * @brief Parse a string and register the stuff described.
286  *
287  * @arg cfg the config set
288  * @arg entry a string describing the element to register
289  *
290  * The string may consist in several variable descriptions separated by a space.
291  * Each of them must use the following syntax: \<name\>:\<min nb\>_to_\<max nb\>_\<type\>
292  * with type being one of  'string','int', 'peer' or 'double'.
293  *
294  * FIXME: this does not allow to set the description
295  */
296
297 void xbt_cfg_register_str(xbt_cfg_t * cfg, const char *entry)
298 {
299   char *entrycpy = xbt_strdup(entry);
300   char *tok;
301
302   int min, max;
303   e_xbt_cfgelm_type_t type;
304   XBT_DEBUG("Register string '%s'", entry);
305
306   tok = strchr(entrycpy, ':');
307   xbt_assert(tok, "Invalid config element descriptor: %s%s",
308               entry, "; Should be <name>:<min nb>_to_<max nb>_<type>");
309   *(tok++) = '\0';
310
311   min = strtol(tok, &tok, 10);
312   xbt_assert(tok, "Invalid minimum in config element descriptor %s",
313               entry);
314
315   xbt_assert(strcmp(tok, "_to_"),
316               "Invalid config element descriptor : %s%s",
317               entry, "; Should be <name>:<min nb>_to_<max nb>_<type>");
318   tok += strlen("_to_");
319
320   max = strtol(tok, &tok, 10);
321   xbt_assert(tok, "Invalid maximum in config element descriptor %s",
322               entry);
323
324   xbt_assert(*tok == '_',
325               "Invalid config element descriptor: %s%s", entry,
326               "; Should be <name>:<min nb>_to_<max nb>_<type>");
327   tok++;
328
329   for (type = (e_xbt_cfgelm_type_t)0;
330        type < xbt_cfgelm_type_count
331        && strcmp(tok, xbt_cfgelm_type_name[type]); type++);
332   xbt_assert(type < xbt_cfgelm_type_count,
333               "Invalid type in config element descriptor: %s%s", entry,
334               "; Should be one of 'string', 'int', 'peer' or 'double'.");
335
336   xbt_cfg_register(cfg, entrycpy, NULL, type, NULL, min, max, NULL, NULL);
337
338   free(entrycpy);               /* strdup'ed by dict mechanism, but cannot be const */
339 }
340
341 static int strcmp_voidp(const void *pa, const void *pb)
342 {
343   return strcmp(*(const char **)pa, *(const char **)pb);
344 }
345
346 /** @brief Displays the declared options and their description */
347 void xbt_cfg_help(xbt_cfg_t cfg)
348 {
349   xbt_dict_cursor_t dict_cursor;
350   unsigned int dynar_cursor;
351   xbt_cfgelm_t variable;
352   char *name;
353   xbt_dynar_t names = xbt_dynar_new(sizeof(char *), NULL);
354
355   xbt_dict_foreach((xbt_dict_t )cfg, dict_cursor, name, variable) {
356     xbt_dynar_push(names, &name);
357   }
358   xbt_dynar_sort(names, strcmp_voidp);
359
360   xbt_dynar_foreach(names, dynar_cursor, name) {
361     int i;
362     int size;
363     variable = xbt_dict_get((xbt_dict_t )cfg, name);
364
365     printf("   %s: %s\n", name, variable->desc);
366     printf("       Type: %s; ", xbt_cfgelm_type_name[variable->type]);
367     if (variable->min != 1 || variable->max != 1) {
368       if (variable->min == 0 && variable->max == 0)
369         printf("Arity: no bound; ");
370       else
371         printf("Arity: min:%d to max:%d; ", variable->min, variable->max);
372     }
373     printf("Current value: ");
374     size = xbt_dynar_length(variable->content);
375
376     switch (variable->type) {
377       int ival;
378       char *sval;
379       double dval;
380       xbt_peer_t hval;
381
382     case xbt_cfgelm_int:
383       for (i = 0; i < size; i++) {
384         ival = xbt_dynar_get_as(variable->content, i, int);
385         printf("%s%d\n", (i == 0 ? "" : "              "), ival);
386       }
387       break;
388
389     case xbt_cfgelm_double:
390       for (i = 0; i < size; i++) {
391         dval = xbt_dynar_get_as(variable->content, i, double);
392         printf("%s%f\n", (i == 0 ? "" : "              "), dval);
393       }
394       break;
395
396     case xbt_cfgelm_string:
397       for (i = 0; i < size; i++) {
398         sval = xbt_dynar_get_as(variable->content, i, char *);
399         printf("%s'%s'\n", (i == 0 ? "" : "              "), sval);
400       }
401       break;
402
403     case xbt_cfgelm_peer:
404       for (i = 0; i < size; i++) {
405         hval = xbt_dynar_get_as(variable->content, i, xbt_peer_t);
406         printf("%s%s:%d\n", (i == 0 ? "" : "              "), hval->name,
407                hval->port);
408       }
409       break;
410
411     default:
412       printf("Invalid type!!\n");
413     }
414
415   }
416
417   xbt_dynar_free(&names);
418 }
419
420 /** @brief Check that each variable have the right amount of values */
421 void xbt_cfg_check(xbt_cfg_t cfg)
422 {
423   xbt_dict_cursor_t cursor;
424   xbt_cfgelm_t variable;
425   char *name;
426   int size;
427
428   xbt_assert(cfg, "NULL config set.");
429   XBT_DEBUG("Check cfg set %p", cfg);
430
431   xbt_dict_foreach((xbt_dict_t) cfg, cursor, name, variable) {
432     size = xbt_dynar_length(variable->content);
433     if (variable->min > size) {
434       xbt_dict_cursor_free(&cursor);
435       THROWF(mismatch_error, 0,
436              "Config elem %s needs at least %d %s, but there is only %d values.",
437              name, variable->min, xbt_cfgelm_type_name[variable->type],
438              size);
439     }
440
441     if (variable->max > 0 && variable->max < size) {
442       xbt_dict_cursor_free(&cursor);
443       THROWF(mismatch_error, 0,
444              "Config elem %s accepts at most %d %s, but there is %d values.",
445              name, variable->max, xbt_cfgelm_type_name[variable->type],
446              size);
447     }
448   }
449
450   xbt_dict_cursor_free(&cursor);
451 }
452
453 static xbt_cfgelm_t xbt_cfgelm_get(xbt_cfg_t cfg,
454                                    const char *name,
455                                    e_xbt_cfgelm_type_t type)
456 {
457   xbt_cfgelm_t res = NULL;
458
459   res = xbt_dict_get_or_null((xbt_dict_t) cfg, name);
460   if (!res) {
461     xbt_cfg_help(cfg);
462     THROWF(not_found_error, 0,
463            "No registered variable '%s' in this config set", name);
464   }
465
466   xbt_assert(type == xbt_cfgelm_any || res->type == type,
467               "You tried to access to the config element %s as an %s, but its type is %s.",
468               name,
469               xbt_cfgelm_type_name[type], xbt_cfgelm_type_name[res->type]);
470
471   return res;
472 }
473
474 /** @brief Get the type of this variable in that configuration set
475  *
476  * \arg cfg the config set
477  * \arg name the name of the element
478  * \arg type the result
479  *
480  */
481
482 e_xbt_cfgelm_type_t xbt_cfg_get_type(xbt_cfg_t cfg, const char *name)
483 {
484
485   xbt_cfgelm_t variable = NULL;
486
487   variable = xbt_dict_get_or_null((xbt_dict_t) cfg, name);
488   if (!variable)
489     THROWF(not_found_error, 0,
490            "Can't get the type of '%s' since this variable does not exist",
491            name);
492
493   XBT_INFO("type in variable = %d", (int)variable->type);
494
495   return variable->type;
496 }
497
498 /*----[ Setting ]---------------------------------------------------------*/
499 /**  @brief va_args version of xbt_cfg_set
500  *
501  * \arg cfg config set to fill
502  * \arg n   variable name
503  * \arg pa  variable value
504  *
505  * Add some values to the config set.
506  */
507 void xbt_cfg_set_vargs(xbt_cfg_t cfg, const char *name, va_list pa)
508 {
509   char *str;
510   int i;
511   double d;
512   e_xbt_cfgelm_type_t type = xbt_cfgelm_any; /* Set a dummy value to make gcc happy. It cannot get uninitialized */
513
514   xbt_ex_t e;
515
516   TRY {
517     type = xbt_cfg_get_type(cfg, name);
518   }
519   CATCH(e) {
520     if (e.category == not_found_error) {
521       xbt_ex_free(e);
522       THROWF(not_found_error, 0,
523              "Can't set the property '%s' since it's not registered",
524              name);
525     }
526     RETHROW;
527   }
528
529   switch (type) {
530   case xbt_cfgelm_peer:
531     str = va_arg(pa, char *);
532     i = va_arg(pa, int);
533     xbt_cfg_set_peer(cfg, name, str, i);
534     break;
535
536   case xbt_cfgelm_string:
537     str = va_arg(pa, char *);
538     xbt_cfg_set_string(cfg, name, str);
539     break;
540
541   case xbt_cfgelm_int:
542     i = va_arg(pa, int);
543     xbt_cfg_set_int(cfg, name, i);
544     break;
545
546   case xbt_cfgelm_double:
547     d = va_arg(pa, double);
548     xbt_cfg_set_double(cfg, name, d);
549     break;
550
551   default:
552     xbt_die("Config element variable %s not valid (type=%d)", name, (int)type);
553   }
554 }
555
556 /** @brief Add a NULL-terminated list of pairs {(char*)key, value} to the set
557  *
558  * \arg cfg config set to fill
559  * \arg name variable name
560  * \arg varargs variable value
561  *
562  */
563 void xbt_cfg_set(xbt_cfg_t cfg, const char *name, ...)
564 {
565   va_list pa;
566
567   va_start(pa, name);
568   xbt_cfg_set_vargs(cfg, name, pa);
569   va_end(pa);
570 }
571
572 /** @brief Add values parsed from a string into a config set
573  *
574  * \arg cfg config set to fill
575  * \arg options a string containing the content to add to the config set. This
576  * is a '\\t',' ' or '\\n' or ',' separated list of variables. Each individual variable is
577  * like "[name]:[value]" where [name] is the name of an already registred
578  * variable, and [value] conforms to the data type under which this variable was
579  * registred.
580  *
581  * @todo This is a crude manual parser, it should be a proper lexer.
582  */
583
584 void xbt_cfg_set_parse(xbt_cfg_t cfg, const char *options) {
585
586   char *optionlist_cpy;
587   char *option, *name, *val;
588
589   int len;
590
591   XBT_IN();
592   if (!options || !strlen(options)) {   /* nothing to do */
593     return;
594   }
595   optionlist_cpy = xbt_strdup(options);
596
597   XBT_DEBUG("List to parse and set:'%s'", options);
598   option = optionlist_cpy;
599   while (1) {                   /* breaks in the code */
600
601     if (!option)
602       break;
603     name = option;
604     len = strlen(name);
605     XBT_DEBUG("Still to parse and set: '%s'. len=%d; option-name=%ld",
606            name, len, (long) (option - name));
607
608     /* Pass the value */
609     while (option - name <= (len - 1) && *option != ' ' && *option != '\n'
610            && *option != '\t' && *option != ',') {
611       XBT_DEBUG("Take %c.", *option);
612       option++;
613     }
614     if (option - name == len) {
615       XBT_DEBUG("Boundary=EOL");
616       option = NULL;            /* don't do next iteration */
617
618     } else {
619       XBT_DEBUG("Boundary on '%c'. len=%d;option-name=%ld",
620              *option, len, (long) (option - name));
621
622       /* Pass the following blank chars */
623       *(option++) = '\0';
624       while (option - name < (len - 1) &&
625              (*option == ' ' || *option == '\n' || *option == '\t')) {
626         /*      fprintf(stderr,"Ignore a blank char.\n"); */
627         option++;
628       }
629       if (option - name == len - 1)
630         option = NULL;          /* don't do next iteration */
631     }
632     XBT_DEBUG("parse now:'%s'; parse later:'%s'", name, option);
633
634     if (name[0] == ' ' || name[0] == '\n' || name[0] == '\t')
635       continue;
636     if (!strlen(name))
637       break;
638
639     val = strchr(name, ':');
640     if (!val) {
641       free(optionlist_cpy);
642       xbt_die("Option '%s' badly formated. Should be of the form 'name:value'",
643               name);
644     }
645     *(val++) = '\0';
646
647     if (strncmp(name, "contexts/", strlen("contexts/")))
648       XBT_INFO("Configuration change: Set '%s' to '%s'", name, val);
649
650     TRY {
651       xbt_cfg_set_as_string(cfg,name,val);
652     } CATCH_ANONYMOUS {
653       free(optionlist_cpy);
654       RETHROW;
655     }
656   }
657   free(optionlist_cpy);
658 }
659
660 /** @brief Set the value of a variable, using the string representation of that value
661  *
662  * @arg cfg config set to modify
663  * @arg key name of the variable to modify
664  * @arg value string representation of the value to set
665  *
666  * @return the first char after the parsed value in val
667  */
668
669 void *xbt_cfg_set_as_string(xbt_cfg_t cfg, const char *key, const char *value) {
670   xbt_ex_t e;
671
672   char *ret;
673   volatile xbt_cfgelm_t variable = NULL;
674   int i;
675   double d;
676   char *str, *val;
677
678
679   TRY {
680     variable = xbt_dict_get((xbt_dict_t) cfg, key);
681   }
682   CATCH(e) {
683     if (e.category == not_found_error) {
684       xbt_ex_free(e);
685       THROWF(not_found_error, 0,
686           "No registered variable corresponding to '%s'.", key);
687     }
688     RETHROW;
689   }
690
691   switch (variable->type) {
692   case xbt_cfgelm_string:
693     xbt_cfg_set_string(cfg, key, value);     /* throws */
694     break;
695
696   case xbt_cfgelm_int:
697     i = strtol(value, &ret, 0);
698     if (value == NULL) {
699       xbt_die("Value of option %s not valid. Should be an integer", key);
700     }
701
702     xbt_cfg_set_int(cfg, key, i);  /* throws */
703     break;
704
705   case xbt_cfgelm_double:
706     d = strtod(value, &ret);
707     if (value == NULL) {
708       xbt_die("Value of option %s not valid. Should be a double", key);
709     }
710
711     xbt_cfg_set_double(cfg, key, d);       /* throws */
712     break;
713
714   case xbt_cfgelm_peer:
715     val = xbt_strdup(value);
716     str = val;
717     val = strchr(val, ':');
718     if (!val) {
719       xbt_die("Value of option %s not valid. Should be an peer (machine:port)", key);
720     }
721
722     *(val++) = '\0';
723     i = strtol(val, &ret, 0);
724     if (val == NULL) {
725       xbt_die("Value of option %s not valid. Should be an peer (machine:port)", key);
726     }
727
728     xbt_cfg_set_peer(cfg, key, str, i);    /* throws */
729     free(val);
730     break;
731
732   default:
733     THROWF(unknown_error, 0, "Type of config element %s is not valid.", key);
734     break;
735   }
736
737   return ret;
738 }
739
740 /** @brief Set an integer value to \a name within \a cfg if it wasn't changed yet
741  *
742  * This is useful to change the default value of a variable while allowing
743  * users to override it with command line arguments
744  */
745 void xbt_cfg_setdefault_int(xbt_cfg_t cfg, const char *name, int val)
746 {
747   xbt_cfgelm_t variable = xbt_cfgelm_get(cfg, name, xbt_cfgelm_int);
748
749   if (variable->isdefault){
750     xbt_cfg_set_int(cfg, name, val);
751     variable->isdefault = 1;
752   }
753    else
754     XBT_DEBUG
755         ("Do not override configuration variable '%s' with value '%d' because it was already set.",
756          name, val);
757 }
758
759 /** @brief Set an integer value to \a name within \a cfg if it wasn't changed yet
760  *
761  * This is useful to change the default value of a variable while allowing
762  * users to override it with command line arguments
763  */
764 void xbt_cfg_setdefault_double(xbt_cfg_t cfg, const char *name, double val)
765 {
766   xbt_cfgelm_t variable = xbt_cfgelm_get(cfg, name, xbt_cfgelm_double);
767
768   if (variable->isdefault) {
769     xbt_cfg_set_double(cfg, name, val);
770     variable->isdefault = 1;
771   }
772   else
773     XBT_DEBUG
774         ("Do not override configuration variable '%s' with value '%lf' because it was already set.",
775          name, val);
776 }
777
778 /** @brief Set a string value to \a name within \a cfg if it wasn't changed yet
779  *
780  * This is useful to change the default value of a variable while allowing
781  * users to override it with command line arguments
782  */
783 void xbt_cfg_setdefault_string(xbt_cfg_t cfg, const char *name,
784                                const char *val)
785 {
786   xbt_cfgelm_t variable = xbt_cfgelm_get(cfg, name, xbt_cfgelm_string);
787
788   if (variable->isdefault){
789     xbt_cfg_set_string(cfg, name, val);
790     variable->isdefault = 1;
791   }
792   else
793     XBT_DEBUG
794         ("Do not override configuration variable '%s' with value '%s' because it was already set.",
795          name, val);
796 }
797
798 /** @brief Set a peer value to \a name within \a cfg if it wasn't changed yet
799  *
800  * This is useful to change the default value of a variable while allowing
801  * users to override it with command line arguments
802  */
803 void xbt_cfg_setdefault_peer(xbt_cfg_t cfg, const char *name,
804                              const char *host, int port)
805 {
806   xbt_cfgelm_t variable = xbt_cfgelm_get(cfg, name, xbt_cfgelm_peer);
807
808   if (variable->isdefault){
809     xbt_cfg_set_peer(cfg, name, host, port);
810     variable->isdefault = 1;
811   }
812   else
813     XBT_DEBUG
814         ("Do not override configuration variable '%s' with value '%s:%d' because it was already set.",
815          name, host, port);
816 }
817
818 /** @brief Set or add an integer value to \a name within \a cfg
819  *
820  * \arg cfg the config set
821  * \arg name the name of the variable
822  * \arg val the value of the variable
823  */
824 void xbt_cfg_set_int(xbt_cfg_t cfg, const char *name, int val)
825 {
826   xbt_cfgelm_t variable;
827
828   XBT_VERB("Configuration setting: %s=%d", name, val);
829   variable = xbt_cfgelm_get(cfg, name, xbt_cfgelm_int);
830
831   if (variable->max == 1) {
832     if (variable->cb_rm && !xbt_dynar_is_empty(variable->content))
833       variable->cb_rm(name, 0);
834
835     xbt_dynar_set(variable->content, 0, &val);
836   } else {
837     if (variable->max
838         && xbt_dynar_length(variable->content) ==
839         (unsigned long) variable->max)
840       THROWF(mismatch_error, 0,
841              "Cannot add value %d to the config element %s since it's already full (size=%d)",
842              val, name, variable->max);
843
844     xbt_dynar_push(variable->content, &val);
845   }
846
847   if (variable->cb_set)
848     variable->cb_set(name, xbt_dynar_length(variable->content) - 1);
849   variable->isdefault = 0;
850 }
851
852 /** @brief Set or add a double value to \a name within \a cfg
853  *
854  * \arg cfg the config set
855  * \arg name the name of the variable
856  * \arg val the doule to set
857  */
858
859 void xbt_cfg_set_double(xbt_cfg_t cfg, const char *name, double val)
860 {
861   xbt_cfgelm_t variable;
862
863   XBT_VERB("Configuration setting: %s=%f", name, val);
864   variable = xbt_cfgelm_get(cfg, name, xbt_cfgelm_double);
865
866   if (variable->max == 1) {
867     if (variable->cb_rm && !xbt_dynar_is_empty(variable->content))
868       variable->cb_rm(name, 0);
869
870     xbt_dynar_set(variable->content, 0, &val);
871   } else {
872     if (variable->max
873         && xbt_dynar_length(variable->content) == variable->max)
874       THROWF(mismatch_error, 0,
875              "Cannot add value %f to the config element %s since it's already full (size=%d)",
876              val, name, variable->max);
877
878     xbt_dynar_push(variable->content, &val);
879   }
880
881   if (variable->cb_set)
882     variable->cb_set(name, xbt_dynar_length(variable->content) - 1);
883   variable->isdefault = 0;
884 }
885
886 /** @brief Set or add a string value to \a name within \a cfg
887  *
888  * \arg cfg the config set
889  * \arg name the name of the variable
890  * \arg val the value to be added
891  *
892  */
893
894 void xbt_cfg_set_string(xbt_cfg_t cfg, const char *name, const char *val)
895 {
896   xbt_cfgelm_t variable;
897   char *newval = xbt_strdup(val);
898
899   XBT_VERB("Configuration setting: %s=%s", name, val);
900   variable = xbt_cfgelm_get(cfg, name, xbt_cfgelm_string);
901   XBT_DEBUG("Variable: %d to %d %s (=%d) @%p",
902          variable->min, variable->max,
903             xbt_cfgelm_type_name[variable->type], (int)variable->type, variable);
904
905   if (variable->max == 1) {
906     if (!xbt_dynar_is_empty(variable->content)) {
907       if (variable->cb_rm)
908         variable->cb_rm(name, 0);
909       else if (variable->type == xbt_cfgelm_string) {
910         char *sval = xbt_dynar_get_as(variable->content, 0, char *);
911         free(sval);
912       }
913     }
914
915     xbt_dynar_set(variable->content, 0, &newval);
916   } else {
917     if (variable->max
918         && xbt_dynar_length(variable->content) == variable->max)
919       THROWF(mismatch_error, 0,
920              "Cannot add value %s to the config element %s since it's already full (size=%d)",
921              name, val, variable->max);
922
923     xbt_dynar_push(variable->content, &newval);
924   }
925
926   if (variable->cb_set)
927     variable->cb_set(name, xbt_dynar_length(variable->content) - 1);
928   variable->isdefault = 0;
929 }
930
931 /** @brief Set or add an peer value to \a name within \a cfg
932  *
933  * \arg cfg the config set
934  * \arg name the name of the variable
935  * \arg peer the peer
936  * \arg port the port number
937  *
938  * \e peer values are composed of a string (peername) and an integer (port)
939  */
940
941 void
942 xbt_cfg_set_peer(xbt_cfg_t cfg, const char *name, const char *peer,
943                  int port)
944 {
945   xbt_cfgelm_t variable;
946   xbt_peer_t val = xbt_peer_new(peer, port);
947
948   XBT_VERB("Configuration setting: %s=%s:%d", name, peer, port);
949
950   variable = xbt_cfgelm_get(cfg, name, xbt_cfgelm_peer);
951
952   if (variable->max == 1) {
953     if (variable->cb_rm && !xbt_dynar_is_empty(variable->content))
954       variable->cb_rm(name, 0);
955
956     xbt_dynar_set(variable->content, 0, &val);
957   } else {
958     if (variable->max
959         && xbt_dynar_length(variable->content) == variable->max)
960       THROWF(mismatch_error, 0,
961              "Cannot add value %s:%d to the config element %s since it's already full (size=%d)",
962              peer, port, name, variable->max);
963
964     xbt_dynar_push(variable->content, &val);
965   }
966
967   if (variable->cb_set)
968     variable->cb_set(name, xbt_dynar_length(variable->content) - 1);
969   variable->isdefault = 0;
970 }
971
972 /* ---- [ Removing ] ---- */
973
974 /** @brief Remove the provided \e val integer value from a variable
975  *
976  * \arg cfg the config set
977  * \arg name the name of the variable
978  * \arg val the value to be removed
979  */
980 void xbt_cfg_rm_int(xbt_cfg_t cfg, const char *name, int val)
981 {
982
983   xbt_cfgelm_t variable;
984   unsigned int cpt;
985   int seen;
986
987   variable = xbt_cfgelm_get(cfg, name, xbt_cfgelm_int);
988
989   if (xbt_dynar_length(variable->content) == variable->min)
990     THROWF(mismatch_error, 0,
991            "Cannot remove value %d from the config element %s since it's already at its minimal size (=%d)",
992            val, name, variable->min);
993
994   xbt_dynar_foreach(variable->content, cpt, seen) {
995     if (seen == val) {
996       if (variable->cb_rm)
997         variable->cb_rm(name, cpt);
998       xbt_dynar_cursor_rm(variable->content, &cpt);
999       return;
1000     }
1001   }
1002
1003   THROWF(not_found_error, 0,
1004          "Can't remove the value %d of config element %s: value not found.",
1005          val, name);
1006 }
1007
1008 /** @brief Remove the provided \e val double value from a variable
1009  *
1010  * \arg cfg the config set
1011  * \arg name the name of the variable
1012  * \arg val the value to be removed
1013  */
1014
1015 void xbt_cfg_rm_double(xbt_cfg_t cfg, const char *name, double val)
1016 {
1017   xbt_cfgelm_t variable;
1018   unsigned int cpt;
1019   double seen;
1020
1021   variable = xbt_cfgelm_get(cfg, name, xbt_cfgelm_double);
1022
1023   if (xbt_dynar_length(variable->content) == variable->min)
1024     THROWF(mismatch_error, 0,
1025            "Cannot remove value %f from the config element %s since it's already at its minimal size (=%d)",
1026            val, name, variable->min);
1027
1028   xbt_dynar_foreach(variable->content, cpt, seen) {
1029     if (seen == val) {
1030       xbt_dynar_cursor_rm(variable->content, &cpt);
1031       if (variable->cb_rm)
1032         variable->cb_rm(name, cpt);
1033       return;
1034     }
1035   }
1036
1037   THROWF(not_found_error, 0,
1038          "Can't remove the value %f of config element %s: value not found.",
1039          val, name);
1040 }
1041
1042 /** @brief Remove the provided \e val string value from a variable
1043  *
1044  * \arg cfg the config set
1045  * \arg name the name of the variable
1046  * \arg val the value of the string which will be removed
1047  */
1048 void xbt_cfg_rm_string(xbt_cfg_t cfg, const char *name, const char *val)
1049 {
1050   xbt_cfgelm_t variable;
1051   unsigned int cpt;
1052   char *seen;
1053
1054   variable = xbt_cfgelm_get(cfg, name, xbt_cfgelm_string);
1055
1056   if (xbt_dynar_length(variable->content) == variable->min)
1057     THROWF(mismatch_error, 0,
1058            "Cannot remove value %s from the config element %s since it's already at its minimal size (=%d)",
1059            name, val, variable->min);
1060
1061   xbt_dynar_foreach(variable->content, cpt, seen) {
1062     if (!strcpy(seen, val)) {
1063       if (variable->cb_rm)
1064         variable->cb_rm(name, cpt);
1065       xbt_dynar_cursor_rm(variable->content, &cpt);
1066       return;
1067     }
1068   }
1069
1070   THROWF(not_found_error, 0,
1071          "Can't remove the value %s of config element %s: value not found.",
1072          val, name);
1073 }
1074
1075 /** @brief Remove the provided \e val peer value from a variable
1076  *
1077  * \arg cfg the config set
1078  * \arg name the name of the variable
1079  * \arg peer the peername
1080  * \arg port the port number
1081  */
1082
1083 void
1084 xbt_cfg_rm_peer(xbt_cfg_t cfg, const char *name, const char *peer,
1085                 int port)
1086 {
1087   xbt_cfgelm_t variable;
1088   unsigned int cpt;
1089   xbt_peer_t seen;
1090
1091   variable = xbt_cfgelm_get(cfg, name, xbt_cfgelm_peer);
1092
1093   if (xbt_dynar_length(variable->content) == variable->min)
1094     THROWF(mismatch_error, 0,
1095            "Cannot remove value %s:%d from the config element %s since it's already at its minimal size (=%d)",
1096            peer, port, name, variable->min);
1097
1098   xbt_dynar_foreach(variable->content, cpt, seen) {
1099     if (!strcpy(seen->name, peer) && seen->port == port) {
1100       if (variable->cb_rm)
1101         variable->cb_rm(name, cpt);
1102       xbt_dynar_cursor_rm(variable->content, &cpt);
1103       return;
1104     }
1105   }
1106
1107   THROWF(not_found_error, 0,
1108          "Can't remove the value %s:%d of config element %s: value not found.",
1109          peer, port, name);
1110 }
1111
1112 /** @brief Remove the \e pos th value from the provided variable */
1113
1114 void xbt_cfg_rm_at(xbt_cfg_t cfg, const char *name, int pos)
1115 {
1116
1117   xbt_cfgelm_t variable;
1118
1119   variable = xbt_cfgelm_get(cfg, name, xbt_cfgelm_any);
1120
1121   if (xbt_dynar_length(variable->content) == variable->min)
1122     THROWF(mismatch_error, 0,
1123            "Cannot remove %dth value from the config element %s since it's already at its minimal size (=%d)",
1124            pos, name, variable->min);
1125
1126   if (variable->cb_rm)
1127     variable->cb_rm(name, pos);
1128   xbt_dynar_remove_at(variable->content, pos, NULL);
1129 }
1130
1131 /** @brief Remove all the values from a variable
1132  *
1133  * \arg cfg the config set
1134  * \arg name the name of the variable
1135  */
1136
1137 void xbt_cfg_empty(xbt_cfg_t cfg, const char *name)
1138 {
1139   xbt_cfgelm_t variable = NULL;
1140   xbt_ex_t e;
1141
1142   TRY {
1143     variable = xbt_dict_get((xbt_dict_t) cfg, name);
1144   }
1145   CATCH(e) {
1146     if (e.category != not_found_error)
1147       RETHROW;
1148
1149     xbt_ex_free(e);
1150     THROWF(not_found_error, 0,
1151            "Can't empty  '%s' since this config element does not exist",
1152            name);
1153   }
1154
1155   if (variable) {
1156     if (variable->cb_rm) {
1157       unsigned int cpt;
1158       void *ignored;
1159       xbt_dynar_foreach(variable->content, cpt, ignored) {
1160         variable->cb_rm(name, cpt);
1161       }
1162     }
1163     xbt_dynar_reset(variable->content);
1164   }
1165 }
1166 /*
1167  * Say if the value is the default value
1168  */
1169 int xbt_cfg_is_default_value(xbt_cfg_t cfg, const char *name)
1170 {
1171   xbt_cfgelm_t variable = xbt_cfgelm_get(cfg, name, xbt_cfgelm_any);
1172   return variable->isdefault;
1173 }
1174
1175 /*----[ Getting ]---------------------------------------------------------*/
1176
1177 /** @brief Retrieve an integer value of a variable (get a warning if not uniq)
1178  *
1179  * \arg cfg the config set
1180  * \arg name the name of the variable
1181  * \arg val the wanted value
1182  *
1183  * Returns the first value from the config set under the given name.
1184  * If there is more than one value, it will issue a warning. Consider using
1185  * xbt_cfg_get_dynar() instead.
1186  *
1187  * \warning the returned value is the actual content of the config set
1188  */
1189 int xbt_cfg_get_int(xbt_cfg_t cfg, const char *name)
1190 {
1191   xbt_cfgelm_t variable = xbt_cfgelm_get(cfg, name, xbt_cfgelm_int);
1192
1193   if (xbt_dynar_length(variable->content) > 1) {
1194     XBT_WARN
1195         ("You asked for the first value of the config element '%s', but there is %lu values",
1196          name, xbt_dynar_length(variable->content));
1197   }
1198
1199   return xbt_dynar_get_as(variable->content, 0, int);
1200 }
1201
1202 /** @brief Retrieve a double value of a variable (get a warning if not uniq)
1203  *
1204  * \arg cfg the config set
1205  * \arg name the name of the variable
1206  * \arg val the wanted value
1207  *
1208  * Returns the first value from the config set under the given name.
1209  * If there is more than one value, it will issue a warning. Consider using
1210  * xbt_cfg_get_dynar() instead.
1211  *
1212  * \warning the returned value is the actual content of the config set
1213  */
1214
1215 double xbt_cfg_get_double(xbt_cfg_t cfg, const char *name)
1216 {
1217   xbt_cfgelm_t variable = xbt_cfgelm_get(cfg, name, xbt_cfgelm_double);
1218
1219   if (xbt_dynar_length(variable->content) > 1) {
1220     XBT_WARN
1221         ("You asked for the first value of the config element '%s', but there is %lu values\n",
1222          name, xbt_dynar_length(variable->content));
1223   }
1224
1225   return xbt_dynar_get_as(variable->content, 0, double);
1226 }
1227
1228 /** @brief Retrieve a string value of a variable (get a warning if not uniq)
1229  *
1230  * \arg th the config set
1231  * \arg name the name of the variable
1232  * \arg val the wanted value
1233  *
1234  * Returns the first value from the config set under the given name.
1235  * If there is more than one value, it will issue a warning. Consider using
1236  * xbt_cfg_get_dynar() instead. Returns NULL if there is no value.
1237  *
1238  * \warning the returned value is the actual content of the config set
1239  */
1240
1241 char *xbt_cfg_get_string(xbt_cfg_t cfg, const char *name)
1242 {
1243   xbt_cfgelm_t variable = xbt_cfgelm_get(cfg, name, xbt_cfgelm_string);
1244
1245   if (xbt_dynar_length(variable->content) > 1) {
1246     XBT_WARN
1247         ("You asked for the first value of the config element '%s', but there is %lu values\n",
1248          name, xbt_dynar_length(variable->content));
1249   } else if (xbt_dynar_is_empty(variable->content)) {
1250     return NULL;
1251   }
1252
1253   return xbt_dynar_get_as(variable->content, 0, char *);
1254 }
1255
1256 /** @brief Retrieve an peer value of a variable (get a warning if not uniq)
1257  *
1258  * \arg cfg the config set
1259  * \arg name the name of the variable
1260  * \arg peer the peer
1261  * \arg port the port number
1262  *
1263  * Returns the first value from the config set under the given name.
1264  * If there is more than one value, it will issue a warning. Consider using
1265  * xbt_cfg_get_dynar() instead.
1266  *
1267  * \warning the returned value is the actual content of the config set
1268  */
1269
1270 void xbt_cfg_get_peer(xbt_cfg_t cfg, const char *name, char **peer,
1271                       int *port)
1272 {
1273   xbt_cfgelm_t variable;
1274   xbt_peer_t val;
1275
1276   variable = xbt_cfgelm_get(cfg, name, xbt_cfgelm_peer);
1277
1278   if (xbt_dynar_length(variable->content) > 1) {
1279     XBT_WARN
1280         ("You asked for the first value of the config element '%s', but there is %lu values\n",
1281          name, xbt_dynar_length(variable->content));
1282   }
1283
1284   val = xbt_dynar_get_as(variable->content, 0, xbt_peer_t);
1285   *peer = val->name;
1286   *port = val->port;
1287 }
1288
1289 /** @brief Retrieve the dynar of all the values stored in a variable
1290  *
1291  * \arg cfg where to search in
1292  * \arg name what to search for
1293  * \arg dynar result
1294  *
1295  * Get the data stored in the config set.
1296  *
1297  * \warning the returned value is the actual content of the config set
1298  */
1299 xbt_dynar_t xbt_cfg_get_dynar(xbt_cfg_t cfg, const char *name)
1300 {
1301   xbt_cfgelm_t variable = NULL;
1302   xbt_ex_t e;
1303
1304   TRY {
1305     variable = xbt_dict_get((xbt_dict_t) cfg, name);
1306   }
1307   CATCH(e) {
1308     if (e.category == not_found_error) {
1309       xbt_ex_free(e);
1310       THROWF(not_found_error, 0,
1311              "No registered variable %s in this config set", name);
1312     }
1313     RETHROW;
1314   }
1315
1316   return variable->content;
1317 }
1318
1319
1320 /** @brief Retrieve one of the integer value of a variable */
1321 int xbt_cfg_get_int_at(xbt_cfg_t cfg, const char *name, int pos)
1322 {
1323
1324   xbt_cfgelm_t variable = xbt_cfgelm_get(cfg, name, xbt_cfgelm_int);
1325   return xbt_dynar_get_as(variable->content, pos, int);
1326 }
1327
1328 /** @brief Retrieve one of the double value of a variable */
1329 double xbt_cfg_get_double_at(xbt_cfg_t cfg, const char *name, int pos)
1330 {
1331
1332   xbt_cfgelm_t variable = xbt_cfgelm_get(cfg, name, xbt_cfgelm_double);
1333   return xbt_dynar_get_as(variable->content, pos, double);
1334 }
1335
1336
1337 /** @brief Retrieve one of the string value of a variable */
1338 char *xbt_cfg_get_string_at(xbt_cfg_t cfg, const char *name, int pos)
1339 {
1340
1341   xbt_cfgelm_t variable = xbt_cfgelm_get(cfg, name, xbt_cfgelm_string);
1342   return xbt_dynar_get_as(variable->content, pos, char *);
1343 }
1344
1345 /** @brief Retrieve one of the peer value of a variable */
1346 void
1347 xbt_cfg_get_peer_at(xbt_cfg_t cfg, const char *name, int pos,
1348                     char **peer, int *port)
1349 {
1350
1351   xbt_cfgelm_t variable = xbt_cfgelm_get(cfg, name, xbt_cfgelm_int);
1352   xbt_peer_t val = xbt_dynar_get_ptr(variable->content, pos);
1353
1354   *port = val->port;
1355   *peer = val->name;
1356 }
1357
1358
1359 #ifdef SIMGRID_TEST
1360 #include "xbt.h"
1361 #include "xbt/ex.h"
1362
1363 XBT_LOG_EXTERNAL_DEFAULT_CATEGORY(xbt_cfg);
1364
1365 XBT_TEST_SUITE("config", "Configuration support");
1366
1367 static xbt_cfg_t make_set()
1368 {
1369   xbt_cfg_t set = NULL;
1370
1371   xbt_log_threshold_set(&_XBT_LOGV(xbt_cfg), xbt_log_priority_critical);
1372   xbt_cfg_register_str(&set, "speed:1_to_2_int");
1373   xbt_cfg_register_str(&set, "peername:1_to_1_string");
1374   xbt_cfg_register_str(&set, "user:1_to_10_string");
1375
1376   return set;
1377 }                               /* end_of_make_set */
1378
1379 XBT_TEST_UNIT("memuse", test_config_memuse, "Alloc and free a config set")
1380 {
1381   xbt_cfg_t set = make_set();
1382   xbt_test_add("Alloc and free a config set");
1383   xbt_cfg_set_parse(set,
1384                     "peername:veloce user:mquinson\nuser:oaumage\tuser:alegrand");
1385   xbt_cfg_free(&set);
1386   xbt_cfg_free(&set);
1387 }
1388
1389 XBT_TEST_UNIT("validation", test_config_validation, "Validation tests")
1390 {
1391   xbt_cfg_t set = set = make_set();
1392   xbt_ex_t e;
1393
1394   xbt_test_add("Having too few elements for speed");
1395   xbt_cfg_set_parse(set,
1396                     "peername:veloce user:mquinson\nuser:oaumage\tuser:alegrand");
1397   TRY {
1398     xbt_cfg_check(set);
1399   }
1400   CATCH(e) {
1401     if (e.category != mismatch_error ||
1402         strncmp(e.msg, "Config elem speed needs",
1403                 strlen("Config elem speed needs")))
1404       xbt_test_fail("Got an exception. msg=%s", e.msg);
1405     xbt_ex_free(e);
1406   }
1407   xbt_cfg_free(&set);
1408   xbt_cfg_free(&set);
1409
1410
1411
1412   xbt_test_add("Having too much values of 'speed'");
1413   set = make_set();
1414   xbt_cfg_set_parse(set, "peername:toto:42 user:alegrand");
1415   TRY {
1416     xbt_cfg_set_parse(set, "speed:42 speed:24 speed:34");
1417   }
1418   CATCH(e) {
1419     if (e.category != mismatch_error ||
1420         strncmp(e.msg, "Cannot add value 34 to the config elem speed",
1421                 strlen("Config elem speed needs")))
1422       xbt_test_fail("Got an exception. msg=%s", e.msg);
1423     xbt_ex_free(e);
1424   }
1425   xbt_cfg_check(set);
1426   xbt_cfg_free(&set);
1427   xbt_cfg_free(&set);
1428
1429 }
1430
1431 XBT_TEST_UNIT("use", test_config_use, "Data retrieving tests")
1432 {
1433
1434   xbt_test_add("Get a single value");
1435   {
1436     /* get_single_value */
1437     int ival;
1438     xbt_cfg_t myset = make_set();
1439
1440     xbt_cfg_set_parse(myset, "peername:toto:42 speed:42");
1441     ival = xbt_cfg_get_int(myset, "speed");
1442     if (ival != 42)
1443       xbt_test_fail("Speed value = %d, I expected 42", ival);
1444     xbt_cfg_free(&myset);
1445   }
1446
1447   xbt_test_add("Get multiple values");
1448   {
1449     /* get_multiple_value */
1450     xbt_dynar_t dyn;
1451     xbt_cfg_t myset = make_set();
1452
1453     xbt_cfg_set_parse(myset,
1454                       "peername:veloce user:foo\nuser:bar\tuser:toto");
1455     xbt_cfg_set_parse(myset, "speed:42");
1456     xbt_cfg_check(myset);
1457     dyn = xbt_cfg_get_dynar(myset, "user");
1458
1459     if (xbt_dynar_length(dyn) != 3)
1460       xbt_test_fail("Dynar length = %lu, I expected 3",
1461                      xbt_dynar_length(dyn));
1462
1463     if (strcmp(xbt_dynar_get_as(dyn, 0, char *), "foo"))
1464        xbt_test_fail("Dynar[0] = %s, I expected foo",
1465                       xbt_dynar_get_as(dyn, 0, char *));
1466
1467     if (strcmp(xbt_dynar_get_as(dyn, 1, char *), "bar"))
1468        xbt_test_fail("Dynar[1] = %s, I expected bar",
1469                       xbt_dynar_get_as(dyn, 1, char *));
1470
1471     if (strcmp(xbt_dynar_get_as(dyn, 2, char *), "toto"))
1472        xbt_test_fail("Dynar[2] = %s, I expected toto",
1473                       xbt_dynar_get_as(dyn, 2, char *));
1474     xbt_cfg_free(&myset);
1475   }
1476
1477   xbt_test_add("Access to a non-existant entry");
1478   {
1479     /* non-existant_entry */
1480     xbt_cfg_t myset = make_set();
1481     xbt_ex_t e;
1482
1483     TRY {
1484       xbt_cfg_set_parse(myset, "color:blue");
1485     }
1486     CATCH(e) {
1487       if (e.category != not_found_error)
1488         xbt_test_exception(e);
1489       xbt_ex_free(e);
1490     }
1491     xbt_cfg_free(&myset);
1492   }
1493 }
1494 #endif                          /* SIMGRID_TEST */