/
niceSOFT
/
dovecot
Обзор
Документация
Войти
/
niceSOFT
/
dovecot
Код
Задачи
Вики
Пакеты
0
Релизы
0
Аналитика
Безопасность
main
src/lib-settings/settings-parser.h
336 строк
15 KB
Marco Bettini
lib-settings: Extract settings-consts.h
18 фев 2026, 10:37
18 фев 2026, 10:37
d7c9171
Код
Авторство
О чём код?
#ifndef SETTINGS_PARSER_H #define SETTINGS_PARSER_H #include "str-parse.h" #include "settings-consts.h" struct stat; struct var_expand_table; struct var_expand_provider; #define SETTINGS_SEPARATOR '/' #define SETTINGS_SEPARATOR_S "/" #define SETTINGS_FILTER_ARRAY_SEPARATORS ",\t " #define SET_LIST_APPEND "+" #define SET_LIST_REPLACE "$" #define SET_LIST_CLEAR "." #define SET_FILE_INLINE_PREFIX "inline:" enum setting_type { SET_BOOL, SET_UINTMAX, SET_UINT, SET_UINT_OCT, SET_TIME, SET_TIME_MSECS, SET_SIZE, SET_IN_PORT, /* internet port */ SET_STR, /* string with %variables */ SET_STR_NOVARS, /* string explicitly without %variables */ SET_ENUM, SET_FILE, /* string: <path> [<LF> file contents] */ SET_STRLIST, /* of type ARRAY_TYPE(const_string) */ SET_BOOLLIST, /* of type ARRAY_TYPE(const_string) - guaranteed NULL-terminated */ SET_ALIAS, /* alias name for above setting definition */ SET_FILTER_NAME, SET_FILTER_ARRAY, }; enum setting_flags { SET_FLAG_HIDDEN = BIT(0), /* Used only for SETTING_DEFINE_LIST_END */ SET_FLAG_EOL = BIT(1), /* Setting is normalized as Unicode Normalization Form C (NFC) */ SET_FLAG_UNICODE_NFC = BIT(2), }; enum setting_apply_flags { /* Used when applying override settings (e.g. userdb or -o parameter) */ SETTING_APPLY_FLAG_OVERRIDE = BIT(0), /* SETTINGS_GET_FLAG_NO_EXPAND is being used. */ SETTING_APPLY_FLAG_NO_EXPAND = BIT(1), }; #define SETTING_DEFINE_LIST_END { 0, SET_FLAG_EOL, NULL, 0, NULL, NULL, NULL } struct setting_filter_array_order { const struct setting_parser_info *info; const char *field_name; bool reverse; }; struct setting_define { enum setting_type type; enum setting_flags flags; const char *key; size_t offset; const char *filter_array_field_name; const struct setting_filter_array_order *filter_array_order; const char *required_setting; }; #define SETTING_DEFINE_STRUCT_TYPE(_enum_type, _flags, _c_type, _key, _name, _struct_name) \ { .type = (_enum_type) + COMPILE_ERROR_IF_TYPES_NOT_COMPATIBLE( \ ((_struct_name *)0)->_name, _c_type), \ .flags = _flags, .key = _key, \ .offset = offsetof(_struct_name, _name) } #define SETTING_DEFINE_STRUCT_BOOL(key, name, struct_name) \ SETTING_DEFINE_STRUCT_TYPE(SET_BOOL, 0, bool, key, name, struct_name) #define SETTING_DEFINE_STRUCT_UINTMAX(key, name, struct_name) \ SETTING_DEFINE_STRUCT_TYPE(SET_UINTMAX, 0, uintmax_t, key, name, struct_name) #define SETTING_DEFINE_STRUCT_UINT(key, name, struct_name) \ SETTING_DEFINE_STRUCT_TYPE(SET_UINT, 0, unsigned int, key, name, struct_name) #define SETTING_DEFINE_STRUCT_UINT_OCT(key, name, struct_name) \ SETTING_DEFINE_STRUCT_TYPE(SET_UINT_OCT, 0, unsigned int, key, name, struct_name) #define SETTING_DEFINE_STRUCT_TIME(key, name, struct_name) \ SETTING_DEFINE_STRUCT_TYPE(SET_TIME, 0, unsigned int, key, name, struct_name) #define SETTING_DEFINE_STRUCT_TIME_MSECS(key, name, struct_name) \ SETTING_DEFINE_STRUCT_TYPE(SET_TIME_MSECS, 0, unsigned int, key, name, struct_name) #define SETTING_DEFINE_STRUCT_SIZE(key, name, struct_name) \ SETTING_DEFINE_STRUCT_TYPE(SET_SIZE, 0, uoff_t, key, name, struct_name) #define SETTING_DEFINE_STRUCT_IN_PORT(key, name, struct_name) \ SETTING_DEFINE_STRUCT_TYPE(SET_IN_PORT, 0, in_port_t, key, name, struct_name) #define SETTING_DEFINE_STRUCT_STR(key, name, struct_name) \ SETTING_DEFINE_STRUCT_TYPE(SET_STR, 0, const char *, key, name, struct_name) #define SETTING_DEFINE_STRUCT_STR_NOVARS(key, name, struct_name) \ SETTING_DEFINE_STRUCT_TYPE(SET_STR_NOVARS, 0, const char *, key, name, struct_name) #define SETTING_DEFINE_STRUCT_ENUM(key, name, struct_name) \ SETTING_DEFINE_STRUCT_TYPE(SET_ENUM, 0, const char *, key, name, struct_name) #define SETTING_DEFINE_STRUCT_FILE(key, name, struct_name) \ SETTING_DEFINE_STRUCT_TYPE(SET_FILE, 0, const char *, key, name, struct_name) #define SETTING_DEFINE_STRUCT_BOOLLIST(key, name, struct_name) \ SETTING_DEFINE_STRUCT_TYPE(SET_BOOLLIST, 0, ARRAY_TYPE(const_string), key, name, struct_name) #define SETTING_DEFINE_STRUCT_STRLIST(key, name, struct_name) \ SETTING_DEFINE_STRUCT_TYPE(SET_STRLIST, 0, ARRAY_TYPE(const_string), key, name, struct_name) #define SETTING_DEFINE_STRUCT_BOOL_HIDDEN(key, name, struct_name) \ SETTING_DEFINE_STRUCT_TYPE(SET_BOOL, SET_FLAG_HIDDEN, bool, key, name, struct_name) #define SETTING_DEFINE_STRUCT_UINTMAX_HIDDEN(key, name, struct_name) \ SETTING_DEFINE_STRUCT_TYPE(SET_UINTMAX, SET_FLAG_HIDDEN, uintmax_t, key, name, struct_name) #define SETTING_DEFINE_STRUCT_UINT_HIDDEN(key, name, struct_name) \ SETTING_DEFINE_STRUCT_TYPE(SET_UINT, SET_FLAG_HIDDEN, unsigned int, key, name, struct_name) #define SETTING_DEFINE_STRUCT_UINT_OCT_HIDDEN(key, name, struct_name) \ SETTING_DEFINE_STRUCT_TYPE(SET_UINT_OCT, SET_FLAG_HIDDEN, unsigned int, key, name, struct_name) #define SETTING_DEFINE_STRUCT_TIME_HIDDEN(key, name, struct_name) \ SETTING_DEFINE_STRUCT_TYPE(SET_TIME, SET_FLAG_HIDDEN, unsigned int, key, name, struct_name) #define SETTING_DEFINE_STRUCT_TIME_MSECS_HIDDEN(key, name, struct_name) \ SETTING_DEFINE_STRUCT_TYPE(SET_TIME_MSECS, SET_FLAG_HIDDEN, unsigned int, key, name, struct_name) #define SETTING_DEFINE_STRUCT_SIZE_HIDDEN(key, name, struct_name) \ SETTING_DEFINE_STRUCT_TYPE(SET_SIZE, SET_FLAG_HIDDEN, uoff_t, key, name, struct_name) #define SETTING_DEFINE_STRUCT_IN_PORT_HIDDEN(key, name, struct_name) \ SETTING_DEFINE_STRUCT_TYPE(SET_IN_PORT, SET_FLAG_HIDDEN, in_port_t, key, name, struct_name) #define SETTING_DEFINE_STRUCT_STR_HIDDEN(key, name, struct_name) \ SETTING_DEFINE_STRUCT_TYPE(SET_STR, SET_FLAG_HIDDEN, const char *, key, name, struct_name) #define SETTING_DEFINE_STRUCT_STR_NOVARS_HIDDEN(key, name, struct_name) \ SETTING_DEFINE_STRUCT_TYPE(SET_STR_NOVARS, SET_FLAG_HIDDEN, const char *, key, name, struct_name) #define SETTING_DEFINE_STRUCT_ENUM_HIDDEN(key, name, struct_name) \ SETTING_DEFINE_STRUCT_TYPE(SET_ENUM, SET_FLAG_HIDDEN, const char *, key, name, struct_name) #define SETTING_DEFINE_STRUCT_FILE_HIDDEN(key, name, struct_name) \ SETTING_DEFINE_STRUCT_TYPE(SET_FILE, SET_FLAG_HIDDEN, const char *, key, name, struct_name) #define SETTING_DEFINE_STRUCT_BOOLLIST_HIDDEN(key, name, struct_name) \ SETTING_DEFINE_STRUCT_TYPE(SET_BOOLLIST, SET_FLAG_HIDDEN, ARRAY_TYPE(const_string), key, name, struct_name) #define SETTING_DEFINE_STRUCT_STRLIST_HIDDEN(key, name, struct_name) \ SETTING_DEFINE_STRUCT_TYPE(SET_STRLIST, SET_FLAG_HIDDEN, ARRAY_TYPE(const_string), key, name, struct_name) #define SETTING_DEFINE_STRUCT_STR_NFC(key, name, struct_name) \ SETTING_DEFINE_STRUCT_TYPE(SET_STR, SET_FLAG_UNICODE_NFC, const char *, key, name, struct_name) #define SETTING_DEFINE_STRUCT_STR_NFC_NOVARS(key, name, struct_name) \ SETTING_DEFINE_STRUCT_TYPE(SET_STR_NOVARS, SET_FLAG_UNICODE_NFC, const char *, key, name, struct_name) struct settings_file { /* Path to the file. May be "" if the content is inlined. */ const char *path; /* File contents - always available. NULs inside the file are not supported. */ const char *content; }; struct setting_keyvalue { const char *key; const char *value; }; struct setting_parser_info { /* Unique name for the settings struct */ const char *name; /* If non-NULL, config process verifies whether this plugin actually exists on filesystem before exposing these settings. This allows for example the plugins in Dovecot core to be extracted into separate optional packages, even though they don't have individual settings plugins. */ const char *plugin_dependency; const struct setting_define *defines; const void *defaults; /* Add defaults via strings on top of the of defaults struct. */ const struct setting_keyvalue *default_settings; size_t struct_size; size_t pool_offset1; /* 1 + offset to pool_t field */ /* This is called for every setting that is parsed. *value is already the final pointer stored into the settings struct. If it's modified, it should usually be allocated from set->pool. */ bool (*setting_apply)(struct event *event, void *set, const char *key, const char **value, enum setting_apply_flags flags, const char **error_r); /* This is called after %variable expansion. */ bool (*check_func)(void *set, pool_t pool, const char **error_r); /* The event parameter can be used with settings_get*() to access other settings structs. */ bool (*ext_check_func)(struct event *event, void *set, pool_t pool, const char **error_r); }; ARRAY_DEFINE_TYPE(setting_parser_info, struct setting_parser_info); enum settings_parser_flags { SETTINGS_PARSER_FLAG_IGNORE_UNKNOWN_KEYS = 0x01, /* Filters are added in reverse order. New filters are inserted to the beginning of the array. */ SETTINGS_PARSER_FLAG_INSERT_FILTERS = 0x04, }; enum settings_binary { SETTINGS_BINARY_OTHER, SETTINGS_BINARY_CONFIG, SETTINGS_BINARY_DOVECONF }; struct setting_parser_context; /* If a string setting value has this pointer, it means the setting isn't actually known because it contained %{variables}. [ext_]check_func() can use this to not give early errors when the variable value isn't known. */ extern const char *set_value_unknown; /* This is set for ext_check_func(event) when config binary checking settings. In this case for example %variables aren't expanded, so ext_check_func() shouldn't fail if it does further settings_get*() calls that fail. */ #define SETTINGS_EVENT_NO_EXPAND "settings_event_no_expand" struct setting_parser_context * settings_parser_init(pool_t set_pool, const struct setting_parser_info *root, enum settings_parser_flags flags); void settings_parser_ref(struct setting_parser_context *ctx); void settings_parser_unref(struct setting_parser_context **ctx); /* Returns number of defines in info->defines */ unsigned int setting_parser_info_get_define_count(const struct setting_parser_info *info); /* Find a specific key from info and return its index number in the defines array. "list/key" will return the list's define. If the key is an alias, the primary key's index is returned. */ bool setting_parser_info_find_key(const struct setting_parser_info *info, const char *key, unsigned int *idx_r); /* Returns the current settings. */ void *settings_parser_get_set(const struct setting_parser_context *ctx); /* Return the last error. */ const char *settings_parser_get_error(struct setting_parser_context *ctx); /* Returns pointer to value for a key, or NULL if not found. */ const void * settings_parse_get_value(struct setting_parser_context *ctx, const char **key, enum setting_type *type_r); /* Parse key/value pair. Returns 1 if OK, 0 if key is unknown, -1 if error. */ int settings_parse_keyvalue(struct setting_parser_context *ctx, const char *key, const char *value); /* Parse key index/value pair. The key_idx points to the key in info->defines[]. The key string is still needed to support lists, which need the key in "list/key" format. Returns 0 if OK, -1 if error. */ int settings_parse_keyidx_value(struct setting_parser_context *ctx, unsigned int key_idx, const char *key, const char *value); /* Same as settings_parse_keyvalue(), but don't strdup() the value. The value pointer's validity must be enforced by the caller. */ int settings_parse_keyvalue_nodup(struct setting_parser_context *ctx, const char *key, const char *value); /* Same as settings_parse_keyidx_value(), but don't strdup() the value. The value pointer's validity must be enforced by the caller. */ int settings_parse_keyidx_value_nodup(struct setting_parser_context *ctx, unsigned int key_idx, const char *key, const char *value); /* Ignore any further attempts to add to the named list filter or boollist. */ void settings_parse_array_stop(struct setting_parser_context *ctx, unsigned int key_idx); /* Returns TRUE if list has the specific key. The key must NOT include the list/ prefix. */ bool settings_parse_list_has_key(struct setting_parser_context *ctx, unsigned int key_idx, const char *key_suffix); /* Call all check_func()s and ext_check_func()s to see if currently parsed settings are valid. */ bool settings_parser_check(struct setting_parser_context *ctx, pool_t pool, struct event *event, const char **error_r); bool settings_check(struct event *event, const struct setting_parser_info *info, pool_t pool, void *set, const char **error_r); /* Read a SET_FILE from the given path and write "<prefix><value_path>\n<contents>" to output_r. Returns 0 on success, -1 on error. */ int settings_parse_read_file(const char *path, const char *value_path, pool_t pool, struct stat *st_r, const char *prefix, const char **output_r, const char **error_r); int settings_parse_boollist_string(const char *value, pool_t pool, ARRAY_TYPE(const_string) *dest, const char **error_r); /* Returns the boollist array NULL-terminated. The list is actually always already NULL-terminated, but to avoid confusion with regular non-NULL terminated arrays, use this function instead. Also, it includes some sanity checks to try to make sure it's used only for boollists. */ const char *const *settings_boollist_get(const ARRAY_TYPE(const_string) *array); /* Finish array into a boollist type by adding NULL-termination and optional stop flag. If stop=TRUE, this indicates that the boollist replaces the full list instead of adding to it. The boollist can still be updated afterwards, as long as this function is called again after modifications. */ void settings_boollist_finish(ARRAY_TYPE(const_string) *array, bool stop); /* Checks if boollist is marked as replacing the full list */ bool settings_boollist_is_stopped(const ARRAY_TYPE(const_string) *array); /* Split the settings value into path and content. The path is allocated from the path_pool, while content points directly to the value string. */ void settings_file_get(const char *value, pool_t path_pool, struct settings_file *file_r); /* Returns TRUE if the settings value contains a non-empty path. The value is expected to be in the SET_FILE format (path LF content). */ bool settings_file_has_path(const char *value); /* Convert settings_file into a value (path LF content). The file path may be NULL, but the content must exist. */ const char *settings_file_get_value(pool_t pool, const struct settings_file *file); /* Return hash of all the settings, except the specified fields (NULL = no exceptions). */ unsigned int settings_hash(const struct setting_parser_info *info, const void *set, const char *const *except_fields); /* Returns TRUE if the two settings structs are equal, except for the specified fields (NULL = no exceptions). */ bool settings_equal(const struct setting_parser_info *info, const void *set1, const void *set2, const char *const *except_fields); /* Allocate a new instance of a settings struct filled with the default settings. */ void *settings_defaults_dup(pool_t pool, const struct setting_parser_info *info); /* Return section name escaped */ const char *settings_section_escape(const char *name); const char *settings_section_unescape(const char *name); static inline bool settings_value_is_unlimited(const char *value) { /* allow both as input for all types */ return strcmp(value, SET_VALUE_UNLIMITED) == 0 || strcmp(value, SET_VALUE_INFINITE) == 0; } void settings_set_config_binary(enum settings_binary binary); enum settings_binary settings_get_config_binary(void); #endif