OpenWRT UCI API的使用
OpenWRT UCI API的使用
UCI 是OpenWRT為實(shí)現(xiàn)配置集中化而引入的一個(gè)軟件包, 通過(guò)修改UCI,可以實(shí)現(xiàn)對(duì)OpenWRT的絕對(duì)部分配置的修改.LUCI(OpenWRT 的WEB配置界面)也是通過(guò)讀UCI配置文件的操作來(lái)實(shí)現(xiàn)用戶對(duì)路由的配置的。通過(guò)掌握UCI的API的使用,可以方便地將您的軟件的配置接口集成到LUCI中.
LUCI配置文件簡(jiǎn)介
LUCI的配置文件一般存儲(chǔ)在 /etc/config目錄下。比如網(wǎng)絡(luò)配置文件則是 /etc/config/network 無(wú)線的配置文件是 /etc/config/wireless. 跟多配置文件的含義參考官方 WIKI
基本概念
UCI上下文: struct uci_context *
包(Package): 一個(gè)包對(duì)應(yīng)一個(gè)UCI格式的文件.類(lèi)型是 struct uci_package *
節(jié)(Section): 一個(gè)配置文件的節(jié)點(diǎn). 類(lèi)型是 struct uci_list *
值(Value):一個(gè)節(jié)下面可能包含多個(gè)值 一個(gè)值具有一個(gè)名字.
UCI配置文件的基本操作.
首先您需要引入頭文件
#include#include#include#includestatic?struct?uci_context?*?ctx?=?NULL;?//定義一個(gè)UCI上下文的靜態(tài)變量.
/*********************************************
*???載入配置文件,并遍歷Section.
*/
bool?load_config()
{
????struct?uci_package?*?pkg?=?NULL;
????struct?uci_element?*e;
????ctx?=?uci_alloc_context();?//?申請(qǐng)一個(gè)UCI上下文.
????if?(UCI_OK?!=?uci_load(ctx,?UCI_CONFIG_FILE,?&pkg))
????????goto?cleanup;?//如果打開(kāi)UCI文件失敗,則跳到末尾?清理?UCI?上下文.
????/*遍歷UCI的每一個(gè)節(jié)*/
????uci_foreach_element(&pkg->sections,?e)
????{
????????struct?uci_section?*s?=?uci_to_section(e);
????????//?將一個(gè)?element?轉(zhuǎn)換為?section類(lèi)型,?如果節(jié)點(diǎn)有名字,則?s->anonymous?為?false.
????????//?此時(shí)通過(guò)?s->e->name?來(lái)獲取.
????????//?此時(shí)?您可以通過(guò)?uci_lookup_option()來(lái)獲取?當(dāng)前節(jié)下的一個(gè)值.
????????if?(NULL?!=?(value?=?uci_lookup_option_string(ctx,?s,?"ipaddr")))
????????{
????????????ip?=?strdup(value)?//如果您想持有該變量值，一定要拷貝一份。當(dāng)?pkg銷(xiāo)毀后value的內(nèi)存會(huì)被釋放。
????????}
????????//?如果您不確定是?string類(lèi)型?可以先使用?uci_lookup_option()?函數(shù)得到Option?然后再判斷.
????????//?Option?的類(lèi)型有?UCI_TYPE_STRING?和?UCI_TYPE_LIST?兩種.
????}
????uci_unload(ctx,?pkg);?//?釋放?pkg?
cleanup:
????uci_free_context(ctx);
????ctx?=?NULL;
}
遍歷一個(gè)UCI_TYPE_LIST 類(lèi)型.
加入現(xiàn)在有一個(gè)如下的配置文件:
????config??"server"?"webserver" ????????list????"index"?"index.html" ????????list????"index"?"index.php" ????????list????"index"?"default.html"
代碼片:
//?s?為?section.
struct?uci_option?*?o?=?uci_lookup_option(ctx,?s,?"index");
if?((NULL?!=?o)?&&?(UCI_TYPE_LIST?==?o->type))?//o存在?且?類(lèi)型是?UCI_TYPE_LIST則可以繼續(xù).
{
????struct?uci_element?*e;
????uci_foreach_element(&o->v.list,?e)
????{
????????//這里會(huì)循環(huán)遍歷?list
????????//?e->name?的值依次是?index.html,?index.php,?default.html
????}
}
寫(xiě)配置
UCI提供了一個(gè)簡(jiǎn)潔的辦法來(lái)操作配置信息,例如有一個(gè)配置文件
#文件名:?testconfig config??'servver' ????option??'value'?'123'?#?我們想修改?'value'?的值為?'456'
代碼如下:
struct?uci_context?*?ctx?=?uci_alloc_context();?//申請(qǐng)上下文
struct?uci_ptr?ptr?={
????.package?=?"config",
????.section?=?"servver",
????.option?=?"value",
????.value?=?"256",
};
uci_set(_ctx,&ptr);?//寫(xiě)入配置
uci_commit(_ctx,?&ptr.p,?false);?//提交保存更改
uci_unload(_ctx,ptr.p);?//卸載包
uci_free_context(ctx);?//釋放上下文
依照上面的例子，我們可以舉一反三, uci_ptr 用來(lái)指定信息.而是用uci_set則是寫(xiě)入信息.同類(lèi)的函數(shù)有如下幾個(gè): 針對(duì)list的操作:
????uci_add_list()??//?添加一個(gè)list?值 ????uci_del_list()??//?刪除一個(gè)list?值 ????uci_delete()????//?刪除一個(gè)option值
下載文檔
