openwrt 各目录分析

前言

这段时间总是在和openwrt打交道,之前也零零散散地写过一点，还是希望能有点体系。还记得我刚看到源代码的时候，觉得无从下手.我想从Makefile的整个执行过程入手,搞清楚编译源代码的几个小时中,到底发生了哪些故事. 
本文是这个系列的第一篇.主要讲一下我对openwrt整个目录结构的理解.我们将源代码从官方下载而来的目录称之为原始目录,将编译后生成的目录称之为生成目录,分两部分介绍各个目录.

---

原始目录

下载源码后,源文件如下图所示,下面我们来一一解释; 

1. scripts

存放了一些脚本,使用了bash,Python,perl等多种脚本语言.编译过程中,用于第三方软件包管理的feeds文件也是在这个目录当中.在编译过程中,使用到的脚本也统一放在这个目录中.

2. tools

编译时,主机需要使用一些工具软件,tools 里包含了获取和编译这些工具的命令.软件包里面有Makefile文件,有的还包含了patch.每个Makefile当中都有一句$(eval $(call HostBuild)),这表明编译这个工具是为了在主机上使用的.

3. config

存放着整个系统的配置文件

4. docs

包含了整个宿主机的文件源码的介绍, 里面还有Makefile为目标系统生成docs.使用make -C docs/可以为目标系统生成文档.

5. toolchain

嵌入式的童鞋应该都知道交叉编译链,这个文件中存放的就是编译交叉编译链的软件包.包括:binutils,gcc,libc等等.

6. target

openwrt的源码可以编译出各个平台适用的二进制文件,各平台在这个目录里定义了firmware和kernel的编译过程。

7. package

存放了openwrt系统中适用的软件包,包含针对各个软件包的Makefile。openwrt定义了一套Makefile模板.各软件参照这个模板定义了自己的信息，如软件包的版本、下载地址、编译方式、安装地址等。在二次开发过程中,这个文件夹我们会经常打交道. 
事实上,通过./scripts/feed update -a和./scripts/feed install -a的软件包也会存放在这个目录之中.

8. include

openwrt的Makefile都存放在这里。文件名为 *.mk 。这里的文件上是在Makefile里被include的,类似于库文件.这些文件定义了编译过程.

9. 其他

主要目录就是前面提及的8个,剩下的是单个文件.

9.1 Makefile:

在顶层目录执行make命令的入口文件.

9.2 rules.mk

定义了Makefile中使用的一些通用变量和函数

9.3 Config.in

在include/toplevel.mk中我们可以看到,这是和make menuconfig相关联的文件.

9.4 feeds.conf.default

是下载第三方一些软件包时所使用的地址

9.5 LICENSE & README

即软件许可证和软件基本说明.其中README描述了编译软件的基本过程和依赖文件.

至此我们把原始目录大致浏览了一遍,下面我们看看生成目录.

生成目录

在我们编译完成后除了下载的源码文件,多出来的部分很明显就是编译过程中新生成的.如下图: 

1. feeds

openwrt的附加软件包管理器的扩展包索引目录.有点绕,简单来说就是下载管理软件包的.默认的feeds下载有packages、management、luci、routing、telephony。如要下载其他的软件包，需打开源码根目录下面的feeds.conf.default文件，去掉相应软件包前面的#号，然后更新源: 
./scripts/feeds update -a 
安装下载好的包: 
./scripts/feeds install -a

2. build_dir

在前面的原始目录中,我们提到了host工具,toolchain工具还有目标文件.openwrt将在这个目录中展开各个软件包,进行编译.所以这个文件夹中包含3个子文件夹:

2.1 host

在该文件夹中编译主机使用的工具软件

2.2 toolchain-XXX

在该文件夹中编译交叉工具链

2.3 target-XXX

在此编译目标平台的目标文件,包括各个软件包和内核文件.

3. bin

保存编译完成后的二进制文件,包括:完整的bin文件,所有的ipk文件.

4. dl

在编译过程中使用的很多软件,刚开始下载源码并没有包含,而是在编译过程中从其他服务器下载的,这里是统一的保存目录

5. staging_dir

用于保存在build_dir目录中编译完成的软件.所以这里也和build_dir有同样的子目录结构. 
比如,在target-XXX文件夹中保存了目标平台编译好的头文件,库文件.在我们开发自己的ipk文件时,编译过程中,预处理头文件,链接动态库,静态库都是到这个子文件夹中.

6.tmp

从名字来看,是临时文件夹.在编译过程中,有大量中间临时文件需要保存,都是在这里.

7.logs

这个文件夹,有时可以看到,有时没有.这是因为这个文件夹保存的是,编译过程中出错的信息,只有当编译出错了才会出现.我们可以从这里获取信息,从而分析我们的软件编译为什么没有完成.

至此我们把openwrt的目录结构大体浏览了一遍.