OpenWrt开发之配置文件

OpenWrt开发之配置文件

本站内容版权属于本人。转载须告知本人,写明出处,并在文首提供指向本站对应文章的链接。
本文链接:OpenWrt开发之配置文件

如果要在OpenWrt上运行自己写的程序,那其实配置文件怎么做都可以,只要程序能读它就行。然而,OpenWrt提供了一套名叫UCI,也就是“全局配置接口”的系统,用它来做配置,可以给开发者省下很多麻烦。

文件格式

一个标准的UCI配置文件长这样:

UCI配置文件的一项配置分为三个层级:配置文件、配置段、配置。在上面的例子里,每个以config开头的行和之下的行都是一个配置段,第二个词是段类型,第三个词是段名,段名可以为空,即是匿名段。段里有缩进的几行每行都是一个配置,以option开头,第二个词是配置名,后面是它的值。如果配置段名和配置值里面没有字母、数字、下划线以外的值,引号也可以省去。其他地方只能用字母、数字、下划线组成的诩。

在启动脚本里读取配置

很多时候,其实不需要在自己的程序里读取配置文件,只要启动脚本能读取就可以了。启动脚本里面可以使用一些命令来读取UCI配置文件。

比如我们的配置文件长这样,路径是/etc/config/myconfigmain里面的配置是共通的,server类型的配置则是每段都启动一个服务器:

那我们就可以这样写启动脚本:

其中用到了以下三个命令:

  • config_load <配置文件名>:载入配置文件。
  • config_get <变量名> <段名> <配置名>:读取配置到变量里。
  • config_foreach <函数名> <段类型> [其他参数]:为每个这种类型的段调用一次指定的函数,函数第一个参数为段名,后面依序为其他参数。

前面说到段名可以为空,这里又需要用到段名,那如果是空怎么办呢?其实在系统里,匿名段也是有名字的,所以这里不需要担心这个命令出问题。

总结

UCI配置在OpenWrt里面可以说是无处不在,启动脚本、Luci界面、Lua脚本等等地方都有相关的API。当你使用了它时,就再也不需要关心处理读取配置文件的具体实现了。如果要开发新程序,非常推荐使用它。如果想要把已有程序移植到OpenWrt上,也可以使用它,并在启动脚本里从UCI配置生成程序实际使用的配置。

参考文档
  1. https://openwrt.org/docs/guide-user/base-system/uci
  2. https://openwrt.org/docs/guide-developer/config-scripting

发表评论

您的电子邮箱地址不会被公开。 必填项已用*标注

*

此站点使用Akismet来减少垃圾评论。了解我们如何处理您的评论数据