2 * Sherlock Library -- Reading configuration files
4 * (c) 2001 Robert Spalek <robert@ucw.cz>
6 * This software may be freely distributed and used according to the terms
7 * of the GNU Lesser General Public License.
16 * Allocation in configuration memory pool.
19 extern struct mempool *cfpool;
20 void *cfg_malloc(uns size);
21 byte *cfg_stralloc(byte *s);
24 * Every module places its configuration setting into some section. Section is
25 * an array of cfitem, whose first record is of type CT_SECTION and contains
26 * the name of the section. The configuration sections are registered by
27 * calling cf_register().
29 * CT_INCOMPLETE_SECTION is identical to CT_SECTION, but when an unknown variable
30 * is spotted, we ignore it instead of bailing out with an error message.
32 * item->var is a pointer to the destination variable or to the special parsing
36 enum cftype { CT_STOP, CT_SECTION, CT_INCOMPLETE_SECTION, CT_INT, CT_STRING, CT_FUNCTION };
44 typedef byte *(*ci_func)(struct cfitem *, byte *);
46 void cf_register(struct cfitem *items);
49 * Direct setting of configuration items and parsing the configuration file.
52 int cf_item_count(void);
53 struct cfitem *cf_get_item(byte *sect, byte *name);
54 byte *cf_set_item(byte *sect, byte *name, byte *value);
55 void cf_read(byte *filename);
58 * When using cf_getopt, you must prefix your own short/long options by the
59 * CF_(SHORT|LONG)_OPTS.
61 * cfdeffile contains filename of config file automatically loaded before a
62 * first --set option is executed. If none --set option occures, it will be
63 * loaded after getopt returns -1 (at the end of configuration options). It
64 * will be ignored, if another config file is set by --config option at first.
65 * Its initial value is DEFAULT_CONFIG from config.h, but you can override it
69 #define CF_SHORT_OPTS "S:C:"
70 #define CF_LONG_OPTS \
72 {"config", 1, 0, 'C'},
73 #define CF_NO_LONG_OPTS (const struct option []){ CF_LONG_OPTS { NULL, 0, 0, 0 } }
75 "-S, --set sec.item=val\tManual setting of a configuration item\n\
76 -C, --config filename\tOverwrite default config filename\n"
78 extern byte *cfdeffile;
80 int cf_getopt(int argc,char * const argv[],
81 const char *shortopts,const struct option *longopts,