X-Git-Url: http://git.archive.openwrt.org/?p=project%2Fuci.git;a=blobdiff_plain;f=uci.h;h=36c8890dba0ce9fe86cf4eac8bc43f366720c927;hp=4fa0b6a44a7b74a846d48209bcdbca6d448ca98e;hb=6adc611deba4055154f8d990ef1a9a17e5fe821a;hpb=82db7b24855fbf5815d059c7cf6ab5f3f4ee44f0 diff --git a/uci.h b/uci.h index 4fa0b6a..36c8890 100644 --- a/uci.h +++ b/uci.h @@ -9,12 +9,16 @@ * 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. + * GNU Lesser General Public License for more details. */ #ifndef __LIBUCI_H #define __LIBUCI_H +#ifdef __cplusplus +extern "C" { +#endif + #include "uci_config.h" /* @@ -29,6 +33,7 @@ #include #include #include +#include #define UCI_CONFDIR "/etc/config" #define UCI_SAVEDIR "/tmp/.uci" @@ -56,15 +61,14 @@ struct uci_list }; struct uci_ptr; -struct uci_plugin; -struct uci_hook_ops; struct uci_element; struct uci_package; struct uci_section; struct uci_option; -struct uci_history; +struct uci_delta; struct uci_context; struct uci_backend; +struct uci_parse_option; struct uci_parse_context; @@ -104,7 +108,7 @@ extern void uci_get_errorstr(struct uci_context *ctx, char **dest, const char *s * @single: ignore the 'package' keyword and parse everything into a single package * * the name parameter is for config files that don't explicitly use the 'package <...>' keyword - * if 'package' points to a non-null struct pointer, enable history tracking and merge + * if 'package' points to a non-null struct pointer, enable delta tracking and merge */ extern int uci_import(struct uci_context *ctx, FILE *stream, const char *name, struct uci_package **package, bool single); @@ -141,7 +145,7 @@ extern int uci_unload(struct uci_context *ctx, struct uci_package *p); * @str: uci tuple string to look up * @extended: allow extended syntax lookup * - * if extended is set to true, uci_lookup_ptr supports the following + * if extended is set to true, uci_lookup_ptr supports the following * extended syntax: * * Examples: @@ -165,7 +169,7 @@ extern int uci_add_section(struct uci_context *ctx, struct uci_package *p, const /** * uci_set: Set an element's value; create the element if necessary * @ctx: uci context - * @ptr: uci pointer + * @ptr: uci pointer * * The updated/created element is stored in ptr->last */ @@ -182,6 +186,14 @@ extern int uci_set(struct uci_context *ctx, struct uci_ptr *ptr); extern int uci_add_list(struct uci_context *ctx, struct uci_ptr *ptr); /** + * uci_del_list: Remove a string from an element list + * @ctx: uci context + * @ptr: uci pointer (with value) + * + */ +extern int uci_del_list(struct uci_context *ctx, struct uci_ptr *ptr); + +/** * uci_reorder: Reposition a section * @ctx: uci context * @s: uci section to reposition @@ -199,12 +211,12 @@ extern int uci_rename(struct uci_context *ctx, struct uci_ptr *ptr); /** * uci_delete: Delete a section or option * @ctx: uci context - * @ptr: uci pointer + * @ptr: uci pointer */ extern int uci_delete(struct uci_context *ctx, struct uci_ptr *ptr); /** - * uci_save: save change history for a package + * uci_save: save change delta for a package * @ctx: uci context * @p: uci_package struct */ @@ -214,7 +226,7 @@ extern int uci_save(struct uci_context *ctx, struct uci_package *p); * uci_commit: commit changes to a package * @ctx: uci context * @p: uci_package struct pointer - * @overwrite: overwrite existing config data and flush history + * @overwrite: overwrite existing config data and flush delta * * committing may reload the whole uci_package data, * the supplied pointer is updated accordingly @@ -229,14 +241,14 @@ extern int uci_commit(struct uci_context *ctx, struct uci_package **p, bool over */ extern int uci_list_configs(struct uci_context *ctx, char ***list); -/** - * uci_set_savedir: override the default history save directory +/** + * uci_set_savedir: override the default delta save directory * @ctx: uci context * @dir: directory name */ extern int uci_set_savedir(struct uci_context *ctx, const char *dir); -/** +/** * uci_set_savedir: override the default config storage directory * @ctx: uci context * @dir: directory name @@ -244,14 +256,14 @@ extern int uci_set_savedir(struct uci_context *ctx, const char *dir); extern int uci_set_confdir(struct uci_context *ctx, const char *dir); /** - * uci_add_history_path: add a directory to the search path for change history files + * uci_add_delta_path: add a directory to the search path for change delta files * @ctx: uci context * @dir: directory name * * This function allows you to add directories, which contain 'overlays' * for the active config, that will never be committed. */ -extern int uci_add_history_path(struct uci_context *ctx, const char *dir); +extern int uci_add_delta_path(struct uci_context *ctx, const char *dir); /** * uci_revert: revert all changes to a config item @@ -287,56 +299,49 @@ extern int uci_set_backend(struct uci_context *ctx, const char *name); */ extern bool uci_validate_text(const char *str); - /** - * uci_add_hook: add a uci hook + * uci_parse_ptr: parse a uci string into a uci_ptr * @ctx: uci context - * @ops: uci hook ops + * @ptr: target data structure + * @str: string to parse * - * NB: allocated and freed by the caller - */ -extern int uci_add_hook(struct uci_context *ctx, const struct uci_hook_ops *ops); - -/** - * uci_remove_hook: remove a uci hook - * @ctx: uci context - * @ops: uci hook ops + * str is modified by this function */ -extern int uci_remove_hook(struct uci_context *ctx, const struct uci_hook_ops *ops); +int uci_parse_ptr(struct uci_context *ctx, struct uci_ptr *ptr, char *str); /** - * uci_load_plugin: load an uci plugin + * uci_lookup_next: lookup a child element * @ctx: uci context - * @filename: path to the uci plugin + * @e: target element pointer + * @list: list of elements + * @name: name of the child element * - * NB: plugin will be unloaded automatically when the context is freed + * if parent is NULL, the function looks up the package with the given name */ -int uci_load_plugin(struct uci_context *ctx, const char *filename); +int uci_lookup_next(struct uci_context *ctx, struct uci_element **e, struct uci_list *list, const char *name); /** - * uci_load_plugins: load all uci plugins from a directory - * @ctx: uci context - * @pattern: pattern of uci plugin files (optional) - * - * if pattern is NULL, then uci_load_plugins will call uci_load_plugin - * for uci_*.so in /lib/ + * uci_parse_section: look up a set of options + * @s: uci section + * @opts: list of options to look up + * @n_opts: number of options to look up + * @tb: array of pointers to found options */ -int uci_load_plugins(struct uci_context *ctx, const char *pattern); +void uci_parse_section(struct uci_section *s, const struct uci_parse_option *opts, + int n_opts, struct uci_option **tb); /** - * uci_parse_ptr: parse a uci string into a uci_ptr - * @ctx: uci context - * @ptr: target data structure - * @str: string to parse - * - * str is modified by this function + * uci_hash_options: build a hash over a list of options + * @tb: list of option pointers + * @n_opts: number of options */ -int uci_parse_ptr(struct uci_context *ctx, struct uci_ptr *ptr, char *str); +uint32_t uci_hash_options(struct uci_option **tb, int n_opts); + /* UCI data structures */ enum uci_type { UCI_TYPE_UNSPEC = 0, - UCI_TYPE_HISTORY = 1, + UCI_TYPE_DELTA = 1, UCI_TYPE_PACKAGE = 2, UCI_TYPE_SECTION = 3, UCI_TYPE_OPTION = 4, @@ -344,7 +349,6 @@ enum uci_type { UCI_TYPE_BACKEND = 6, UCI_TYPE_ITEM = 7, UCI_TYPE_HOOK = 8, - UCI_TYPE_PLUGIN = 9, }; enum uci_option_type { @@ -356,7 +360,7 @@ enum uci_flags { UCI_FLAG_STRICT = (1 << 0), /* strict mode for the parser */ UCI_FLAG_PERROR = (1 << 1), /* print parser error messages */ UCI_FLAG_EXPORT_NAME = (1 << 2), /* when exporting, name unnamed sections */ - UCI_FLAG_SAVED_HISTORY = (1 << 3), /* store the saved history in memory as well */ + UCI_FLAG_SAVED_DELTA = (1 << 3), /* store the saved delta in memory as well */ }; struct uci_element @@ -396,8 +400,8 @@ struct uci_context char *confdir; char *savedir; - /* search path for history files */ - struct uci_list history_path; + /* search path for delta files */ + struct uci_list delta_path; /* private: */ int err; @@ -406,9 +410,6 @@ struct uci_context bool internal, nested; char *buf; int bufsz; - - struct uci_list hooks; - struct uci_list plugins; }; struct uci_package @@ -416,15 +417,15 @@ struct uci_package struct uci_element e; struct uci_list sections; struct uci_context *ctx; - bool has_history; + bool has_delta; char *path; /* private: */ struct uci_backend *backend; void *priv; int n_section; - struct uci_list history; - struct uci_list saved_history; + struct uci_list delta; + struct uci_list saved_delta; }; struct uci_section @@ -454,9 +455,10 @@ enum uci_command { UCI_CMD_RENAME, UCI_CMD_REORDER, UCI_CMD_LIST_ADD, + UCI_CMD_LIST_DEL, }; -struct uci_history +struct uci_delta { struct uci_element e; enum uci_command cmd; @@ -484,29 +486,9 @@ struct uci_ptr const char *value; }; -struct uci_hook_ops -{ - void (*load)(const struct uci_hook_ops *ops, struct uci_package *p); - void (*set)(const struct uci_hook_ops *ops, struct uci_package *p, struct uci_history *e); -}; - -struct uci_hook -{ - struct uci_element e; - const struct uci_hook_ops *ops; -}; - -struct uci_plugin_ops -{ - int (*attach)(struct uci_context *ctx); - void (*detach)(struct uci_context *ctx); -}; - -struct uci_plugin -{ - struct uci_element e; - const struct uci_plugin_ops *ops; - void *dlh; +struct uci_parse_option { + const char *name; + enum uci_option_type type; }; @@ -575,23 +557,19 @@ struct uci_plugin /* wrappers for dynamic type handling */ #define uci_type_backend UCI_TYPE_BACKEND -#define uci_type_history UCI_TYPE_HISTORY +#define uci_type_delta UCI_TYPE_DELTA #define uci_type_package UCI_TYPE_PACKAGE #define uci_type_section UCI_TYPE_SECTION #define uci_type_option UCI_TYPE_OPTION -#define uci_type_hook UCI_TYPE_HOOK -#define uci_type_plugin UCI_TYPE_PLUGIN /* element typecasting */ #ifdef UCI_DEBUG_TYPECAST static const char *uci_typestr[] = { [uci_type_backend] = "backend", - [uci_type_history] = "history", + [uci_type_delta] = "delta", [uci_type_package] = "package", [uci_type_section] = "section", [uci_type_option] = "option", - [uci_type_hook] = "hook", - [uci_type_plugin] = "plugin", }; static void uci_typecast_error(int from, int to) @@ -609,21 +587,17 @@ static void uci_typecast_error(int from, int to) } BUILD_CAST(backend) -BUILD_CAST(history) +BUILD_CAST(delta) BUILD_CAST(package) BUILD_CAST(section) BUILD_CAST(option) -BUILD_CAST(hook) -BUILD_CAST(plugin) #else #define uci_to_backend(ptr) container_of(ptr, struct uci_backend, e) -#define uci_to_history(ptr) container_of(ptr, struct uci_history, e) +#define uci_to_delta(ptr) container_of(ptr, struct uci_delta, e) #define uci_to_package(ptr) container_of(ptr, struct uci_package, e) #define uci_to_section(ptr) container_of(ptr, struct uci_section, e) #define uci_to_option(ptr) container_of(ptr, struct uci_option, e) -#define uci_to_hook(ptr) container_of(ptr, struct uci_hook, e) -#define uci_to_plugin(ptr) container_of(ptr, struct uci_plugin, e) #endif /** @@ -639,4 +613,67 @@ BUILD_CAST(plugin) #define uci_dataptr(ptr) \ (((char *) ptr) + sizeof(*ptr)) +/** + * uci_lookup_package: look up a package + * @ctx: uci context + * @name: name of the package + */ +static inline struct uci_package * +uci_lookup_package(struct uci_context *ctx, const char *name) +{ + struct uci_element *e = NULL; + if (uci_lookup_next(ctx, &e, &ctx->root, name) == 0) + return uci_to_package(e); + else + return NULL; +} + +/** + * uci_lookup_section: look up a section + * @ctx: uci context + * @p: package that the section belongs to + * @name: name of the section + */ +static inline struct uci_section * +uci_lookup_section(struct uci_context *ctx, struct uci_package *p, const char *name) +{ + struct uci_element *e = NULL; + if (uci_lookup_next(ctx, &e, &p->sections, name) == 0) + return uci_to_section(e); + else + return NULL; +} + +/** + * uci_lookup_option: look up an option + * @ctx: uci context + * @section: section that the option belongs to + * @name: name of the option + */ +static inline struct uci_option * +uci_lookup_option(struct uci_context *ctx, struct uci_section *s, const char *name) +{ + struct uci_element *e = NULL; + if (uci_lookup_next(ctx, &e, &s->options, name) == 0) + return uci_to_option(e); + else + return NULL; +} + +static inline const char * +uci_lookup_option_string(struct uci_context *ctx, struct uci_section *s, const char *name) +{ + struct uci_option *o; + + o = uci_lookup_option(ctx, s, name); + if (!o || o->type != UCI_TYPE_STRING) + return NULL; + + return o->v.string; +} + +#ifdef __cplusplus +} +#endif + #endif