/* Serval DNA configuration Copyright (C) 2012 Serval Project Inc. This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA. */ /* This file defines the internal API to the configuration file. See "conf_schema.h" for the * definition of the configuration schema, which is used to generate these API components. * * Each STRUCT(NAME, ...) schema declaration generates the following data declaration: * * struct config_NAME { * ... * }; * * A C struct definition containing exactly one element per schema declaration inside the * STRUCT..END_STRUCT block, in the defined order. The TYPE and NAME of each element depends * on the schema declaration that produces it: * * ATOM(TYPE, bar, ...) * NODE(TYPE, bar, ...) * * TYPE bar; * * STRING(SIZE, bar, ...) * * char bar[SIZE+1]; * * SUB_STRUCT(NAME, bar, ...) * NODE_STRUCT(NAME, bar, ...) * * struct config_NAME bar; * * Each ARRAY(NAME, ...) ... END_ARRAY(SIZE) schema declaration produces the following data * declaration: * * struct config_NAME { * unsigned ac; * struct config_NAME__element { * KEY-DECLARATION; * VALUE-DECLARATION; * } av[SIZE]; * }; * * A C struct definition containing a count 'ac' of the number of array elements 0..SIZE-1, * and 'av' an array of element values, each one consisting of a key and a value: * * KEY_ATOM(TYPE, ...) * * TYPE key; * * KEY_STRING(SIZE, ...) * * char key[SIZE+1]; * * VALUE_ATOM(NAME, SIZE, LABELLEN, TYPE, ...) * VALUE_NODE(NAME, SIZE, LABELLEN, TYPE, ...) * * TYPE value; * * VALUE_STRING(STRINGSIZE, ...) * * char value[STRINGSIZE+1]; * * VALUE_SUB_STRUCT(STRUCTNAME) * VALUE_NODE_STRUCT(STRUCTNAME, ...) * * struct config_STRUCTNAME value; * * Each STRUCT(NAME, ...) and ARRAY(NAME, ...) schema declaration generates the following API * functions: * * - int cf_dfl_config_NAME(struct config_NAME *dest); * * A C function which sets the entire contents of the given C structure to its default values * as defined in the schema. This will only return CFOK or CFERROR; see below. * * - int cf_opt_config_NAME(struct config_NAME *dest, const struct cf_om_node *node); * * A C function which parses the given COM (configuration object model) and assigns the parsed * result into the given C structure. See below for the return value. For arrays, this * function is used to parse each individual array element, and the parsed result is only * appended to the array if it returns CFOK. * * - int cf_cmp_config_NAME(const struct config_NAME *a, const struct config_NAME *b); * * A C function that compares the two C structures, returning -1, 0 or +1 in a stable * (invariant) fashion; successive calls for the same two structures will always return the * same result. This defines a stable ordering over all possible structure values, and allows * structures to be compared for equality. * * - int cf_fmt_config_NAME(struct cf_om_node **nodep, const struct config_NAME *src); * * A C function which decomposes the given C structure into a COM (configuration object model), * suitable for re-parsing or for inspection. This provides a limited form of run-time * reflection of configuration options. Each node in the generated COM has the 'line_number' * field set to 0 if the node contains the option's default value, or 1 if the option's value * differed from the default. * * If a STRUCT(NAME) or ARRAY(NAME, FLAGS) schema declaration contains a VALIDATOR(VALIDATOR_FUNC) * declaration, then the function must have the following signature: * * - int VALIDATOR_FUNC(struct config_NAME *dest, int orig_result); * * A C function which validates the contents of the given C structure (struct or array) as * defined in the schema. This function is invoked by the cf_opt_config_NAME() parser function * just before it returns, so all the parse functions have already been called and the result * is assembled. The validator function is passed a pointer to the (non-const) structure, * which it may modify if desired, and the original CFxxx flags result code (not CFERROR) that * would be returned by the cf_opt_config_NAME() parser function. It returns a new CFxxx flags * result (which may simply be the same as was passed). * * In the case arrays, validator() is passed a *dest containing elements that were successfully * parsed from the COM, omitting any that did not parse successfully (in which case the * relevant CFxxx result flags will be set) and arbitrarily omitting others that did not fit * (in which case the CFOVERFLOW flag is set). It is up to validator() to decide whether to * return some, all or none of these elements (ie, alter dest->ac and/or dest->av), and whether * to set or clear the CFARRAYOVERFLOW bit, or set other bits (like CFINVALID for example). If * there is no validator function, then cf_opt_config_NAME() will return an empty array (dest->ac * == 0) in the case of CFARRAYOVERFLOW. * * Each STRUCT_ASSIGN(NAME, SUPER) default declaration generates the following API function: * * - void cf_cpy_config_NAME(struct config_NAME *dest, struct config_SUPER *source); * * A C function which copies elements from 'source' into 'dest'. Any elements not defined in * the STRUCT_ASSIGN...END_STRUCT_ASSIGN declaration are simply not copied, so the 'dest' * structure should be initialised with known values prior to calling cf_cpy_config_NAME(), eg, * by zero filling, or better still, with its default values using cf_dfl_config_NAME(). * * All parse (cf_opt_) functions assign the result of their parsing into the struct given in their * 'dest' argument, and return a bitmask of the following flags: * * - CFERROR (all bits set, == -1) if an unrecoverable error occurs (eg, malloc() fails). The * result in *dest is undefined and may be malformed or inconsistent. * * - CFEMPTY if no items were parsed from the COM. In the case of a struct, this means that no * child nodes were found for any elements; if any child nodes were present but failed parsing * then CFEMPTY is not set but other flags will be set. In the case of arrays, CFEMPTY means * that the returned array has zero length for _any_ reason (overflow, element parsing failures, * or no elements present in the COM). * * - CFUNSUPPORTED if the config item (array or struct) is not supported. This flag is not * produced by the normal cf_opt_config_NAME() parse functions, but a validation function could set * it to indicate that a given option is not yet implemented or has been deprecated. In that * case, the validation function should also log a message to that effect. The CFUNSUPPORTED * flag is mainly used in its CFSUB(CFUNSUPPORTED) form (see below) to indicate that the COM * contains elements that are not defined in the STRUCT. This may indicate a typo in the name * of a config option, resulting in the intended option not being set. * * - CFDUPLICATE if a duplicate array entry was found. The result may be an empty array (in which * case CFEMPTY is also set), or an array that omits the duplicate element. It is not defined * which of the two conflicting elements will get omitted. Normal array parsing without a * validator function will return an empty array in the case of duplicate, but a validator * function may change this behaviour. * * - CFARRAYOVERFLOW if the size of any array was exceeded. The result in *dest may be empty (in * which case CFEMPTY is also set), or may contain elements parsed successfully from the COM (ie, * returned CFOK), omitting any that did not parse successfully (in which case the relevant * CFSUB() bits will be set) and arbitrarily omitting others that did not fit. It is not defined * which elements get omitted from an overflowed array. Normal array parsing without a validator * function will return an empty array in the case of overflow, but a validator function may * change this behaviour. * * - CFSTRINGFOVERFLOW if the size of any string element was exceeded. The result in *dest may be * unchanged or may contain a truncated string, depending on the parser that detected and * reported the string overflow. * * - CFINCOMPLETE if any MANDATORY element is missing (no node in the COM) or empty (as indicated * by the CFEMPTY bit in its parse result). The result in *dest is valid but the missing * mandatory element(s) are unchanged (in the case of a struct) or zero-length (in the case of an * array). * * - CFINVALID if any invalid configuration value was encountered, ie, any parse function returned * CFINVALID in its return flags. The result in *dest is valid and the elements that failed * to parse are unchanged. * * - CFSUB(CFxxx) if any element of a STRUCT or ARRAY produced a CFxxx result when being parsed, ie * any element's parse function returned CFxxx. In the case of a STRUCT, the failed elements are * usually left with their prior (default) values, but this depends on the parse functions' * behaviours. In the case of an ARRAY, failed elements are omitted from the array * * The difference between CFSUB(CFxxx) and CFxxx needs explaining. To illustrate, CFSUB(CFINVALID) * is different from CFINVALID because an element of a struct or array may have failed to parse, yet * the whole struct or array itself may still be valid (in the case of a struct, the element's prior * value may be retained, and in the case of an array, the failed element is simply omitted from the * result). A validator function may wish to reflect any CFSUB() bit as a CFINVALID result, but the * normal behaviour of cf_opt_config_NAME() is to not return CFINVALID unless the validator function * sets it. * * The special value CFOK is zero (no bits set); in this case a valid result is produced and all of * *dest is overwritten (except unused array elements). * * All format (cf_fmt_) functions return a bitmask of the following values: * * - CFERROR if an unrecoverable error occurs (eg, malloc() fails). The resulting COM is * undefined, but can safely be freed using cf_om_free_node(). * * - CFINVALID if an ATOM or STRING has an invalid value. This is only returned by ATOM and STRING * format functions, not STRUCT or ARRAY functions, which will return CFSUB(CFINVALID) if any of * their members is invalid. * * - CFEMPTY if an ATOM or STRING has an zero length but this is invalid. * * - CFSUB(CFxxx) if the format function (cf_fmt_) of any element of a sub-STRUCT or sub-ARRAY * returned a CFxxx result. In the case of STRUCT, the failed elements are omitted from the output * COM. * * @author Andrew Bettison */ #ifndef __SERVAL_DNA__CONF_H #define __SERVAL_DNA__CONF_H #include #include #include "constants.h" #include "serval_types.h" #include "rhizome_types.h" #include "strbuf.h" #include "httpd.h" #define CONFIG_FILE_MAX_SIZE (32 * 1024) #define INTERFACE_NAME_STRLEN 40 /* Return bit flags for config schema default cf_dfl_xxx() and parsing cf_opt_xxx() functions. */ #define CFERROR (~0) // all set #define CFOK 0 #define CFEMPTY (1<<0) #define CFDUPLICATE (1<<1) #define CFARRAYOVERFLOW (1<<2) #define CFSTRINGOVERFLOW (1<<3) #define CFINCOMPLETE (1<<4) #define CFINCOMPATIBLE (1<<5) #define CFINVALID (1<<6) #define CFUNSUPPORTED (1<<7) #define CF__SUB_SHIFT 16 #define CFSUB(f) ((f) << CF__SUB_SHIFT) #define CF__FLAGS (0xFFFF) #define CF__SUBFLAGS (~CF__FLAGS) strbuf strbuf_cf_flags(strbuf, int); strbuf strbuf_cf_flag_reason(strbuf sb, int flags); /* The Configuration Object Model (COM). The config file is parsed into a tree of these structures * first, then those structures are passed as arguments to the schema parsing functions. */ struct cf_om_node { const char *source; // = parse_config() 'source' arg unsigned int line_number; const char *fullkey; // malloc() const char *key; // points inside fullkey, do not free() const char *text; // malloc() size_t nodc; struct cf_om_node *nodv[0]; // malloc() }; int is_configvarname(const char *); int is_configvarpattern(const char *); int cf_om_parse(const char *source, const char *buf, size_t len, struct cf_om_node **rootp); int cf_om_get_child(const struct cf_om_node *parent, const char *key, const char *keyend); const char *cf_om_get(const struct cf_om_node *root, const char *fullkey); int cf_om_set(struct cf_om_node **nodep, const char *fullkey, const char *text); int cf_om_add_child(struct cf_om_node **const parentp, const char *const key); int cf_om_remove_null_child(struct cf_om_node **parentp, unsigned n); int cf_om_remove_empty_child(struct cf_om_node **parentp, unsigned n); void cf_om_remove_child(struct cf_om_node **parent, unsigned n); void cf_om_free_node(struct cf_om_node **nodep); void cf_om_dump_node(const struct cf_om_node *node, int indent); int cf_om_match(const char *pattern, const struct cf_om_node *node); struct cf_om_iterator { const struct cf_om_node *node; unsigned sp; struct { const struct cf_om_node *node; unsigned index; } stack[20]; }; void cf_om_iter_start(struct cf_om_iterator *, const struct cf_om_node *); int cf_om_iter_next(struct cf_om_iterator *); extern struct cf_om_node *cf_om_root; int cf_om_load(void); int cf_om_reload(void); int cf_om_save(void); /* Diagnostic functions for use in config schema parsing functions, cf_opt_xxx(). */ void _cf_warn_nodev(struct __sourceloc __whence, const struct cf_om_node *node, const char *key, const char *fmt, va_list ap); void _cf_warn_childrenv(struct __sourceloc __whence, const struct cf_om_node *parent, const char *fmt, va_list ap); void _cf_warn_node(struct __sourceloc __whence, const struct cf_om_node *node, const char *key, const char *fmt, ...); void _cf_warn_children(struct __sourceloc __whence, const struct cf_om_node *node, const char *fmt, ...); void _cf_warn_duplicate_node(struct __sourceloc __whence, const struct cf_om_node *parent, const char *key); void _cf_warn_missing_node(struct __sourceloc __whence, const struct cf_om_node *parent, const char *key); void _cf_warn_node_value(struct __sourceloc __whence, const struct cf_om_node *node, int reason); void _cf_warn_no_array(struct __sourceloc __whence, const struct cf_om_node *node, int reason); void _cf_warn_unsupported_node(struct __sourceloc __whence, const struct cf_om_node *node); void _cf_warn_unsupported_children(struct __sourceloc __whence, const struct cf_om_node *parent); void _cf_warn_list_overflow(struct __sourceloc __whence, const struct cf_om_node *node, const char *fmt, ...); void _cf_warn_incompatible(struct __sourceloc __whence, const struct cf_om_node *node, const struct cf_om_node *orig); void _cf_warn_incompatible_children(struct __sourceloc __whence, const struct cf_om_node *parent); void _cf_warn_array_key(struct __sourceloc __whence, const struct cf_om_node *node, int reason); void _cf_warn_array_value(struct __sourceloc __whence, const struct cf_om_node *node, int reason); #define cf_warn_nodev(node, key, fmt, ap) _cf_warn_nodev(__WHENCE__, node, key, fmt, ap) #define cf_warn_childrenv(parent, fmt, ap) _cf_warn_childrenv(__WHENCE__, parent, fmt, ap) #define cf_warn_node(node, key, fmt, ...) _cf_warn_node(__WHENCE__, node, key, fmt, ##__VA_ARGS__) #define cf_warn_children(node, fmt, ...) _cf_warn_children(__WHENCE__, node, fmt, ##__VA_ARGS__) #define cf_warn_duplicate_node(parent, key) _cf_warn_duplicate_node(__WHENCE__, parent, key) #define cf_warn_missing_node(parent, key) _cf_warn_missing_node(__WHENCE__, parent, key) #define cf_warn_node_value(node, reason) _cf_warn_node_value(__WHENCE__, node, reason) #define cf_warn_no_array(node, reason) _cf_warn_no_array(__WHENCE__, node, reason) #define cf_warn_unsupported_node(node) _cf_warn_unsupported_node(__WHENCE__, node) #define cf_warn_unsupported_children(parent) _cf_warn_unsupported_children(__WHENCE__, parent) #define cf_warn_list_overflow(node, fmt, ...) _cf_warn_list_overflow(__WHENCE__, node, fmt, ##__VA_ARGS__) #define cf_warn_incompatible(node, orig) _cf_warn_incompatible(__WHENCE__, node, orig) #define cf_warn_incompatible_children(parent) _cf_warn_incompatible_children(__WHENCE__, parent) #define cf_warn_array_key(node, reason) _cf_warn_array_key(__WHENCE__, node, reason) #define cf_warn_array_value(node, reason) _cf_warn_array_value(__WHENCE__, node, reason) struct pattern_list { unsigned patc; char patv[16][INTERFACE_NAME_STRLEN + 1]; }; #define PATTERN_LIST_EMPTY ((struct pattern_list){.patc = 0}) // Generate config struct definitions, struct config_NAME. #define STRUCT(__name, __validators...) \ struct config_##__name { #define NODE(__type, __element, __default, __repr, __flags, __comment) \ __type __element; #define ATOM(__type, __element, __default, __repr, __flags, __comment) \ __type __element; #define STRING(__size, __element, __default, __repr, __flags, __comment) \ char __element[__size + 1]; #define SUB_STRUCT(__name, __element, __flags, __dfllabel...) \ struct config_##__name __element; #define NODE_STRUCT(__name, __element, __repr, __flags, __dfllabel...) \ struct config_##__name __element; #define END_STRUCT \ }; #define STRUCT_ASSIGN(__substructname, __structname) \ struct __cf_unused_##__LINE__ { #define END_STRUCT_ASSIGN \ }; #define STRUCT_DEFAULT(__name, __dfllabel) #define ATOM_DEFAULT(__element, __default) #define STRING_DEFAULT(__element, __default) #define SUB_STRUCT_DEFAULT(__name, __element, __dfllabel...) #define END_STRUCT_DEFAULT #define ARRAY(__name, __flags, __validators...) \ struct config_##__name { \ unsigned ac; \ struct config_##__name##__element { #define KEY_ATOM(__type, __keyrepr) \ __type key; // key must be first element in struct #define KEY_STRING(__strsize, __keyrepr) \ char key[(__strsize) + 1]; // key must be first element in struct #define VALUE_ATOM(__type, __eltrepr) \ __type value; #define VALUE_STRING(__strsize, __eltrepr) \ char value[(__strsize) + 1]; #define VALUE_NODE(__type, __eltrepr) \ __type value; #define VALUE_SUB_STRUCT(__structname, __dfllabel...) \ struct config_##__structname value; #define VALUE_NODE_STRUCT(__structname, __eltrepr) \ struct config_##__structname value; #define END_ARRAY(__size) \ } av[(__size)]; \ }; #include "conf_schema.h" #undef STRUCT #undef NODE #undef ATOM #undef STRING #undef SUB_STRUCT #undef NODE_STRUCT #undef END_STRUCT #undef STRUCT_ASSIGN #undef END_STRUCT_ASSIGN #undef STRUCT_DEFAULT #undef ATOM_DEFAULT #undef STRING_DEFAULT #undef SUB_STRUCT_DEFAULT #undef END_STRUCT_DEFAULT #undef ARRAY #undef KEY_ATOM #undef KEY_STRING #undef VALUE_ATOM #undef VALUE_STRING #undef VALUE_NODE #undef VALUE_SUB_STRUCT #undef VALUE_NODE_STRUCT #undef END_ARRAY // Generate config function prototypes, cf_dfl_config_NAME(), cf_sch_config_NAME(), cf_cpy_config_NAME(). #define STRUCT(__name, __validators...) \ int cf_dfl_config_##__name(struct config_##__name *); \ int cf_dfl_config_##__name##_cf_(struct config_##__name *); \ int cf_sch_config_##__name(struct cf_om_node **parentp); #define NODE(__type, __element, __default, __repr, __flags, __comment) #define ATOM(__type, __element, __default, __repr, __flags, __comment) #define STRING(__size, __element, __default, __repr, __flags, __comment) #define SUB_STRUCT(__name, __element, __flags, __dfllabel...) \ int cf_dfl_config_##__name##_cf_##__dfllabel(struct config_##__name *); #define NODE_STRUCT(__name, __element, __repr, __flags, __dfllabel...) \ int cf_dfl_config_##__name##_cf_##__dfllabel(struct config_##__name *); #define END_STRUCT #define STRUCT_ASSIGN(__substructname, __structname) \ void cf_cpy_config_##__substructname(struct config_##__substructname *, const struct config_##__structname *); #define END_STRUCT_ASSIGN #define STRUCT_DEFAULT(__name, __dfllabel) \ int cf_dfl_config_##__name##_cf_##__dfllabel(struct config_##__name *); #define ATOM_DEFAULT(__element, __default) #define STRING_DEFAULT(__element, __default) #define SUB_STRUCT_DEFAULT(__name, __element, __dfllabel...) #define END_STRUCT_DEFAULT #define ARRAY(__name, __flags, __validators...) \ int cf_dfl_config_##__name(struct config_##__name *); \ int cf_sch_config_##__name(struct cf_om_node **parentp); #define KEY_ATOM(__type, __keyrepr) #define KEY_STRING(__strsize, __keyrepr) #define VALUE_ATOM(__type, __eltrepr) #define VALUE_STRING(__strsize, __eltrepr) #define VALUE_NODE(__type, __eltrepr) #define VALUE_SUB_STRUCT(__structname, __dfllabel...) #define VALUE_NODE_STRUCT(__structname, __eltrepr) #define END_ARRAY(__size) #include "conf_schema.h" #undef STRUCT #undef NODE #undef ATOM #undef STRING #undef SUB_STRUCT #undef NODE_STRUCT #undef END_STRUCT #undef STRUCT_ASSIGN #undef END_STRUCT_ASSIGN #undef STRUCT_DEFAULT #undef ATOM_DEFAULT #undef STRING_DEFAULT #undef SUB_STRUCT_DEFAULT #undef END_STRUCT_DEFAULT #undef ARRAY #undef KEY_ATOM #undef KEY_STRING #undef VALUE_ATOM #undef VALUE_STRING #undef VALUE_NODE #undef VALUE_SUB_STRUCT #undef VALUE_NODE_STRUCT #undef END_ARRAY // Generate config parser function prototypes: cf_opt_REPR(), cf_fmt_REPR(), cf_cmp_REPR() #define VALIDATOR(__validator...) \ , __validator #define __VALIDATOR(__name, __validators...) \ typedef int __validator_func__config_##__name##__t(const struct cf_om_node *, struct config_##__name *, int); \ __validator_func__config_##__name##__t __dummy__validator_func__config_##__name __validators; #define STRUCT(__name, __validators...) \ int cf_opt_config_##__name(struct config_##__name *, const struct cf_om_node *); \ int cf_fmt_config_##__name(struct cf_om_node **, const struct config_##__name *); \ int cf_xfmt_config_##__name(struct cf_om_node **, const struct config_##__name *, const struct config_##__name *); \ int cf_cmp_config_##__name(const struct config_##__name *, const struct config_##__name *); \ __VALIDATOR(__name, ##__validators) #define NODE(__type, __element, __default, __repr, __flags, __comment) \ int cf_opt_##__repr(__type *, const struct cf_om_node *); \ int cf_fmt_##__repr(struct cf_om_node **, const __type *); \ int cf_cmp_##__repr(const __type *, const __type *); #define ATOM(__type, __element, __default, __repr, __flags, __comment) \ int cf_opt_##__repr(__type *, const char *); \ int cf_fmt_##__repr(const char **, const __type *); \ int cf_cmp_##__repr(const __type *, const __type *); #define STRING(__size, __element, __default, __repr, __flags, __comment) \ int cf_opt_##__repr(char *, size_t, const char *); \ int cf_fmt_##__repr(const char **, const char *); \ int cf_cmp_##__repr(const char *, const char *); #define SUB_STRUCT(__structname, __element, __flags, __dfllabel...) \ int cf_opt_config_##__structname(struct config_##__structname *, const struct cf_om_node *); \ int cf_fmt_config_##__structname(struct cf_om_node **, const struct config_##__structname *); \ int cf_xfmt_config_##__structname(struct cf_om_node **, const struct config_##__structname *, const struct config_##__structname *); \ int cf_cmp_config_##__structname(const struct config_##__structname *, const struct config_##__structname *); #define NODE_STRUCT(__structname, __element, __repr, __flags, __dfllabel...) \ SUB_STRUCT(__structname, __element, __flags, ##__dfllabel) \ int cf_opt_##__repr(struct config_##__structname *, const struct cf_om_node *); \ int cf_fmt_##__repr(struct cf_om_node **, const struct config_##__structname *); \ int cf_cmp_##__repr(const struct config_##__structname *, const struct config_##__structname *); #define END_STRUCT #define STRUCT_ASSIGN(__substructname, __structname) #define END_STRUCT_ASSIGN #define STRUCT_DEFAULT(__name, __dfllabel) #define ATOM_DEFAULT(__element, __default) #define STRING_DEFAULT(__element, __default) #define SUB_STRUCT_DEFAULT(__name, __element, __dfllabel...) #define END_STRUCT_DEFAULT #define ARRAY(__name, __flags, __validators...) \ int cf_opt_config_##__name(struct config_##__name *, const struct cf_om_node *); \ int cf_fmt_config_##__name(struct cf_om_node **, const struct config_##__name *); \ int cf_xfmt_config_##__name(struct cf_om_node **, const struct config_##__name *, const struct config_##__name *); \ int cf_cmp_config_##__name(const struct config_##__name *, const struct config_##__name *); \ __VALIDATOR(__name, ##__validators) #define KEY_ATOM(__type, __keyrepr) \ int cf_opt_##__keyrepr(__type *, const char *); \ int cf_fmt_##__keyrepr(const char **, const __type *); \ int cf_cmp_##__keyrepr(const __type *, const __type *); #define KEY_STRING(__strsize, __keyrepr) \ int cf_opt_##__keyrepr(char *, size_t, const char *); \ int cf_fmt_##__keyrepr(const char **, const char *); \ int cf_cmp_##__keyrepr(const char *, const char *); #define VALUE_ATOM(__type, __eltrepr) \ int cf_opt_##__eltrepr(__type *, const char *); \ int cf_fmt_##__eltrepr(const char **, const __type *); \ int cf_cmp_##__eltrepr(const __type *, const __type *); #define VALUE_STRING(__strsize, __eltrepr) \ int cf_opt_##__eltrepr(char *, size_t, const char *); \ int cf_fmt_##__eltrepr(const char **, const char *); \ int cf_cmp_##__eltrepr(const char *, const char *); #define VALUE_NODE(__type, __eltrepr) \ int cf_opt_##__eltrepr(__type *, const struct cf_om_node *); \ int cf_fmt_##__eltrepr(struct cf_om_node **, const __type *); \ int cf_cmp_##__eltrepr(const __type *, const __type *); #define VALUE_SUB_STRUCT(__structname, __dfllabel...) \ int cf_opt_config_##__structname(struct config_##__structname *, const struct cf_om_node *); \ int cf_fmt_config_##__structname(struct cf_om_node **, const struct config_##__structname *); \ int cf_xfmt_config_##__structname(struct cf_om_node **, const struct config_##__structname *, const struct config_##__structname *); \ int cf_cmp_config_##__structname(const struct config_##__structname *, const struct config_##__structname *); #define VALUE_NODE_STRUCT(__structname, __repr) \ VALUE_SUB_STRUCT(__structname) \ int cf_opt_##__repr(struct config_##__structname *, const struct cf_om_node *); \ int cf_fmt_##__repr(struct cf_om_node **, const struct config_##__structname *); \ int cf_cmp_##__repr(const struct config_##__structname *, const struct config_##__structname *); #define END_ARRAY(__size) #include "conf_schema.h" #undef __VALIDATOR #undef VALIDATOR #undef STRUCT #undef NODE #undef ATOM #undef STRING #undef SUB_STRUCT #undef NODE_STRUCT #undef END_STRUCT #undef STRUCT_ASSIGN #undef END_STRUCT_ASSIGN #undef STRUCT_DEFAULT #undef ATOM_DEFAULT #undef STRING_DEFAULT #undef SUB_STRUCT_DEFAULT #undef END_STRUCT_DEFAULT #undef ARRAY #undef KEY_ATOM #undef KEY_STRING #undef VALUE_ATOM #undef VALUE_STRING #undef VALUE_NODE #undef VALUE_SUB_STRUCT #undef VALUE_NODE_STRUCT #undef END_ARRAY // Generate config array search-by-key function prototypes. #define VALIDATOR(__validator...) #define STRUCT(__name, __validators...) #define NODE(__type, __element, __default, __repr, __flags, __comment) #define ATOM(__type, __element, __default, __repr, __flags, __comment) #define STRING(__size, __element, __default, __repr, __flags, __comment) #define SUB_STRUCT(__name, __element, __flags, __dfllabel...) #define NODE_STRUCT(__name, __element, __repr, __flags, __dfllabel...) #define END_STRUCT #define STRUCT_ASSIGN(__substructname, __structname) #define END_STRUCT_ASSIGN #define STRUCT_DEFAULT(__name, __dfllabel) #define ATOM_DEFAULT(__element, __default) #define STRING_DEFAULT(__element, __default) #define SUB_STRUCT_DEFAULT(__name, __element, __dfllabel...) #define END_STRUCT_DEFAULT #define ARRAY(__name, __flags, __validators...) \ int config_##__name##__get(const struct config_##__name *, #define KEY_ATOM(__type, __keyrepr) \ const __type *); #define KEY_STRING(__strsize, __keyrepr) \ const char *); #define VALUE_ATOM(__type, __eltrepr) #define VALUE_STRING(__strsize, __eltrepr) #define VALUE_NODE(__type, __eltrepr) #define VALUE_SUB_STRUCT(__structname, __dfllabel...) #define VALUE_NODE_STRUCT(__structname, __eltrepr) #define END_ARRAY(__size) #include "conf_schema.h" #undef VALIDATOR #undef STRUCT #undef NODE #undef ATOM #undef STRING #undef SUB_STRUCT #undef NODE_STRUCT #undef END_STRUCT #undef STRUCT_ASSIGN #undef END_STRUCT_ASSIGN #undef STRUCT_DEFAULT #undef ATOM_DEFAULT #undef STRING_DEFAULT #undef SUB_STRUCT_DEFAULT #undef END_STRUCT_DEFAULT #undef ARRAY #undef KEY_ATOM #undef KEY_STRING #undef VALUE_ATOM #undef VALUE_STRING #undef VALUE_NODE #undef VALUE_SUB_STRUCT #undef VALUE_NODE_STRUCT #undef END_ARRAY int cf_opt_boolean(bool_t *booleanp, const char *text); int cf_fmt_boolean(const char **, const bool_t *booleanp); int cf_opt_absolute_path(char *str, size_t len, const char *text); int cf_fmt_absolute_path(const char **, const char *path); int cf_opt_rhizome_peer(struct config_rhizome_peer *, const struct cf_om_node *node); int cf_fmt_rhizome_peer(struct cf_om_node **, const struct config_rhizome_peer *); int cf_opt_rhizome_peer_from_uri(struct config_rhizome_peer *, const char *uri); int cf_opt_str(char *str, size_t len, const char *text); int cf_fmt_str(const char **, const char *str); int cf_opt_str_nonempty(char *str, size_t len, const char *text); int cf_fmt_str_nonempty(const char **, const char *str); int cf_opt_int(int *intp, const char *text); int cf_fmt_int(const char **, const int *intp); int cf_opt_uint16(uint16_t *intp, const char *text); int cf_fmt_int16(const char **, const int16_t *intp); int cf_opt_uint16_nonzero(uint16_t *intp, const char *text); int cf_fmt_int16_nonzero(const char **, const uint16_t *intp); int cf_opt_int32_nonneg(int32_t *intp, const char *text); int cf_fmt_int32_nonneg(const char **, const int32_t *intp); int cf_opt_uint32_nonzero(uint32_t *intp, const char *text); int cf_fmt_uint32_nonzero(const char **, const uint32_t *intp); int cf_opt_uint32_scaled(uint32_t *intp, const char *text); int cf_fmt_uint32_scaled(const char **, const uint32_t *intp); int cf_opt_uint64_scaled(uint64_t *intp, const char *text); int cf_fmt_uint64_scaled(const char **, const uint64_t *intp); int cf_opt_protocol(char *str, size_t len, const char *text); int cf_fmt_protocol(const char **, const char *str); int cf_opt_in_addr(struct in_addr *addrp, const char *text); int cf_fmt_in_addr(const char **, const struct in_addr *addrp); int cf_opt_sid(sid_t *sidp, const char *text); int cf_fmt_sid(const char **, const sid_t *sidp); int cf_opt_rhizome_bk(rhizome_bk_t *bkp, const char *text); int cf_fmt_rhizome_bk(const char **, const rhizome_bk_t *bkp); int cf_opt_interface_type(short *typep, const char *text); int cf_fmt_interface_type(const char **, const short *typep); int cf_opt_pattern_list(struct pattern_list *listp, const char *text); int cf_fmt_pattern_list(const char **, const struct pattern_list *listp); int cf_opt_network_interface(struct config_network_interface *nifp, const struct cf_om_node *node); int cf_fmt_network_interface(struct cf_om_node **, const struct config_network_interface *nifp); int cf_opt_interface_list(struct config_interface_list *listp, const struct cf_om_node *node); int cf_fmt_interface_list(struct cf_om_node **, const struct config_interface_list *listp); int cf_opt_socket_type(short *typep, const char *text); int cf_fmt_socket_type(const char **, const short *typep); int cf_opt_encapsulation(short *encapp, const char *text); int cf_fmt_encapsulation(const char **, const short *encapp); extern int cf_limbo; extern __thread struct config_main config; #define IF_DEBUG(flagname) (config.debug.flagname) int cf_init(void); int cf_load(void); int cf_load_strict(void); int cf_load_permissive(void); int cf_reload(void); int cf_reload_strict(void); int cf_reload_permissive(void); void cf_on_config_change(void); #endif //__SERVAL_DNA__CONF_H