X-Git-Url: http://mj.ucw.cz/gitweb/?a=blobdiff_plain;ds=inline;f=lib%2Fconf.h;h=85a9ebe564fad3b09d2c98cfae3c110af366cd9a;hb=ff36b07f44efa12a78809ee05bd6d0c25fc60495;hp=b225053cf21e513cd82bd2e4ecb1d66d2b30fb04;hpb=789dd227590c4fedc9acf6501cfabcd5ae1050e6;p=libucw.git diff --git a/lib/conf.h b/lib/conf.h index b225053c..85a9ebe5 100644 --- a/lib/conf.h +++ b/lib/conf.h @@ -1,7 +1,11 @@ /* - * Sherlock Library -- Reading configuration files + * UCW Library -- Reading of configuration files * * (c) 2001 Robert Spalek + * (c) 2003--2005 Martin Mares + * + * This software may be freely distributed and used according to the terms + * of the GNU Lesser General Public License. */ #ifndef _LIB_CONF_H @@ -13,8 +17,10 @@ * Allocation in configuration memory pool. */ +extern struct mempool *cfpool; void *cfg_malloc(uns size); -byte *cfg_stralloc(byte *s); +void *cfg_malloc_zero(uns size); +byte *cfg_strdup(byte *s); /* * Every module places its configuration setting into some section. Section is @@ -22,11 +28,14 @@ byte *cfg_stralloc(byte *s); * 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, CT_DOUBLE, CT_U64 }; struct cfitem { byte *name; @@ -47,6 +56,14 @@ struct cfitem *cf_get_item(byte *sect, byte *name); byte *cf_set_item(byte *sect, byte *name, byte *value); void cf_read(byte *filename); +/* + * Number parsing functions which could be useful in CT_FUNCTION callbacks. + */ + +byte *cf_parse_int(byte *value, uns *varp); +byte *cf_parse_u64(byte *value, u64 *varp); +byte *cf_parse_double(byte *value, double *varp); + /* * When using cf_getopt, you must prefix your own short/long options by the * CF_(SHORT|LONG)_OPTS. @@ -64,9 +81,10 @@ void cf_read(byte *filename); {"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_TAB "" #define CF_USAGE \ -"-S, --set sec.item=val\tManual setting of a configuration item\n\ --C, --config filename\tOverwrite default config filename\n" +"-S, --set sec.item=val\t" CF_USAGE_TAB "Manual setting of a configuration item\n\ +-C, --config filename\t" CF_USAGE_TAB "Overwrite default config filename\n" extern byte *cfdeffile;