openwrt uci c api

一：UCI文件语法

config 'section-type' 'section'

        option 'key' 'value'

        list    'list_key'  'list_value'

config 节点 以关键字 config 开始的一行用来代表当前节点
            section-type 节点类型
            section 节点名称
option 选项 表示节点中的一个元素
            key 键
            value 值
list 列表选项 表示列表形式的一组参数。
           list_key 列表键
           list_value 列表值

二：c api 文件写

1） libuci无论数读写配置文件， 配置文件都必须存在， libuci不负责磁盘文件建立。

2） libuci上下文会保存全部配置文件的配置信息, 当你程序中打开uci上下文后，你在控制台使用uci命令行输入的信息也包含在其中

3） 当你需要修改/增加一个option时， option所在的section必须已经存在， 否则写入会失败

int UCI::setValue(const char *key, const char *value)
{
	if (key == nullptr || value == nullptr)
	{
		return UCI_ERR_INVAL;
	}

	struct uci_context *_ctx = uci_alloc_context();
	if (_ctx == nullptr)
	{
		return UCI_ERR_INVAL;
	}

	struct uci_ptr *ptr = (struct uci_ptr *)malloc(sizeof(struct uci_ptr));
	if (ptr == nullptr)
	{
		uci_free_context(_ctx);
		return UCI_ERR_INVAL;
	}
	memset(ptr, 0, sizeof(struct uci_ptr));
	ptr->package = _fileName;//文件名称/etc/config/network
	ptr->section = _sectionName;//lan 
	ptr->option = key;//ipaddr 
	ptr->value = value;//127.0.0.1

	int ret = UCI_OK;
	ret = uci_set(_ctx, ptr);
	if (ret != UCI_OK)
	{
		uci_perror(_ctx, "uci_set Perror:");
		uci_free_context(_ctx);
		free(ptr);
		return ret;
	}

	ret = uci_commit(_ctx, &ptr->p, false);
	if (ret != UCI_OK)
	{
		uci_perror(_ctx, "uci_commit Perror:");
		uci_free_context(_ctx);
		free(ptr);
		return ret;
	}

	ret = uci_unload(_ctx, ptr->p);
	if (ret != UCI_OK)
	{
		uci_perror(_ctx, "uci_commit Perror:");
		uci_free_context(_ctx);
		free(ptr);
		return ret;
	}

	uci_free_context(_ctx);
	free(ptr);
	return UCI_OK;
}

三：c api 文件读

int UCI::getValue(const char *key, char *out)
{
	struct uci_context *ctx;
	struct uci_element *e;
	struct uci_ptr ptr;
	int ret = UCI_OK;
	char name[1024] = "robot.main.";

	if (key == NULL || out == NULL)
	{
		return UCI_ERR_INVAL;
	}

	ctx = uci_alloc_context();
	if (!ctx)
	{
		return UCI_ERR_MEM;
	}

	strcat(name, key);
	if (uci_lookup_ptr(ctx, &ptr, name, true) != UCI_OK)
	{
		uci_free_context(ctx);
		return UCI_ERR_NOTFOUND;
	}

	if (2 /*UCI_LOOKUP_COMPLETE*/ & ptr.flags)
	{
		e = ptr.last;
		switch (e->type)
		{
		case UCI_TYPE_SECTION:
			ret = UCI_ERR_INVAL;
			break;
		case UCI_TYPE_OPTION:
			ret = uci_get_value(ptr.o, out);
			break;
		default:
			ret = UCI_ERR_NOTFOUND;
			break;
		}
	}
	else
	{
		ret = UCI_ERR_NOTFOUND;
	}

	uci_free_context(ctx);
	return ret;
}


int UCI::uci_get_value(struct uci_option *o, char *out)
{
	struct uci_element *e;
	const char *delimiter = " ";
	bool sep = false;

	switch (o->type)
	{
	case UCI_TYPE_STRING:
		strcpy(out, o->v.string);
		break;
	case UCI_TYPE_LIST:
		uci_foreach_element(&o->v.list, e)
		{
			if (sep)
			{
				strcat(out, delimiter);
			}
			strcat(out, e->name);
			sep = true;
		}
		break;
	default:
		return UCI_ERR_INVAL;
	}

	return UCI_OK;
}

UCI用法说明

OpenWRT UCI API的使用经验

LibUCI-Documentation