2 * libuci - Library for the Unified Configuration Interface
3 * Copyright (C) 2008 Felix Fietkau <nbd@openwrt.org>
5 * This program is free software; you can redistribute it and/or modify
6 * it under the terms of the GNU Lesser General Public License version 2.1
7 * as published by the Free Software Foundation
9 * This program is distributed in the hope that it will be useful,
10 * but WITHOUT ANY WARRANTY; without even the implied warranty of
11 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
12 * GNU General Public License for more details.
16 * This file contains some common code for the uci library
20 #include <sys/types.h>
27 static const char *uci_confdir = UCI_CONFDIR;
28 static const char *uci_savedir = UCI_SAVEDIR;
30 static const char *uci_errstr[] = {
32 [UCI_ERR_MEM] = "Out of memory",
33 [UCI_ERR_INVAL] = "Invalid argument",
34 [UCI_ERR_NOTFOUND] = "Entry not found",
35 [UCI_ERR_IO] = "I/O error",
36 [UCI_ERR_PARSE] = "Parse error",
37 [UCI_ERR_DUPLICATE] = "Duplicate entry",
38 [UCI_ERR_UNKNOWN] = "Unknown error",
41 static void uci_cleanup(struct uci_context *ctx);
43 #include "uci_internal.h"
49 /* exported functions */
50 struct uci_context *uci_alloc_context(void)
52 struct uci_context *ctx;
54 ctx = (struct uci_context *) malloc(sizeof(struct uci_context));
55 memset(ctx, 0, sizeof(struct uci_context));
56 uci_list_init(&ctx->root);
57 uci_list_init(&ctx->history_path);
58 uci_list_init(&ctx->backends);
59 ctx->flags = UCI_FLAG_STRICT | UCI_FLAG_SAVED_HISTORY;
61 ctx->confdir = (char *) uci_confdir;
62 ctx->savedir = (char *) uci_savedir;
64 uci_list_add(&ctx->backends, &uci_file_backend.e.list);
65 ctx->backend = &uci_file_backend;
70 void uci_free_context(struct uci_context *ctx)
72 struct uci_element *e, *tmp;
74 if (ctx->confdir != uci_confdir)
76 if (ctx->savedir != uci_savedir)
80 UCI_TRAP_SAVE(ctx, ignore);
81 uci_foreach_element_safe(&ctx->root, tmp, e) {
82 struct uci_package *p = uci_to_package(e);
85 uci_foreach_element_safe(&ctx->history_path, tmp, e) {
88 UCI_TRAP_RESTORE(ctx);
95 int uci_set_confdir(struct uci_context *ctx, const char *dir)
100 UCI_ASSERT(ctx, dir != NULL);
102 cdir = uci_strdup(ctx, dir);
103 if (ctx->confdir != uci_confdir)
109 static void uci_cleanup(struct uci_context *ctx)
111 struct uci_parse_context *pctx;
125 uci_free_package(&pctx->package);
133 void uci_perror(struct uci_context *ctx, const char *prefix)
142 if ((err < 0) || (err >= UCI_ERR_LAST))
143 err = UCI_ERR_UNKNOWN;
146 fprintf(stderr, "%s: ", prefix);
148 fprintf(stderr, "%s: ", ctx->func);
153 fprintf(stderr, "%s (%s) at line %d, byte %d\n", uci_errstr[err], (ctx->pctx->reason ? ctx->pctx->reason : "unknown"), ctx->pctx->line, ctx->pctx->byte);
158 fprintf(stderr, "%s\n", uci_errstr[err]);
163 int uci_list_configs(struct uci_context *ctx, char ***list)
166 UCI_ASSERT(ctx, list != NULL);
167 UCI_ASSERT(ctx, ctx->backend && ctx->backend->list_configs);
168 *list = ctx->backend->list_configs(ctx);
172 int uci_commit(struct uci_context *ctx, struct uci_package **package, bool overwrite)
174 struct uci_package *p;
176 UCI_ASSERT(ctx, package != NULL);
178 UCI_ASSERT(ctx, p != NULL);
179 UCI_ASSERT(ctx, p->backend && p->backend->commit);
180 p->backend->commit(ctx, package, overwrite);
184 int uci_load(struct uci_context *ctx, const char *name, struct uci_package **package)
186 struct uci_package *p;
188 UCI_ASSERT(ctx, ctx->backend && ctx->backend->load);
189 p = ctx->backend->load(ctx, name);
196 #ifdef UCI_PLUGIN_SUPPORT
198 __plugin int uci_add_backend(struct uci_context *ctx, struct uci_backend *b)
200 struct uci_element *e;
203 e = uci_lookup_list(&ctx->backends, b->e.name);
205 UCI_THROW(ctx, UCI_ERR_DUPLICATE);
207 e = uci_malloc(ctx, sizeof(struct uci_backend));
208 memcpy(e, b, sizeof(struct uci_backend));
210 uci_list_add(&ctx->backends, &e->list);
214 __plugin int uci_del_backend(struct uci_context *ctx, struct uci_backend *b)
216 struct uci_element *e, *tmp;
220 e = uci_lookup_list(&ctx->backends, b->e.name);
221 if (!e || uci_to_backend(e)->ptr != b->ptr)
222 UCI_THROW(ctx, UCI_ERR_NOTFOUND);
223 b = uci_to_backend(e);
225 if (ctx->backend && ctx->backend->ptr == b->ptr)
226 ctx->backend = &uci_file_backend;
228 uci_foreach_element_safe(&ctx->root, tmp, e) {
229 struct uci_package *p = uci_to_package(e);
234 if (p->backend->ptr == b->ptr)
235 UCI_INTERNAL(uci_unload, ctx, p);
238 uci_list_del(&b->e.list);
246 int uci_set_backend(struct uci_context *ctx, const char *name)
248 struct uci_element *e;
251 UCI_ASSERT(ctx, name != NULL);
252 e = uci_lookup_list(&ctx->backends, name);
254 UCI_THROW(ctx, UCI_ERR_NOTFOUND);
255 ctx->backend = uci_to_backend(e);