* Sherlock Library -- Reading configuration files
*
* (c) 2001 Robert Spalek <robert@ucw.cz>
+ *
+ * This software may be freely distributed and used according to the terms
+ * of the GNU Lesser General Public License.
*/
+#ifndef _LIB_CONF_H
+#define _LIB_CONF_H
+
#include <getopt.h>
/*
* the name of the section. The configuration sections are registered by
* calling cf_register().
*
+ * CT_INCOMPLETE_SECTION is identical to CT_SECTION, but when an unknown variable
+ * is spotted, we ignore it instead of bailing out with an error message.
+ *
* item->var is a pointer to the destination variable or to the special parsing
* function.
*/
-enum cftype { CT_STOP, CT_SECTION, CT_INT, CT_STRING, CT_FUNCTION };
+enum cftype { CT_STOP, CT_SECTION, CT_INCOMPLETE_SECTION, CT_INT, CT_STRING, CT_FUNCTION };
struct cfitem {
byte *name;
* Direct setting of configuration items and parsing the configuration file.
*/
+int cf_item_count(void);
+struct cfitem *cf_get_item(byte *sect, byte *name);
byte *cf_set_item(byte *sect, byte *name, byte *value);
void cf_read(byte *filename);
/*
* When using cf_getopt, you must prefix your own short/long options by the
* CF_(SHORT|LONG)_OPTS.
+ *
+ * cfdeffile contains filename of config file automatically loaded before a
+ * first --set option is executed. If none --set option occures, it will be
+ * loaded after getopt returns -1 (at the end of configuration options). It
+ * will be ignored, if another config file is set by --config option at first.
+ * Its initial value is DEFAULT_CONFIG from config.h, but you can override it
+ * manually.
*/
#define CF_SHORT_OPTS "S:C:"
{"set", 1, 0, 'S'},\
{"config", 1, 0, 'C'},
#define CF_NO_LONG_OPTS (const struct option []){ CF_LONG_OPTS { NULL, 0, 0, 0 } }
+#define CF_USAGE \
+"-S, --set sec.item=val\tManual setting of a configuration item\n\
+-C, --config filename\tOverwrite default config filename\n"
+
+extern byte *cfdeffile;
int cf_getopt(int argc,char * const argv[],
const char *shortopts,const struct option *longopts,
int *longindex);
+#endif