OpenWrt 基础软件模块之ubox

大家好，我是讯享网，很高兴认识大家。

OpenWrt 基础软件模块之ubox

核心工具模块ubox

ubox在2013年加入OpenWrt的代码库中。它是 OpenWrt 中的一个核心扩展功能，是OpenWrt的帮助工具箱

ubox分三个部分：

内核模块管理，例如加载内核模块，查看已经加载内核模块等
日志管理
UCI配置文件数据类型的验证

内核模块管理

内核模块管理使用kmodloader来管理，并软链接为以下5个不同的Linux命令：

rmmod： 从Linux内核中移除一个模块
insmod： 向Linux内核插入一个模块
lsmod： 显示已加载到Linux内核中的模块状态

modinfo： 显示一个Linux内核模块的信息，包含模块路径、许可协议和所依赖模块
modprobe： 加载一个内核模块

日志管理

日志管理提供了ubus日志服务，可以通过ubus总线来获取和写入日志
logread读取日志，logd来对日志进行管理

配置文件数据类型的验证

对于其他软件模块来说，主要使用 ubox 提供的配置文件验证功能，这样带来了一些好处，可以在软件启动之前使用脚本来对UCI配置进行验证，这样可以很好的同其他软件模块进行分工合作

讯享网

配置验证选项有很多类型和关键字，下标列出常用的验证关键字含义：

关键字	含义
bool	布尔值，合法的取值有"0"、“off”、“false”、“no”、“disabled”、“1”、“on”、“true”、“yes” 和"enabled"
cidr	无类别路由选择的缩写，包含 cidr4 和 cidr6，是指 IP 地址和其掩码长度，IPv4 类型通常为 255.255.255.255/32 格式
cidr4	IPv4 类型的 IP 地址和其子网掩码，格式为 255.255.255.255/32
file	文件路径，例如为/etc/config/network
host	主机名称、域名或 IP 地址
ip4addr	IPv4 地址，可以是任何 IP 地址，不验证 IP 地址合法性
list	是指一个类型的几个数据列表，中间用空格分开，例如 list(port)表示是一个端口列表
netmask4	IPv4 地址的网络掩码，例如 255.255.255.0
or	表示可以为几种类型的一个，例如 or(port, portrange)表示为端口或者端口范围
portrange	端口范围，形式为 n-m，中间为短横线，不能为冒号，数字小于 65535，并且 n≤m
port	端口号数字，合法数字范围为 0～65535
range	表示数字所处的范围，例如 range(0, 31)表示大于等于 0，小于等于 31
string	字符串，可以限定字符串长度，例如 string(1, 10)限定字符串长度在 1 到 10 之间
uinteger	无符号整形数字

提供的配置验证工具为validate_data

方法：

第一种用法是对单个数据类型进行验证，它通常用于在软件启动前直接验证，如果数据类型不正确，将输出错误并退出启动流程；它需要两个参数，第一个参数为数据类型，第二个参数为需要验证的配置值

如： cron软件包对配置参数进行验证，是否为整型数字，如果不是数字，则输出验证失败并退出

loglevel=$(uci_get "system.@system[0].cronloglevel") [ -z "${loglevel}" ] || { 
    /sbin/validate_data uinteger "${loglevel}" 2>/dev/null [ "$?" -eq 0 ] || { 
    echo "validation failed" return 1 } }

讯享网

第二种用法是对配置文件的多个数据类型进行验证；它至少需要4个参数，第一个参数为 UCI 配置文件名，第二个参数为配置节类型，第三个参数配置节的名称，第四个参数为验证的 UCI 选项、类型和默认值；如果有多个配置选项需要验证，则以空格分开紧跟在第四个参数在后面

如：对网络时间服务器的配置进行验证，该用法必须指定配置节的名称，不能对匿名配置节的内容进行检查。前两行是命令输入，后面是该工具对配置文件检查的结果。可以使用 echo $？来获取其返回值，0 表示成功，根据返回值是否成功再执行下一步的处理流程。

讯享网/sbin/validate_data system timeserver ntp \ 'server:list(host)' 'enabled:bool:1' 'enable_server:bool:0' #下面是输出 system.ntp.server[0]=0.openwrt.pool.ntp.org validates as list(host) with true system.ntp.server[1]=1.openwrt.pool.ntp.org validates as list(host) with true system.ntp.server[2]=2.openwrt.pool.ntp.org validates as list(host) with true system.ntp.server[3]=3.openwrt.pool.ntp.org validates as list(host) with true system.ntp.enabled=1 validates as bool with true system.ntp.enable_server=0 validates as bool with true server='0.openwrt.pool.ntp.org'\ '1.openwrt.pool.ntp.org'\ '2.openwrt.pool.ntp.org'\ '3.openwrt.pool.ntp.org'; enabled=1; enable_server=0;

第3种用法的参数和第2种用法参数含义和顺序完全相同，但第 3 个参数为""(注意不要有空格)，表示空字符串，在这种情况下，将生成导入验证服务的命令字符串

如：下面案例前两行是命令调用，其后是该命令生成的字符串

/sbin/validate_data system timeserver "" ntp \ 'timeserver:list(host)' 'enabled:bool:1' 'enable_server:bool:0' #下面是输出 json_add_object; json_add_string "package" "system"; json_add_string "type" "timeserver"; json_add_object "data"; json_add_string "timeserver" "list(host)"; json_add_string "enabled" "bool"; json_add_string "enable_server" "bool"; json_close_object; json_close_object;

OpenWrt 基础软件模块之ubox

OpenWrt 基础软件模块之ubox

核心工具模块ubox

内核模块管理

日志管理

配置文件数据类型的验证

相关推荐