src/util/configuration.c

   1 /*
   2      This file is part of GNUnet.
   3      (C) 2006, 2007, 2008, 2009, 2013 Christian Grothoff (and other contributing authors)
   4
   5      GNUnet is free software; you can redistribute it and/or modify
   6      it under the terms of the GNU General Public License as published
   7      by the Free Software Foundation; either version 3, or (at your
   8      option) any later version.
   9
  10      GNUnet is distributed in the hope that it will be useful, but
  11      WITHOUT ANY WARRANTY; without even the implied warranty of
  12      MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  13      General Public License for more details.
  14
  15      You should have received a copy of the GNU General Public License
  16      along with GNUnet; see the file COPYING.  If not, write to the
  17      Free Software Foundation, Inc., 59 Temple Place - Suite 330,
  18      Boston, MA 02111-1307, USA.
  19 */
  20
  21 /**
  22  * @file src/util/configuration.c
  23  * @brief configuration management
  24  * @author Christian Grothoff
  25  */
  26
  27 #include "platform.h"
  28 #include "gnunet_util_lib.h"
  29
  30 #define LOG(kind,...) GNUNET_log_from (kind, "util", __VA_ARGS__)
  31
  32 #define LOG_STRERROR_FILE(kind,syscall,filename) GNUNET_log_from_strerror_file (kind, "util", syscall, filename)
  33
  34 /**
  35  * @brief configuration entry
  36  */
  37 struct ConfigEntry
  38 {
  39
  40   /**
  41    * This is a linked list.
  42    */
  43   struct ConfigEntry *next;
  44
  45   /**
  46    * key for this entry
  47    */
  48   char *key;
  49
  50   /**
  51    * current, commited value
  52    */
  53   char *val;
  54 };
  55
  56
  57 /**
  58  * @brief configuration section
  59  */
  60 struct ConfigSection
  61 {
  62   /**
  63    * This is a linked list.
  64    */
  65   struct ConfigSection *next;
  66
  67   /**
  68    * entries in the section
  69    */
  70   struct ConfigEntry *entries;
  71
  72   /**
  73    * name of the section
  74    */
  75   char *name;
  76 };
  77
  78
  79 /**
  80  * @brief configuration data
  81  */
  82 struct GNUNET_CONFIGURATION_Handle
  83 {
  84   /**
  85    * Configuration sections.
  86    */
  87   struct ConfigSection *sections;
  88
  89   /**
  90    * Modification indication since last save
  91    * #GNUNET_NO if clean, #GNUNET_YES if dirty,
  92    * #GNUNET_SYSERR on error (i.e. last save failed)
  93    */
  94   int dirty;
  95
  96 };
  97
  98
  99 /**
 100  * Used for diffing a configuration object against
 101  * the default one
 102  */
 103 struct DiffHandle
 104 {
 105   const struct GNUNET_CONFIGURATION_Handle *cfg_default;
 106
 107   struct GNUNET_CONFIGURATION_Handle *cfgDiff;
 108 };
 109
 110
 111 /**
 112  * Create a GNUNET_CONFIGURATION_Handle.
 113  *
 114  * @return fresh configuration object
 115  */
 116 struct GNUNET_CONFIGURATION_Handle *
 117 GNUNET_CONFIGURATION_create ()
 118 {
 119   return GNUNET_new (struct GNUNET_CONFIGURATION_Handle);
 120 }
 121
 122
 123 /**
 124  * Destroy configuration object.
 125  *
 126  * @param cfg configuration to destroy
 127  */
 128 void
 129 GNUNET_CONFIGURATION_destroy (struct GNUNET_CONFIGURATION_Handle *cfg)
 130 {
 131   struct ConfigSection *sec;
 132
 133   while (NULL != (sec = cfg->sections))
 134     GNUNET_CONFIGURATION_remove_section (cfg, sec->name);
 135   GNUNET_free (cfg);
 136 }
 137
 138
 139 /**
 140  * De-serializes configuration
 141  *
 142  * @param cfg configuration to update
 143  * @param mem the memory block of serialized configuration
 144  * @param size the size of the memory block
 145  * @param allow_inline set to #GNUNET_YES if we recursively load configuration
 146  *          from inlined configurations; #GNUNET_NO if not and raise warnings
 147  *          when we come across them
 148  * @return #GNUNET_OK on success, #GNUNET_SYSERR on error
 149  */
 150 int
 151 GNUNET_CONFIGURATION_deserialize (struct GNUNET_CONFIGURATION_Handle *cfg,
 152                                   const char *mem,
 153                                   const size_t size,
 154                                   int allow_inline)
 155 {
 156   char *line;
 157   char *line_orig;
 158   size_t line_size;
 159   char *pos;
 160   unsigned int nr;
 161   size_t r_bytes;
 162   size_t to_read;
 163   size_t i;
 164   int emptyline;
 165   int ret;
 166   char *section;
 167   char *eq;
 168   char *tag;
 169   char *value;
 170
 171   LOG (GNUNET_ERROR_TYPE_DEBUG, "Deserializing config file\n");
 172   ret = GNUNET_OK;
 173   section = GNUNET_strdup ("");
 174   nr = 0;
 175   r_bytes = 0;
 176   line_orig = NULL;
 177   while (r_bytes < size)
 178   {
 179     GNUNET_free_non_null (line_orig);
 180     /* fgets-like behaviour on buffer */
 181     to_read = size - r_bytes;
 182     pos = memchr (&mem[r_bytes], '\n', to_read);
 183     if (NULL == pos)
 184     {
 185       line_orig = GNUNET_strndup (&mem[r_bytes], line_size = to_read);
 186       r_bytes += line_size;
 187     }
 188     else
 189     {
 190       line_orig = GNUNET_strndup (&mem[r_bytes], line_size = (pos - &mem[r_bytes]));
 191       r_bytes += line_size + 1;
 192     }
 193     line = line_orig;
 194     /* increment line number */
 195     nr++;
 196     /* tabs and '\r' are whitespace */
 197     emptyline = GNUNET_YES;
 198     for (i = 0; i < line_size; i++)
 199     {
 200       if (line[i] == '\t')
 201         line[i] = ' ';
 202       if (line[i] == '\r')
 203         line[i] = ' ';
 204       if (' ' != line[i])
 205         emptyline = GNUNET_NO;
 206     }
 207     /* ignore empty lines */
 208     if (GNUNET_YES == emptyline)
 209       continue;
 210
 211     /* remove tailing whitespace */
 212     for (i = line_size - 1; (i >= 1) && (isspace ((unsigned char) line[i]));i--)
 213       line[i] = '\0';
 214
 215     /* remove leading whitespace */
 216     for (; line[0] != '\0' && (isspace ((unsigned char) line[0])); line++);
 217
 218     /* ignore comments */
 219     if ( ('#' == line[0]) || ('%' == line[0]) )
 220       continue;
 221
 222     /* handle special "@INLINE@" directive */
 223     if (0 == strncasecmp (line,
 224                           "@INLINE@ ",
 225                           strlen ("@INLINE@ ")))
 226     {
 227       /* @INLINE@ value */
 228       value = &line[strlen ("@INLINE@ ")];
 229       if (GNUNET_YES == allow_inline)
 230       {
 231         if (GNUNET_OK != GNUNET_CONFIGURATION_parse (cfg, value))
 232         {
 233           ret = GNUNET_SYSERR;    /* failed to parse included config */
 234           break;
 235         }
 236       }
 237       else
 238       {
 239         LOG (GNUNET_ERROR_TYPE_DEBUG,
 240              "Ignoring parsing @INLINE@ configurations, not allowed!\n");
 241         ret = GNUNET_SYSERR;
 242         break;
 243       }
 244       continue;
 245     }
 246     if ( ('[' == line[0]) && (']' == line[line_size - 1]) )
 247     {
 248       /* [value] */
 249       line[line_size - 1] = '\0';
 250       value = &line[1];
 251       GNUNET_free (section);
 252       section = GNUNET_strdup (value);
 253       LOG (GNUNET_ERROR_TYPE_DEBUG,
 254            "Config section `%s'\n",
 255            section);
 256       continue;
 257     }
 258     if (NULL != (eq = strchr (line, '=')))
 259     {
 260       /* tag = value */
 261       tag = GNUNET_strndup (line, eq - line);
 262       /* remove tailing whitespace */
 263       for (i = strlen (tag) - 1; (i >= 1) && (isspace ((unsigned char) tag[i]));i--)
 264         tag[i] = '\0';
 265
 266       /* Strip whitespace */
 267       value = eq + 1;
 268       while (isspace ((unsigned char) value[0]))
 269         value++;
 270       for (i = strlen (value) - 1; (i >= 1) && (isspace ((unsigned char) value[i]));i--)
 271         value[i] = '\0';
 272
 273       /* remove quotes */
 274       i = 0;
 275       if ( ('"' == value[0]) &&
 276            ('"' == value[strlen (value) - 1]) )
 277       {
 278         value[strlen (value) - 1] = '\0';
 279         value++;
 280       }
 281       LOG (GNUNET_ERROR_TYPE_DEBUG, "Config value %s=\"%s\"\n", tag, value);
 282       GNUNET_CONFIGURATION_set_value_string (cfg, section, tag, &value[i]);
 283       GNUNET_free (tag);
 284       continue;
 285     }
 286     /* parse error */
 287     LOG (GNUNET_ERROR_TYPE_WARNING,
 288          _("Syntax error while deserializing in line %u\n"),
 289          nr);
 290     ret = GNUNET_SYSERR;
 291     break;
 292   }
 293   LOG (GNUNET_ERROR_TYPE_DEBUG, "Finished deserializing config\n");
 294   GNUNET_free_non_null (line_orig);
 295   GNUNET_free (section);
 296   GNUNET_assert ( (GNUNET_OK != ret) || (r_bytes == size) );
 297   return ret;
 298 }
 299
 300
 301 /**
 302  * Parse a configuration file, add all of the options in the
 303  * file to the configuration environment.
 304  *
 305  * @param cfg configuration to update
 306  * @param filename name of the configuration file
 307  * @return #GNUNET_OK on success, #GNUNET_SYSERR on error
 308  */
 309 int
 310 GNUNET_CONFIGURATION_parse (struct GNUNET_CONFIGURATION_Handle *cfg,
 311                             const char *filename)
 312 {
 313   uint64_t fs64;
 314   size_t fs;
 315   char *fn;
 316   char *mem;
 317   int dirty;
 318   int ret;
 319
 320   LOG (GNUNET_ERROR_TYPE_DEBUG,
 321        "Asked to parse config file `%s'\n",
 322        filename);
 323   fn = GNUNET_STRINGS_filename_expand (filename);
 324   LOG (GNUNET_ERROR_TYPE_DEBUG,
 325        "Config file name expanded to `%s'\n",
 326        fn);
 327   if (fn == NULL)
 328     return GNUNET_SYSERR;
 329   dirty = cfg->dirty;           /* back up value! */
 330   if (GNUNET_SYSERR ==
 331       GNUNET_DISK_file_size (fn, &fs64, GNUNET_YES, GNUNET_YES))
 332   {
 333     LOG (GNUNET_ERROR_TYPE_WARNING,
 334          "Error while determining the file size of %s\n", fn);
 335     GNUNET_free (fn);
 336     return GNUNET_SYSERR;
 337   }
 338   if (fs64 > SIZE_MAX)
 339   {
 340     GNUNET_break (0);           /* File size is more than the heap size */
 341     GNUNET_free (fn);
 342     return GNUNET_SYSERR;
 343   }
 344   fs = fs64;
 345   mem = GNUNET_malloc (fs);
 346   if (fs != GNUNET_DISK_fn_read (fn, mem, fs))
 347   {
 348     LOG (GNUNET_ERROR_TYPE_WARNING,
 349          "Error while reading file %s\n", fn);
 350     GNUNET_free (fn);
 351     GNUNET_free (mem);
 352     return GNUNET_SYSERR;
 353   }
 354   LOG (GNUNET_ERROR_TYPE_DEBUG, "Deserializing contents of file `%s'\n", fn);
 355   GNUNET_free (fn);
 356   ret = GNUNET_CONFIGURATION_deserialize (cfg, mem, fs, GNUNET_YES);
 357   GNUNET_free (mem);
 358   /* restore dirty flag - anything we set in the meantime
 359    * came from disk */
 360   cfg->dirty = dirty;
 361   return ret;
 362 }
 363
 364
 365 /**
 366  * Test if there are configuration options that were
 367  * changed since the last save.
 368  *
 369  * @param cfg configuration to inspect
 370  * @return #GNUNET_NO if clean, #GNUNET_YES if dirty, #GNUNET_SYSERR on error (i.e. last save failed)
 371  */
 372 int
 373 GNUNET_CONFIGURATION_is_dirty (const struct GNUNET_CONFIGURATION_Handle *cfg)
 374 {
 375   return cfg->dirty;
 376 }
 377
 378
 379 /**
 380  * Serializes the given configuration.
 381  *
 382  * @param cfg configuration to serialize
 383  * @param size will be set to the size of the serialized memory block
 384  * @return the memory block where the serialized configuration is
 385  *           present. This memory should be freed by the caller
 386  */
 387 char *
 388 GNUNET_CONFIGURATION_serialize (const struct GNUNET_CONFIGURATION_Handle *cfg,
 389                                 size_t *size)
 390 {
 391   struct ConfigSection *sec;
 392   struct ConfigEntry *ent;
 393   char *mem;
 394   char *cbuf;
 395   char *val;
 396   char *pos;
 397   int len;
 398   size_t m_size;
 399   size_t c_size;
 400
 401
 402   /* Pass1 : calculate the buffer size required */
 403   m_size = 0;
 404   for (sec = cfg->sections; NULL != sec; sec = sec->next)
 405   {
 406     /* For each section we need to add 3 charaters: {'[',']','\n'} */
 407     m_size += strlen (sec->name) + 3;
 408     for (ent = sec->entries; NULL != ent; ent = ent->next)
 409     {
 410       if (NULL != ent->val)
 411       {
 412         /* if val has any '\n' then they occupy +1 character as '\n'->'\\','n' */
 413         pos = ent->val;
 414         while (NULL != (pos = strstr (pos, "\n")))
 415         {
 416           m_size++;
 417           pos++;
 418         }
 419         /* For each key = value pair we need to add 4 characters (2
 420            spaces and 1 equal-to character and 1 new line) */
 421         m_size += strlen (ent->key) + strlen (ent->val) + 4;
 422       }
 423     }
 424     /* A new line after section end */
 425     m_size++;
 426   }
 427
 428   /* Pass2: Allocate memory and write the configuration to it */
 429   mem = GNUNET_malloc (m_size);
 430   sec = cfg->sections;
 431   c_size = 0;
 432   *size = c_size;
 433   while (NULL != sec)
 434   {
 435     len = GNUNET_asprintf (&cbuf, "[%s]\n", sec->name);
 436     GNUNET_assert (0 < len);
 437     memcpy (mem + c_size, cbuf, len);
 438     c_size += len;
 439     GNUNET_free (cbuf);
 440     for (ent = sec->entries; NULL != ent; ent = ent->next)
 441     {
 442       if (NULL != ent->val)
 443       {
 444         val = GNUNET_malloc (strlen (ent->val) * 2 + 1);
 445         strcpy (val, ent->val);
 446         while (NULL != (pos = strstr (val, "\n")))
 447         {
 448           memmove (&pos[2], &pos[1], strlen (&pos[1]));
 449           pos[0] = '\\';
 450           pos[1] = 'n';
 451         }
 452         len = GNUNET_asprintf (&cbuf, "%s = %s\n", ent->key, val);
 453         GNUNET_free (val);
 454         memcpy (mem + c_size, cbuf, len);
 455         c_size += len;
 456         GNUNET_free (cbuf);
 457       }
 458     }
 459     memcpy (mem + c_size, "\n", 1);
 460     c_size ++;
 461     sec = sec->next;
 462   }
 463   GNUNET_assert (c_size == m_size);
 464   *size = c_size;
 465   return mem;
 466 }
 467
 468
 469 /**
 470  * Write configuration file.
 471  *
 472  * @param cfg configuration to write
 473  * @param filename where to write the configuration
 474  * @return #GNUNET_OK on success, #GNUNET_SYSERR on error
 475  */
 476 int
 477 GNUNET_CONFIGURATION_write (struct GNUNET_CONFIGURATION_Handle *cfg,
 478                             const char *filename)
 479 {
 480   char *fn;
 481   char *cfg_buf;
 482   size_t size;
 483
 484   fn = GNUNET_STRINGS_filename_expand (filename);
 485   if (fn == NULL)
 486     return GNUNET_SYSERR;
 487   if (GNUNET_OK != GNUNET_DISK_directory_create_for_file (fn))
 488   {
 489     GNUNET_free (fn);
 490     return GNUNET_SYSERR;
 491   }
 492   cfg_buf = GNUNET_CONFIGURATION_serialize (cfg, &size);
 493   if (size != GNUNET_DISK_fn_write (fn, cfg_buf, size,
 494                                     GNUNET_DISK_PERM_USER_READ
 495                                     | GNUNET_DISK_PERM_USER_WRITE
 496                                     | GNUNET_DISK_PERM_GROUP_READ
 497                                     | GNUNET_DISK_PERM_GROUP_WRITE))
 498   {
 499     GNUNET_free (fn);
 500     GNUNET_free (cfg_buf);
 501     LOG (GNUNET_ERROR_TYPE_WARNING,
 502          "Writing configration to file: %s failed\n", filename);
 503     cfg->dirty = GNUNET_SYSERR; /* last write failed */
 504     return GNUNET_SYSERR;
 505   }
 506   GNUNET_free (fn);
 507   GNUNET_free (cfg_buf);
 508   cfg->dirty = GNUNET_NO;       /* last write succeeded */
 509   return GNUNET_OK;
 510 }
 511
 512
 513 /**
 514  * Iterate over all options in the configuration.
 515  *
 516  * @param cfg configuration to inspect
 517  * @param iter function to call on each option
 518  * @param iter_cls closure for @a iter
 519  */
 520 void
 521 GNUNET_CONFIGURATION_iterate (const struct GNUNET_CONFIGURATION_Handle *cfg,
 522                               GNUNET_CONFIGURATION_Iterator iter,
 523                               void *iter_cls)
 524 {
 525   struct ConfigSection *spos;
 526   struct ConfigEntry *epos;
 527
 528   for (spos = cfg->sections; NULL != spos; spos = spos->next)
 529     for (epos = spos->entries; NULL != epos; epos = epos->next)
 530       if (NULL != epos->val)
 531         iter (iter_cls, spos->name, epos->key, epos->val);
 532 }
 533
 534
 535 /**
 536  * Iterate over values of a section in the configuration.
 537  *
 538  * @param cfg configuration to inspect
 539  * @param section the section
 540  * @param iter function to call on each option
 541  * @param iter_cls closure for @a iter
 542  */
 543 void
 544 GNUNET_CONFIGURATION_iterate_section_values (const struct
 545                                              GNUNET_CONFIGURATION_Handle *cfg,
 546                                              const char *section,
 547                                              GNUNET_CONFIGURATION_Iterator iter,
 548                                              void *iter_cls)
 549 {
 550   struct ConfigSection *spos;
 551   struct ConfigEntry *epos;
 552
 553   spos = cfg->sections;
 554   while ((spos != NULL) && (0 != strcasecmp (spos->name, section)))
 555     spos = spos->next;
 556   if (NULL == spos)
 557     return;
 558   for (epos = spos->entries; NULL != epos; epos = epos->next)
 559     if (NULL != epos->val)
 560       iter (iter_cls, spos->name, epos->key, epos->val);
 561 }
 562
 563
 564 /**
 565  * Iterate over all sections in the configuration.
 566  *
 567  * @param cfg configuration to inspect
 568  * @param iter function to call on each section
 569  * @param iter_cls closure for @a iter
 570  */
 571 void
 572 GNUNET_CONFIGURATION_iterate_sections (const struct GNUNET_CONFIGURATION_Handle
 573                                        *cfg,
 574                                        GNUNET_CONFIGURATION_Section_Iterator
 575                                        iter, void *iter_cls)
 576 {
 577   struct ConfigSection *spos;
 578   struct ConfigSection *next;
 579
 580   next = cfg->sections;
 581   while (next != NULL)
 582   {
 583     spos = next;
 584     next = spos->next;
 585     iter (iter_cls, spos->name);
 586   }
 587 }
 588
 589
 590 /**
 591  * Remove the given section and all options in it.
 592  *
 593  * @param cfg configuration to inspect
 594  * @param section name of the section to remove
 595  */
 596 void
 597 GNUNET_CONFIGURATION_remove_section (struct GNUNET_CONFIGURATION_Handle *cfg,
 598                                      const char *section)
 599 {
 600   struct ConfigSection *spos;
 601   struct ConfigSection *prev;
 602   struct ConfigEntry *ent;
 603
 604   prev = NULL;
 605   spos = cfg->sections;
 606   while (NULL != spos)
 607   {
 608     if (0 == strcasecmp (section, spos->name))
 609     {
 610       if (NULL == prev)
 611         cfg->sections = spos->next;
 612       else
 613         prev->next = spos->next;
 614       while (NULL != (ent = spos->entries))
 615       {
 616         spos->entries = ent->next;
 617         GNUNET_free (ent->key);
 618         GNUNET_free_non_null (ent->val);
 619         GNUNET_free (ent);
 620         cfg->dirty = GNUNET_YES;
 621       }
 622       GNUNET_free (spos->name);
 623       GNUNET_free (spos);
 624       return;
 625     }
 626     prev = spos;
 627     spos = spos->next;
 628   }
 629 }
 630
 631
 632 /**
 633  * Copy a configuration value to the given target configuration.
 634  * Overwrites existing entries.
 635  *
 636  * @param cls the destination configuration (`struct GNUNET_CONFIGURATION_Handle *`)
 637  * @param section section for the value
 638  * @param option option name of the value
 639  * @param value value to copy
 640  */
 641 static void
 642 copy_entry (void *cls,
 643             const char *section,
 644             const char *option,
 645             const char *value)
 646 {
 647   struct GNUNET_CONFIGURATION_Handle *dst = cls;
 648
 649   GNUNET_CONFIGURATION_set_value_string (dst, section, option, value);
 650 }
 651
 652
 653 /**
 654  * Duplicate an existing configuration object.
 655  *
 656  * @param cfg configuration to duplicate
 657  * @return duplicate configuration
 658  */
 659 struct GNUNET_CONFIGURATION_Handle *
 660 GNUNET_CONFIGURATION_dup (const struct GNUNET_CONFIGURATION_Handle *cfg)
 661 {
 662   struct GNUNET_CONFIGURATION_Handle *ret;
 663
 664   ret = GNUNET_CONFIGURATION_create ();
 665   GNUNET_CONFIGURATION_iterate (cfg, &copy_entry, ret);
 666   return ret;
 667 }
 668
 669
 670 /**
 671  * Find a section entry from a configuration.
 672  *
 673  * @param cfg configuration to search in
 674  * @param section name of the section to look for
 675  * @return matching entry, NULL if not found
 676  */
 677 static struct ConfigSection *
 678 find_section (const struct GNUNET_CONFIGURATION_Handle *cfg,
 679              const char *section)
 680 {
 681   struct ConfigSection *pos;
 682
 683   pos = cfg->sections;
 684   while ((pos != NULL) && (0 != strcasecmp (section, pos->name)))
 685     pos = pos->next;
 686   return pos;
 687 }
 688
 689
 690 /**
 691  * Find an entry from a configuration.
 692  *
 693  * @param cfg handle to the configuration
 694  * @param section section the option is in
 695  * @param key the option
 696  * @return matching entry, NULL if not found
 697  */
 698 static struct ConfigEntry *
 699 find_entry (const struct GNUNET_CONFIGURATION_Handle *cfg,
 700            const char *section,
 701            const char *key)
 702 {
 703   struct ConfigSection *sec;
 704   struct ConfigEntry *pos;
 705
 706   if (NULL == (sec = find_section (cfg, section)))
 707     return NULL;
 708   pos = sec->entries;
 709   while ((pos != NULL) && (0 != strcasecmp (key, pos->key)))
 710     pos = pos->next;
 711   return pos;
 712 }
 713
 714
 715 /**
 716  * A callback function, compares entries from two configurations
 717  * (default against a new configuration) and write the diffs in a
 718  * diff-configuration object (the callback object).
 719  *
 720  * @param cls the diff configuration (`struct DiffHandle *`)
 721  * @param section section for the value (of the default conf.)
 722  * @param option option name of the value (of the default conf.)
 723  * @param value value to copy (of the default conf.)
 724  */
 725 static void
 726 compare_entries (void *cls,
 727                  const char *section,
 728                  const char *option,
 729                  const char *value)
 730 {
 731   struct DiffHandle *dh = cls;
 732   struct ConfigEntry *entNew;
 733
 734   entNew = find_entry (dh->cfg_default, section, option);
 735   if ( (NULL != entNew) &&
 736        (NULL != entNew->val) &&
 737        (0 == strcmp (entNew->val, value)) )
 738     return;
 739   GNUNET_CONFIGURATION_set_value_string (dh->cfgDiff, section, option, value);
 740 }
 741
 742
 743 /**
 744  * Compute configuration with only entries that have been changed
 745  *
 746  * @param cfg_default original configuration
 747  * @param cfg_new new configuration
 748  * @return configuration with only the differences, never NULL
 749  */
 750 struct GNUNET_CONFIGURATION_Handle *
 751 GNUNET_CONFIGURATION_get_diff (const struct GNUNET_CONFIGURATION_Handle *cfg_default,
 752                                const struct GNUNET_CONFIGURATION_Handle *cfg_new)
 753 {
 754   struct DiffHandle diffHandle;
 755
 756   diffHandle.cfgDiff = GNUNET_CONFIGURATION_create ();
 757   diffHandle.cfg_default = cfg_default;
 758   GNUNET_CONFIGURATION_iterate (cfg_new, &compare_entries, &diffHandle);
 759   return diffHandle.cfgDiff;
 760 }
 761
 762
 763 /**
 764  * Write only configuration entries that have been changed to configuration file
 765  *
 766  * @param cfg_default default configuration
 767  * @param cfg_new new configuration
 768  * @param filename where to write the configuration diff between default and new
 769  * @return #GNUNET_OK on success, #GNUNET_SYSERR on error
 770  */
 771 int
 772 GNUNET_CONFIGURATION_write_diffs (const struct GNUNET_CONFIGURATION_Handle
 773                                   *cfg_default,
 774                                   const struct GNUNET_CONFIGURATION_Handle
 775                                   *cfg_new, const char *filename)
 776 {
 777   int ret;
 778   struct GNUNET_CONFIGURATION_Handle *diff;
 779
 780   diff = GNUNET_CONFIGURATION_get_diff (cfg_default, cfg_new);
 781   ret = GNUNET_CONFIGURATION_write (diff, filename);
 782   GNUNET_CONFIGURATION_destroy (diff);
 783   return ret;
 784 }
 785
 786
 787 /**
 788  * Set a configuration value that should be a string.
 789  *
 790  * @param cfg configuration to update
 791  * @param section section of interest
 792  * @param option option of interest
 793  * @param value value to set
 794  */
 795 void
 796 GNUNET_CONFIGURATION_set_value_string (struct GNUNET_CONFIGURATION_Handle *cfg,
 797                                        const char *section, const char *option,
 798                                        const char *value)
 799 {
 800   struct ConfigSection *sec;
 801   struct ConfigEntry *e;
 802   char *nv;
 803
 804   e = find_entry (cfg, section, option);
 805   if (NULL != e)
 806   {
 807     if (NULL == value)
 808     {
 809       GNUNET_free_non_null (e->val);
 810       e->val = NULL;
 811     }
 812     else
 813     {
 814       nv = GNUNET_strdup (value);
 815       GNUNET_free_non_null (e->val);
 816       e->val = nv;
 817     }
 818     return;
 819   }
 820   sec = find_section (cfg, section);
 821   if (sec == NULL)
 822   {
 823     sec = GNUNET_new (struct ConfigSection);
 824     sec->name = GNUNET_strdup (section);
 825     sec->next = cfg->sections;
 826     cfg->sections = sec;
 827   }
 828   e = GNUNET_new (struct ConfigEntry);
 829   e->key = GNUNET_strdup (option);
 830   e->val = GNUNET_strdup (value);
 831   e->next = sec->entries;
 832   sec->entries = e;
 833 }
 834
 835
 836 /**
 837  * Set a configuration value that should be a number.
 838  *
 839  * @param cfg configuration to update
 840  * @param section section of interest
 841  * @param option option of interest
 842  * @param number value to set
 843  */
 844 void
 845 GNUNET_CONFIGURATION_set_value_number (struct GNUNET_CONFIGURATION_Handle *cfg,
 846                                        const char *section, const char *option,
 847                                        unsigned long long number)
 848 {
 849   char s[64];
 850
 851   GNUNET_snprintf (s, 64, "%llu", number);
 852   GNUNET_CONFIGURATION_set_value_string (cfg, section, option, s);
 853 }
 854
 855
 856 /**
 857  * Get a configuration value that should be a number.
 858  *
 859  * @param cfg configuration to inspect
 860  * @param section section of interest
 861  * @param option option of interest
 862  * @param number where to store the numeric value of the option
 863  * @return #GNUNET_OK on success, #GNUNET_SYSERR on error
 864  */
 865 int
 866 GNUNET_CONFIGURATION_get_value_number (const struct GNUNET_CONFIGURATION_Handle
 867                                        *cfg, const char *section,
 868                                        const char *option,
 869                                        unsigned long long *number)
 870 {
 871   struct ConfigEntry *e;
 872
 873   if (NULL == (e = find_entry (cfg, section, option)))
 874     return GNUNET_SYSERR;
 875   if (NULL == e->val)
 876     return GNUNET_SYSERR;
 877   if (1 != SSCANF (e->val, "%llu", number))
 878     return GNUNET_SYSERR;
 879   return GNUNET_OK;
 880 }
 881
 882 /**
 883  * Get a configuration value that should be a floating point number.
 884  *
 885  * @param cfg configuration to inspect
 886  * @param section section of interest
 887  * @param option option of interest
 888  * @param number where to store the floating value of the option
 889  * @return #GNUNET_OK on success, #GNUNET_SYSERR on error
 890  */
 891 int
 892 GNUNET_CONFIGURATION_get_value_float  (const struct GNUNET_CONFIGURATION_Handle
 893                                        *cfg, const char *section,
 894                                        const char *option,
 895                                        float *number)
 896 {
 897   struct ConfigEntry *e;
 898
 899   if (NULL == (e = find_entry (cfg, section, option)))
 900     return GNUNET_SYSERR;
 901   if (NULL == e->val)
 902     return GNUNET_SYSERR;
 903   if (1 != SSCANF (e->val, "%f", number))
 904     return GNUNET_SYSERR;
 905   return GNUNET_OK;
 906 }
 907
 908
 909
 910 /**
 911  * Get a configuration value that should be a relative time.
 912  *
 913  * @param cfg configuration to inspect
 914  * @param section section of interest
 915  * @param option option of interest
 916  * @param time set to the time value stored in the configuration
 917  * @return #GNUNET_OK on success, #GNUNET_SYSERR on error
 918  */
 919 int
 920 GNUNET_CONFIGURATION_get_value_time (const struct GNUNET_CONFIGURATION_Handle
 921                                      *cfg, const char *section,
 922                                      const char *option,
 923                                      struct GNUNET_TIME_Relative *time)
 924 {
 925   struct ConfigEntry *e;
 926
 927   if (NULL == (e = find_entry (cfg, section, option)))
 928     return GNUNET_SYSERR;
 929   if (NULL == e->val)
 930     return GNUNET_SYSERR;
 931   return GNUNET_STRINGS_fancy_time_to_relative (e->val, time);
 932 }
 933
 934
 935 /**
 936  * Get a configuration value that should be a size in bytes.
 937  *
 938  * @param cfg configuration to inspect
 939  * @param section section of interest
 940  * @param option option of interest
 941  * @param size set to the size in bytes as stored in the configuration
 942  * @return #GNUNET_OK on success, #GNUNET_SYSERR on error
 943  */
 944 int
 945 GNUNET_CONFIGURATION_get_value_size (const struct GNUNET_CONFIGURATION_Handle *cfg,
 946                                      const char *section,
 947                                      const char *option,
 948                                      unsigned long long *size)
 949 {
 950   struct ConfigEntry *e;
 951
 952   if (NULL == (e = find_entry (cfg, section, option)))
 953     return GNUNET_SYSERR;
 954   if (NULL == e->val)
 955     return GNUNET_SYSERR;
 956   return GNUNET_STRINGS_fancy_size_to_bytes (e->val, size);
 957 }
 958
 959
 960 /**
 961  * Get a configuration value that should be a string.
 962  *
 963  * @param cfg configuration to inspect
 964  * @param section section of interest
 965  * @param option option of interest
 966  * @param value will be set to a freshly allocated configuration
 967  *        value, or NULL if option is not specified
 968  * @return #GNUNET_OK on success, #GNUNET_SYSERR on error
 969  */
 970 int
 971 GNUNET_CONFIGURATION_get_value_string (const struct GNUNET_CONFIGURATION_Handle *cfg,
 972                                        const char *section,
 973                                        const char *option,
 974                                        char **value)
 975 {
 976   struct ConfigEntry *e;
 977
 978   LOG (GNUNET_ERROR_TYPE_DEBUG,
 979        "Asked to retrieve string `%s' in section `%s'\n",
 980        option,
 981        section);
 982   if ( (NULL == (e = find_entry (cfg, section, option))) ||
 983        (NULL == e->val) )
 984   {
 985     *value = NULL;
 986     return GNUNET_SYSERR;
 987   }
 988   *value = GNUNET_strdup (e->val);
 989   return GNUNET_OK;
 990 }
 991
 992
 993 /**
 994  * Get a configuration value that should be in a set of
 995  * predefined strings
 996  *
 997  * @param cfg configuration to inspect
 998  * @param section section of interest
 999  * @param option option of interest
1000  * @param choices NULL-terminated list of legal values
1001  * @param value will be set to an entry in the legal list,
1002  *        or NULL if option is not specified and no default given
1003  * @return #GNUNET_OK on success, #GNUNET_SYSERR on error
1004  */
1005 int
1006 GNUNET_CONFIGURATION_get_value_choice (const struct GNUNET_CONFIGURATION_Handle *cfg,
1007                                        const char *section,
1008                                        const char *option,
1009                                        const char *const *choices,
1010                                        const char **value)
1011 {
1012   struct ConfigEntry *e;
1013   unsigned int i;
1014
1015   if (NULL == (e = find_entry (cfg, section, option)))
1016     return GNUNET_SYSERR;
1017   for (i = 0; NULL != choices[i]; i++)
1018     if (0 == strcasecmp (choices[i], e->val))
1019       break;
1020   if (NULL == choices[i])
1021   {
1022     LOG (GNUNET_ERROR_TYPE_ERROR,
1023          _("Configuration value '%s' for '%s'"
1024            " in section '%s' is not in set of legal choices\n"),
1025          e->val,
1026          option,
1027          section);
1028     return GNUNET_SYSERR;
1029   }
1030   *value = choices[i];
1031   return GNUNET_OK;
1032 }
1033
1034
1035 /**
1036  * Test if we have a value for a particular option
1037  *
1038  * @param cfg configuration to inspect
1039  * @param section section of interest
1040  * @param option option of interest
1041  * @return #GNUNET_YES if so, #GNUNET_NO if not.
1042  */
1043 int
1044 GNUNET_CONFIGURATION_have_value (const struct GNUNET_CONFIGURATION_Handle *cfg,
1045                                  const char *section, const char *option)
1046 {
1047   struct ConfigEntry *e;
1048
1049   if ((NULL == (e = find_entry (cfg, section, option))) || (NULL == e->val))
1050     return GNUNET_NO;
1051   return GNUNET_YES;
1052 }
1053
1054
1055 /**
1056  * Expand an expression of the form "$FOO/BAR" to "DIRECTORY/BAR"
1057  * where either in the "PATHS" section or the environtment "FOO" is
1058  * set to "DIRECTORY".  We also support default expansion,
1059  * i.e. ${VARIABLE:-default} will expand to $VARIABLE if VARIABLE is
1060  * set in PATHS or the environment, and otherwise to "default".  Note
1061  * that "default" itself can also be a $-expression, thus
1062  * "${VAR1:-{$VAR2}}" will expand to VAR1 and if that is not defined
1063  * to VAR2.
1064  *
1065  * @param cfg configuration to use for path expansion
1066  * @param orig string to $-expand (will be freed!)
1067  * @param depth recursion depth, used to detect recursive expansions
1068  * @return $-expanded string
1069  */
1070 static char *
1071 expand_dollar (const struct GNUNET_CONFIGURATION_Handle *cfg,
1072                char *orig,
1073                unsigned int depth)
1074 {
1075   int i;
1076   char *prefix;
1077   char *result;
1078   char *start;
1079   const char *post;
1080   const char *env;
1081   char *def;
1082   char *end;
1083   unsigned int lopen;
1084   char erased_char;
1085   char *erased_pos;
1086   size_t len;
1087
1088   if (NULL == orig)
1089     return NULL;
1090   if (depth > 128)
1091   {
1092     LOG (GNUNET_ERROR_TYPE_WARNING,
1093          _("Recursive expansion suspected, aborting $-expansion for term `%s'\n"),
1094          orig);
1095     return orig;
1096   }
1097   LOG (GNUNET_ERROR_TYPE_DEBUG,
1098        "Asked to $-expand %s\n", orig);
1099   if ('$' != orig[0])
1100   {
1101     LOG (GNUNET_ERROR_TYPE_DEBUG,
1102          "Doesn't start with $ - not expanding\n");
1103     return orig;
1104   }
1105   erased_char = 0;
1106   erased_pos = NULL;
1107   if ('{' == orig[1])
1108   {
1109     start = &orig[2];
1110     lopen = 1;
1111     end = &orig[1];
1112     while (lopen > 0)
1113     {
1114       end++;
1115       switch (*end)
1116       {
1117       case '}':
1118         lopen--;
1119         break;
1120       case '{':
1121         lopen++;
1122         break;
1123       case '\0':
1124         LOG (GNUNET_ERROR_TYPE_WARNING,
1125              _("Missing closing `%s' in option `%s'\n"),
1126              "}",
1127              orig);
1128         return orig;
1129       default:
1130         break;
1131       }
1132     }
1133     erased_char = *end;
1134     erased_pos = end;
1135     *end = '\0';
1136     post = end + 1;
1137     def = strchr (orig, ':');
1138     if (NULL != def)
1139     {
1140       *def = '\0';
1141       def++;
1142       if ( ('-' == *def) ||
1143            ('=' == *def) )
1144         def++;
1145       def = GNUNET_strdup (def);
1146     }
1147   }
1148   else
1149   {
1150     start = &orig[1];
1151     def = NULL;
1152     i = 0;
1153     while ( (orig[i] != '/') &&
1154             (orig[i] != '\\') &&
1155             (orig[i] != '\0')  &&
1156             (orig[i] != ' ') )
1157       i++;
1158     if (orig[i] == '\0')
1159     {
1160       post = "";
1161     }
1162     else
1163     {
1164       erased_char = orig[i];
1165       erased_pos = &orig[i];
1166       orig[i] = '\0';
1167       post = &orig[i + 1];
1168     }
1169   }
1170   LOG (GNUNET_ERROR_TYPE_DEBUG,
1171        "Split into `%s' and `%s' with default %s\n",
1172        start,
1173        post,
1174        def);
1175   if (GNUNET_OK !=
1176       GNUNET_CONFIGURATION_get_value_string (cfg,
1177                                              "PATHS",
1178                                              start,
1179                                              &prefix))
1180   {
1181     LOG (GNUNET_ERROR_TYPE_DEBUG,
1182          "Filename for `%s' is not in PATHS config section\n",
1183          start);
1184     if (NULL == (env = getenv (start)))
1185     {
1186       LOG (GNUNET_ERROR_TYPE_DEBUG,
1187            "`%s' is not an environment variable\n",
1188            start);
1189       /* try default */
1190       def = expand_dollar (cfg, def, depth + 1);
1191       env = def;
1192     }
1193     if (NULL == env)
1194     {
1195       start = GNUNET_strdup (start);
1196       if (erased_pos)
1197         *erased_pos = erased_char;
1198       LOG (GNUNET_ERROR_TYPE_WARNING,
1199            _("Failed to expand `%s' in `%s' as it is neither found in [PATHS] nor defined as an environmental variable\n"),
1200            start, orig);
1201       GNUNET_free (start);
1202       return orig;
1203     }
1204     prefix = GNUNET_strdup (env);
1205   }
1206   prefix = GNUNET_CONFIGURATION_expand_dollar (cfg, prefix);
1207   LOG (GNUNET_ERROR_TYPE_DEBUG,
1208        "Prefix is `%s'\n",
1209        prefix);
1210   if ( (erased_pos) && ('}' != erased_char) )
1211   {
1212     len = strlen (prefix) + 1;
1213     prefix = GNUNET_realloc (prefix, len + 1);
1214     prefix[len - 1] = erased_char;
1215     prefix[len] = '\0';
1216   }
1217   result = GNUNET_malloc (strlen (prefix) + strlen (post) + 1);
1218   strcpy (result, prefix);
1219   strcat (result, post);
1220   GNUNET_free_non_null (def);
1221   GNUNET_free (prefix);
1222   GNUNET_free (orig);
1223   LOG (GNUNET_ERROR_TYPE_DEBUG,
1224        "Expanded to `%s'\n",
1225        result);
1226   return result;
1227 }
1228
1229
1230 /**
1231  * Expand an expression of the form "$FOO/BAR" to "DIRECTORY/BAR"
1232  * where either in the "PATHS" section or the environtment "FOO" is
1233  * set to "DIRECTORY".  We also support default expansion,
1234  * i.e. ${VARIABLE:-default} will expand to $VARIABLE if VARIABLE is
1235  * set in PATHS or the environment, and otherwise to "default".  Note
1236  * that "default" itself can also be a $-expression, thus
1237  * "${VAR1:-{$VAR2}}" will expand to VAR1 and if that is not defined
1238  * to VAR2.
1239  *
1240  * @param cfg configuration to use for path expansion
1241  * @param orig string to $-expand (will be freed!).  Note that multiple
1242  *          $-expressions can be present in this string.  They will all be
1243  *          $-expanded.
1244  * @return $-expanded string
1245  */
1246 char *
1247 GNUNET_CONFIGURATION_expand_dollar (const struct GNUNET_CONFIGURATION_Handle *cfg,
1248                                     char *orig)
1249 {
1250   char *dup;
1251   size_t i;
1252   size_t len;
1253
1254   for (i = 0; '\0' != orig[i]; i++)
1255   {
1256     if ('$' != orig[i])
1257       continue;
1258     dup = GNUNET_strdup (orig + i);
1259     dup = expand_dollar (cfg, dup, 0);
1260     len = strlen (dup) + 1;
1261     orig = GNUNET_realloc (orig, i + len);
1262     memcpy (orig + i, dup, len);
1263     GNUNET_free (dup);
1264   }
1265   return orig;
1266 }
1267
1268
1269 /**
1270  * Get a configuration value that should be a string.
1271  *
1272  * @param cfg configuration to inspect
1273  * @param section section of interest
1274  * @param option option of interest
1275  * @param value will be set to a freshly allocated configuration
1276  *        value, or NULL if option is not specified
1277  * @return #GNUNET_OK on success, #GNUNET_SYSERR on error
1278  */
1279 int
1280 GNUNET_CONFIGURATION_get_value_filename (const struct GNUNET_CONFIGURATION_Handle *cfg,
1281                                          const char *section,
1282                                          const char *option,
1283                                          char **value)
1284 {
1285   char *tmp;
1286
1287   LOG (GNUNET_ERROR_TYPE_DEBUG,
1288        "Asked to retrieve filename `%s' in section `%s'\n",
1289        option,
1290        section);
1291   if (GNUNET_OK !=
1292       GNUNET_CONFIGURATION_get_value_string (cfg, section, option, &tmp))
1293   {
1294     LOG (GNUNET_ERROR_TYPE_DEBUG,
1295          "Failed to retrieve filename\n");
1296     *value = NULL;
1297     return GNUNET_SYSERR;
1298   }
1299   LOG (GNUNET_ERROR_TYPE_DEBUG, "Retrieved filename `%s', $-expanding\n", tmp);
1300   tmp = GNUNET_CONFIGURATION_expand_dollar (cfg, tmp);
1301   LOG (GNUNET_ERROR_TYPE_DEBUG, "Expanded to filename `%s', *nix-expanding\n", tmp);
1302   *value = GNUNET_STRINGS_filename_expand (tmp);
1303   GNUNET_free (tmp);
1304   LOG (GNUNET_ERROR_TYPE_DEBUG, "Filename result is `%s'\n", *value);
1305   if (*value == NULL)
1306     return GNUNET_SYSERR;
1307   return GNUNET_OK;
1308 }
1309
1310
1311 /**
1312  * Get a configuration value that should be in a set of
1313  * "YES" or "NO".
1314  *
1315  * @param cfg configuration to inspect
1316  * @param section section of interest
1317  * @param option option of interest
1318  * @return #GNUNET_YES, #GNUNET_NO or #GNUNET_SYSERR
1319  */
1320 int
1321 GNUNET_CONFIGURATION_get_value_yesno (const struct GNUNET_CONFIGURATION_Handle *cfg,
1322                                       const char *section,
1323                                       const char *option)
1324 {
1325   static const char *yesno[] = { "YES", "NO", NULL };
1326   const char *val;
1327   int ret;
1328
1329   ret =
1330       GNUNET_CONFIGURATION_get_value_choice (cfg, section, option, yesno, &val);
1331   if (ret == GNUNET_SYSERR)
1332     return ret;
1333   if (val == yesno[0])
1334     return GNUNET_YES;
1335   return GNUNET_NO;
1336 }
1337
1338
1339 /**
1340  * Iterate over the set of filenames stored in a configuration value.
1341  *
1342  * @param cfg configuration to inspect
1343  * @param section section of interest
1344  * @param option option of interest
1345  * @param cb function to call on each filename
1346  * @param cb_cls closure for @a cb
1347  * @return number of filenames iterated over, -1 on error
1348  */
1349 int
1350 GNUNET_CONFIGURATION_iterate_value_filenames (const struct GNUNET_CONFIGURATION_Handle *cfg,
1351                                               const char *section,
1352                                               const char *option,
1353                                               GNUNET_FileNameCallback cb,
1354                                               void *cb_cls)
1355 {
1356   char *list;
1357   char *pos;
1358   char *end;
1359   char old;
1360   int ret;
1361
1362   if (GNUNET_OK !=
1363       GNUNET_CONFIGURATION_get_value_string (cfg, section, option, &list))
1364     return 0;
1365   GNUNET_assert (list != NULL);
1366   ret = 0;
1367   pos = list;
1368   while (1)
1369   {
1370     while (pos[0] == ' ')
1371       pos++;
1372     if (strlen (pos) == 0)
1373       break;
1374     end = pos + 1;
1375     while ((end[0] != ' ') && (end[0] != '\0'))
1376     {
1377       if (end[0] == '\\')
1378       {
1379         switch (end[1])
1380         {
1381         case '\\':
1382         case ' ':
1383           memmove (end, &end[1], strlen (&end[1]) + 1);
1384         case '\0':
1385           /* illegal, but just keep it */
1386           break;
1387         default:
1388           /* illegal, but just ignore that there was a '/' */
1389           break;
1390         }
1391       }
1392       end++;
1393     }
1394     old = end[0];
1395     end[0] = '\0';
1396     if (strlen (pos) > 0)
1397     {
1398       ret++;
1399       if ((cb != NULL) && (GNUNET_OK != cb (cb_cls, pos)))
1400       {
1401         ret = GNUNET_SYSERR;
1402         break;
1403       }
1404     }
1405     if (old == '\0')
1406       break;
1407     pos = end + 1;
1408   }
1409   GNUNET_free (list);
1410   return ret;
1411 }
1412
1413
1414 /**
1415  * FIXME.
1416  *
1417  * @param value FIXME
1418  * @return FIXME
1419  */
1420 static char *
1421 escape_name (const char *value)
1422 {
1423   char *escaped;
1424   const char *rpos;
1425   char *wpos;
1426
1427   escaped = GNUNET_malloc (strlen (value) * 2 + 1);
1428   memset (escaped, 0, strlen (value) * 2 + 1);
1429   rpos = value;
1430   wpos = escaped;
1431   while (rpos[0] != '\0')
1432   {
1433     switch (rpos[0])
1434     {
1435     case '\\':
1436     case ' ':
1437       wpos[0] = '\\';
1438       wpos[1] = rpos[0];
1439       wpos += 2;
1440       break;
1441     default:
1442       wpos[0] = rpos[0];
1443       wpos++;
1444     }
1445     rpos++;
1446   }
1447   return escaped;
1448 }
1449
1450
1451 /**
1452  * FIXME.
1453  *
1454  * @param cls string we compare with (const char*)
1455  * @param fn filename we are currently looking at
1456  * @return #GNUNET_OK if the names do not match, #GNUNET_SYSERR if they do
1457  */
1458 static int
1459 test_match (void *cls, const char *fn)
1460 {
1461   const char *of = cls;
1462
1463   return (0 == strcmp (of, fn)) ? GNUNET_SYSERR : GNUNET_OK;
1464 }
1465
1466
1467 /**
1468  * Append a filename to a configuration value that
1469  * represents a list of filenames
1470  *
1471  * @param cfg configuration to update
1472  * @param section section of interest
1473  * @param option option of interest
1474  * @param value filename to append
1475  * @return #GNUNET_OK on success,
1476  *         #GNUNET_NO if the filename already in the list
1477  *         #GNUNET_SYSERR on error
1478  */
1479 int
1480 GNUNET_CONFIGURATION_append_value_filename (struct GNUNET_CONFIGURATION_Handle *cfg,
1481                                             const char *section,
1482                                             const char *option,
1483                                             const char *value)
1484 {
1485   char *escaped;
1486   char *old;
1487   char *nw;
1488
1489   if (GNUNET_SYSERR ==
1490       GNUNET_CONFIGURATION_iterate_value_filenames (cfg, section, option,
1491                                                     &test_match,
1492                                                     (void *) value))
1493     return GNUNET_NO;           /* already exists */
1494   if (GNUNET_OK !=
1495       GNUNET_CONFIGURATION_get_value_string (cfg, section, option, &old))
1496     old = GNUNET_strdup ("");
1497   escaped = escape_name (value);
1498   nw = GNUNET_malloc (strlen (old) + strlen (escaped) + 2);
1499   strcpy (nw, old);
1500   if (strlen (old) > 0)
1501     strcat (nw, " ");
1502   strcat (nw, escaped);
1503   GNUNET_CONFIGURATION_set_value_string (cfg, section, option, nw);
1504   GNUNET_free (old);
1505   GNUNET_free (nw);
1506   GNUNET_free (escaped);
1507   return GNUNET_OK;
1508 }
1509
1510
1511 /**
1512  * Remove a filename from a configuration value that
1513  * represents a list of filenames
1514  *
1515  * @param cfg configuration to update
1516  * @param section section of interest
1517  * @param option option of interest
1518  * @param value filename to remove
1519  * @return #GNUNET_OK on success,
1520  *         #GNUNET_NO if the filename is not in the list,
1521  *         #GNUNET_SYSERR on error
1522  */
1523 int
1524 GNUNET_CONFIGURATION_remove_value_filename (struct GNUNET_CONFIGURATION_Handle
1525                                             *cfg, const char *section,
1526                                             const char *option,
1527                                             const char *value)
1528 {
1529   char *list;
1530   char *pos;
1531   char *end;
1532   char *match;
1533   char old;
1534
1535   if (GNUNET_OK !=
1536       GNUNET_CONFIGURATION_get_value_string (cfg, section, option, &list))
1537     return GNUNET_NO;
1538   match = escape_name (value);
1539   pos = list;
1540   while (1)
1541   {
1542     while (pos[0] == ' ')
1543       pos++;
1544     if (strlen (pos) == 0)
1545       break;
1546     end = pos + 1;
1547     while ((end[0] != ' ') && (end[0] != '\0'))
1548     {
1549       if (end[0] == '\\')
1550       {
1551         switch (end[1])
1552         {
1553         case '\\':
1554         case ' ':
1555           end++;
1556           break;
1557         case '\0':
1558           /* illegal, but just keep it */
1559           break;
1560         default:
1561           /* illegal, but just ignore that there was a '/' */
1562           break;
1563         }
1564       }
1565       end++;
1566     }
1567     old = end[0];
1568     end[0] = '\0';
1569     if (0 == strcmp (pos, match))
1570     {
1571       if (old != '\0')
1572         memmove (pos, &end[1], strlen (&end[1]) + 1);
1573       else
1574       {
1575         if (pos != list)
1576           pos[-1] = '\0';
1577         else
1578           pos[0] = '\0';
1579       }
1580       GNUNET_CONFIGURATION_set_value_string (cfg, section, option, list);
1581       GNUNET_free (list);
1582       GNUNET_free (match);
1583       return GNUNET_OK;
1584     }
1585     if (old == '\0')
1586       break;
1587     end[0] = old;
1588     pos = end + 1;
1589   }
1590   GNUNET_free (list);
1591   GNUNET_free (match);
1592   return GNUNET_NO;
1593 }
1594
1595
1596 /**
1597  * Wrapper around #GNUNET_CONFIGURATION_parse.  Called on each
1598  * file in a directory, we trigger parsing on those files that
1599  * end with ".conf".
1600  *
1601  * @param cls the cfg
1602  * @param filename file to parse
1603  * @return #GNUNET_OK on success
1604  */
1605 static int
1606 parse_configuration_file (void *cls, const char *filename)
1607 {
1608   struct GNUNET_CONFIGURATION_Handle *cfg = cls;
1609   char * ext;
1610   int ret;
1611
1612   /* Examine file extension */
1613   ext = strrchr (filename, '.');
1614   if ((NULL == ext) || (0 != strcmp (ext, ".conf")))
1615   {
1616     GNUNET_log (GNUNET_ERROR_TYPE_WARNING,
1617                 "Skipping file `%s'\n",
1618                 filename);
1619     return GNUNET_OK;
1620   }
1621
1622   ret = GNUNET_CONFIGURATION_parse (cfg, filename);
1623   return ret;
1624 }
1625
1626
1627 /**
1628  * Load default configuration.  This function will parse the
1629  * defaults from the given defaults_d directory.
1630  *
1631  * @param cfg configuration to update
1632  * @param defaults_d directory with the defaults
1633  * @return #GNUNET_OK on success, #GNUNET_SYSERR on error
1634  */
1635 int
1636 GNUNET_CONFIGURATION_load_from (struct GNUNET_CONFIGURATION_Handle *cfg,
1637                                 const char *defaults_d)
1638 {
1639   if (GNUNET_SYSERR ==
1640       GNUNET_DISK_directory_scan (defaults_d, &parse_configuration_file, cfg))
1641     return GNUNET_SYSERR;       /* no configuration at all found */
1642   return GNUNET_OK;
1643 }
1644
1645
1646 /**
1647  * Load configuration (starts with defaults, then loads
1648  * system-specific configuration).
1649  *
1650  * @param cfg configuration to update
1651  * @param filename name of the configuration file, NULL to load defaults
1652  * @return #GNUNET_OK on success, #GNUNET_SYSERR on error
1653  */
1654 int
1655 GNUNET_CONFIGURATION_load (struct GNUNET_CONFIGURATION_Handle *cfg,
1656                            const char *filename)
1657 {
1658   char *baseconfig;
1659   char *ipath;
1660
1661   ipath = GNUNET_OS_installation_get_path (GNUNET_OS_IPK_DATADIR);
1662   if (NULL == ipath)
1663     return GNUNET_SYSERR;
1664   baseconfig = NULL;
1665   GNUNET_asprintf (&baseconfig, "%s%s", ipath, "config.d");
1666   GNUNET_free (ipath);
1667   if (GNUNET_SYSERR ==
1668       GNUNET_DISK_directory_scan (baseconfig, &parse_configuration_file, cfg))
1669   {
1670     GNUNET_free (baseconfig);
1671     return GNUNET_SYSERR;       /* no configuration at all found */
1672   }
1673   GNUNET_free (baseconfig);
1674   if ((NULL != filename) &&
1675       (GNUNET_OK != GNUNET_CONFIGURATION_parse (cfg, filename)))
1676   {
1677     /* specified configuration not found */
1678     return GNUNET_SYSERR;
1679   }
1680   if (((GNUNET_YES !=
1681         GNUNET_CONFIGURATION_have_value (cfg, "PATHS", "DEFAULTCONFIG"))) &&
1682       (filename != NULL))
1683     GNUNET_CONFIGURATION_set_value_string (cfg, "PATHS", "DEFAULTCONFIG",
1684                                            filename);
1685   return GNUNET_OK;
1686 }
1687
1688
1689 /* end of configuration.c */