diff options
Diffstat (limited to 'src/lib-settings/settings.h')
-rw-r--r-- | src/lib-settings/settings.h | 73 |
1 files changed, 73 insertions, 0 deletions
diff --git a/src/lib-settings/settings.h b/src/lib-settings/settings.h new file mode 100644 index 0000000..888dfb0 --- /dev/null +++ b/src/lib-settings/settings.h @@ -0,0 +1,73 @@ +#ifndef SETTINGS_H +#define SETTINGS_H + +/* + * Note: + * + * The definitions in this file are used for parsing of external config + * files and *not* for parsing of dovecot.conf. Unfortunately, the types + * here (e.g., enum settings_type) collide with those in settings-parser.h. + * + * We should remove the need for this file in v3.0. + */ + +enum setting_type { + SET_STR, + SET_INT, + SET_BOOL +}; + +struct setting_def { + enum setting_type type; + const char *name; + size_t offset; +}; + +#define DEF_STRUCT_STR(name, struct_name) \ + { SET_STR + COMPILE_ERROR_IF_TYPES_NOT_COMPATIBLE( \ + ((struct struct_name *)0)->name, const char *), \ + #name, offsetof(struct struct_name, name) } +#define DEF_STRUCT_INT(name, struct_name) \ + { SET_INT + COMPILE_ERROR_IF_TYPES_NOT_COMPATIBLE( \ + ((struct struct_name *)0)->name, unsigned int), \ + #name, offsetof(struct struct_name, name) } +#define DEF_STRUCT_BOOL(name, struct_name) \ + { SET_BOOL + COMPILE_ERROR_IF_TYPES_NOT_COMPATIBLE( \ + ((struct struct_name *)0)->name, bool), \ + #name, offsetof(struct struct_name, name) } + +/* Return error message. When closing section, key = NULL, value = NULL. */ +typedef const char *settings_callback_t(const char *key, const char *value, + void *context); + +/* Return TRUE if we want to go inside the section */ +typedef bool settings_section_callback_t(const char *type, const char *name, + void *context, const char **errormsg); + +extern settings_section_callback_t *null_settings_section_callback; + +const char * +parse_setting_from_defs(pool_t pool, const struct setting_def *defs, void *base, + const char *key, const char *value); + +bool settings_read_i(const char *path, const char *section, + settings_callback_t *callback, + settings_section_callback_t *sect_callback, void *context, + const char **error_r) + ATTR_NULL(2, 4, 5); +#define settings_read(path, section, callback, sect_callback, context, error_r) \ + settings_read_i(path - \ + CALLBACK_TYPECHECK(callback, const char *(*)( \ + const char *, const char *, typeof(context))) - \ + CALLBACK_TYPECHECK(sect_callback, bool (*)( \ + const char *, const char *, typeof(context), \ + const char **)), \ + section, (settings_callback_t *)callback, \ + (settings_section_callback_t *)sect_callback, context, error_r) +#define settings_read_nosection(path, callback, context, error_r) \ + settings_read_i(path - \ + CALLBACK_TYPECHECK(callback, const char *(*)( \ + const char *, const char *, typeof(context))), \ + NULL, (settings_callback_t *)callback, NULL, context, error_r) + +#endif |