OpenWrt 脚本配置

bandgear

脚本配置

加载

为了加载UCI配置文件，你需要包含常见函数：

. /lib/functions.sh

然后你可以使用config_load name来加载配置文件。

此函数首先会把name当做是绝对文件名并后退到/etc/config/进行加载。

如果你想对节段或选项使用特殊回调的话，你需要重新定义以下描述的shell函数，并且是在运行config_load之前，/etc/functions.sh之后。

Callbacks

在句法分析过程中，每次遇到UCI节段标题时都会调用config_cb过程。

当被调用时，此过程就会接收到两个参数：

1.       TYPE，节段类型

2.       NAME,节段名称

config_cb() {

local type="$1"

local name="$2"

# commands to be run for every section

}

与config_cb相似，每次遇到UCI选项时都会调用option_cb过程。

当被调用时，此进程会接收两个参数：

1.       NAME，选项名称

2.       VALUE，选项值

option_cb() {

local name="$1"

local value="$2"

# commands to be run for every option

}

你可以基于节段类型将config_cb更改为option_cb。它可以使你能够依据它们的类型逐一处理单独的config节段。

Iterating

基于语句分析的callback的变换方法是用config_foreach过程迭代配置节段。

Config_foreach过程至少需要一个参数：

1.       Function，为每个遇到的节段而调用的预先定义的程序名称

2.       Type，只迭代已给类型的节段，跳过其它的。

3.       Additional arguments，所有以下参数都按原样传递给回调程序

在以下示例中，每个config interface节段都会在/etc/config/network调用handle_interface过程。Test字符串会被做为第二个参数在每个调用中进行传送。

handle_interface() {

local config="$1"

local custom="$2"

# run commands for every interface section

}

config_load network

config_foreach handle_interface interface test

也可以通过return一个非零值在callback内部取消迭代。

在每个节段回调内，config_get或config_set过程也许是用来读取或设置属于当前进程段的值。

读取选项

Config_get过程至少需要三个参数：

1.       用以保存恢复值的可变名称

2.       读取数值的节段ID

3.       读取数值的选项名称

4.       默认，如果选项未设置数值会返回

…

# read the value of "option ifname" into the "iface" variable

# $config contains the ID of the current section

local iface

config_get iface "$config" ifname

echo "Interface name is $iface"

…

设置选项

Config_set过程需要三个参数：

1.       设置选项的节段ID

2.       分配数值的选项名称

3.       分配的数值

…

# set the value of "option auto" to "0"

# $config contains the ID of the current section

config_set "$config" auto 0

…

需要注意的是用config_set更改的数值只保存在内存中。随后调用config_get将会返回被更新的数值。如果你想改变数值，使用/lib/config/uci.sh中的uci_*函数，此函数会自动包括在/etc/fuctions.sh中。

直接存取

如果预先知道配置节段的名称，便宜可以直接读取选项而无须使用节段迭代程序回调。

以下示例是从“config interface”节段读取“option proto”。

…

local proto config_get proto wan proto

echo "Current WAN protocol is $proto"

…





欢迎大家提出自己的想法和意见，可以以回复的形式提出，或者加入我的QQ群大家一起交流，互相学习。
      名   称：openwrt开发
      群   号:  278691630、331230369 、318937037、208461032

bandgear

Reading List

一些UCI配置可能会在表格中包含list选项：

…
list network lan
list network wifi

…

在network调用config_get，list将会回复由空格隔开的列表值，以lan wifi为例.
然而，如果列表项本身包含空格的话，这一举动也许会破坏数值，例如：

…
list animal 'White Elephant'
list animal 'Mighty Unicorn'

…

Config_get会在White Elephant Mighty Unicorn表格中回复数值，并且最初的列表项也不再被清晰的分隔开。
为了避免这个问题，可以使用config_list_foreach迭代模式。它与config_foreach相似，但对list value起作用，而不是config节段。
Config_list__foreach过程需要至少三个参数：
1.        从列表进行读取的节段ID
2.        从选项读取对象的列表名称
3.        每个列表对象调用的进程
4.        附加参数。所有以下参数都会原样传送到回调过程

# handle list items in a callback
# $config contains the ID of the section
handle_animal() {
local value="$1"
# do something with $value
}

config_list_foreach "$config" animal handle_animal


Reading Booleans

Boolean选项也许包括各种数值来表示一个true value，例如on,true,enabled或1。
Config_get_bool过程简化了对读取boolean选项的处理，并生成一个整数值（1是true，0是false）。
此过程至少需要三个参数：
1.        从列表进行读取的节段ID
2.        从选项读取对象的列表名称
3.        每个列表对象调用的进程
4.        附加参数。如果未设置选项会返回boolean value。



欢迎大家提出自己的想法和意见，可以以回复的形式提出，或者加入我的QQ群大家一起交流，互相学习。
      名   称：openwrt开发
      群   号: 79612872