08 package分析

1.1 软件包目录结构(以dnsmasq为例)

一般目录下会有两个文件夹和一个Makefile

Makefile
fille       :默认配置和初始化脚本
src         :存放代码
patch       :可选

1.1.1 Makefile

include $(TOPDIR)/rules.mk      # 包含顶层rules.mk

# 软件包的基本信息
PKG_NAME:=dnsmasq
PKG_VERSION:=2.78
PKG_RELEASE:=6

# 固件包
# 下载地址
# HASH校验
PKG_SOURCE:=$(PKG_NAME)-$(PKG_VERSION).tar.xz 
PKG_SOURCE_URL:=http://thekelleys.org.uk/dnsmasq/
PKG_HASH:=89949f438c74b0c7543f06689c319484bd126cc4b1f8c745c742ab397681252b

# 许可证书、协议
PKG_LICENSE:=GPL-2.0
PKG_LICENSE_FILES:=COPYING

# 编译目录
PKG_BUILD_DIR:=$(BUILD_DIR)/$(PKG_NAME)-$(BUILD_VARIANT)/$(PKG_NAME)-$(PKG_VERSION)

PKG_INSTALL:=1
PKG_BUILD_PARALLEL:=1
PKG_CONFIG_DEPENDS:=CONFIG_PACKAGE_dnsmasq_$(BUILD_VARIANT)_dhcpv6 \
	CONFIG_PACKAGE_dnsmasq_$(BUILD_VARIANT)_dnssec \
	CONFIG_PACKAGE_dnsmasq_$(BUILD_VARIANT)_auth \
	CONFIG_PACKAGE_dnsmasq_$(BUILD_VARIANT)_ipset \
	CONFIG_PACKAGE_dnsmasq_$(BUILD_VARIANT)_conntrack \
	CONFIG_PACKAGE_dnsmasq_$(BUILD_VARIANT)_noid \
	CONFIG_PACKAGE_dnsmasq_$(BUILD_VARIANT)_broken_rtc

include $(INCLUDE_DIR)/package.mk

define Package/dnsmasq/Default
  SECTION:=net
  CATEGORY:=Base system
  TITLE:=DNS and DHCP server
  URL:=http://www.thekelleys.org.uk/dnsmasq/
  USERID:=dnsmasq=453:dnsmasq=453
endef

define Package/dnsmasq
$(call Package/dnsmasq/Default)
  VARIANT:=nodhcpv6
endef

define Package/dnsmasq-dhcpv6
$(call Package/dnsmasq/Default)
  TITLE += (with DHCPv6 support)
  DEPENDS:=@IPV6
  VARIANT:=dhcpv6
endef

define Package/dnsmasq-full
$(call Package/dnsmasq/Default)
  TITLE += (with DNSSEC, DHCPv6, Auth DNS, IPset, Conntrack, NO_ID enabled by default)
  DEPENDS:=+PACKAGE_dnsmasq_full_dnssec:libnettle \
	+PACKAGE_dnsmasq_full_ipset:kmod-ipt-ipset \
	+PACKAGE_dnsmasq_full_conntrack:libnetfilter-conntrack
  VARIANT:=full
endef

define Package/dnsmasq/description
  It is intended to provide coupled DNS and DHCP service to a LAN.
endef

define Package/dnsmasq-dhcpv6/description
$(call Package/dnsmasq/description)

This is a variant with DHCPv6 support
endef

define Package/dnsmasq-full/description
$(call Package/dnsmasq/description)

This is a fully configurable variant with DHCPv6, DNSSEC, Authoritative DNS and
IPset, Conntrack support & NO_ID enabled by default.
endef

define Package/dnsmasq/conffiles
/etc/config/dhcp
/etc/dnsmasq.conf
endef

define Package/dnsmasq-full/config
	if PACKAGE_dnsmasq-full
	config PACKAGE_dnsmasq_full_dhcpv6
		bool "Build with DHCPv6 support."
		depends on IPV6
		default y
	config PACKAGE_dnsmasq_full_dnssec
		bool "Build with DNSSEC support."
		default y
	config PACKAGE_dnsmasq_full_auth
		bool "Build with the facility to act as an authoritative DNS server."
		default y
	config PACKAGE_dnsmasq_full_ipset
		bool "Build with IPset support."
		default y
	config PACKAGE_dnsmasq_full_conntrack
		bool "Build with Conntrack support."
		default y
	config PACKAGE_dnsmasq_full_noid
		bool "Build with NO_ID. (hide *.bind pseudo domain)"
		default y
	config PACKAGE_dnsmasq_full_broken_rtc
		bool "Build with HAVE_BROKEN_RTC."
		default n
	endif
endef

Package/dnsmasq-dhcpv6/conffiles = $(Package/dnsmasq/conffiles)
Package/dnsmasq-full/conffiles = $(Package/dnsmasq/conffiles)

TARGET_CFLAGS += -ffunction-sections -fdata-sections
TARGET_LDFLAGS += -Wl,--gc-sections

COPTS = $(if $(CONFIG_IPV6),,-DNO_IPV6)

ifeq ($(BUILD_VARIANT),nodhcpv6)
	COPTS += -DNO_DHCP6
endif

ifeq ($(BUILD_VARIANT),full)
	COPTS += $(if $(CONFIG_PACKAGE_dnsmasq_$(BUILD_VARIANT)_dhcpv6),,-DNO_DHCP6) \
		$(if $(CONFIG_PACKAGE_dnsmasq_$(BUILD_VARIANT)_dnssec),-DHAVE_DNSSEC) \
		$(if $(CONFIG_PACKAGE_dnsmasq_$(BUILD_VARIANT)_auth),,-DNO_AUTH) \
		$(if $(CONFIG_PACKAGE_dnsmasq_$(BUILD_VARIANT)_ipset),,-DNO_IPSET) \
		$(if $(CONFIG_PACKAGE_dnsmasq_$(BUILD_VARIANT)_conntrack),-DHAVE_CONNTRACK,) \
		$(if $(CONFIG_PACKAGE_dnsmasq_$(BUILD_VARIANT)_noid),-DNO_ID,) \
		$(if $(CONFIG_PACKAGE_dnsmasq_$(BUILD_VARIANT)_broken_rtc),-DHAVE_BROKEN_RTC)
	COPTS += $(if $(CONFIG_LIBNETTLE_MINI),-DNO_GMP,)
else
	COPTS += -DNO_AUTH -DNO_IPSET -DNO_ID
endif

MAKE_FLAGS := \
	$(TARGET_CONFIGURE_OPTS) \
	CFLAGS="$(TARGET_CFLAGS) $(TARGET_CPPFLAGS)" \
	LDFLAGS="$(TARGET_LDFLAGS)" \
	COPTS="$(COPTS)" \
	PREFIX="/usr"

define Package/dnsmasq/install
	$(INSTALL_DIR) $(1)/usr/sbin
	$(CP) $(PKG_INSTALL_DIR)/usr/sbin/dnsmasq $(1)/usr/sbin/
	$(INSTALL_DIR) $(1)/etc/config
	$(INSTALL_DATA) ./files/dhcp.conf $(1)/etc/config/dhcp
	$(INSTALL_DATA) ./files/dnsmasq.conf $(1)/etc/dnsmasq.conf
	$(INSTALL_DIR) $(1)/etc/init.d
	$(INSTALL_BIN) ./files/dnsmasq.init $(1)/etc/init.d/dnsmasq
	$(INSTALL_DIR) $(1)/etc/hotplug.d/ntp
	$(INSTALL_DATA) ./files/dnsmasqsec.hotplug $(1)/etc/hotplug.d/ntp/25-dnsmasqsec
endef

Package/dnsmasq-dhcpv6/install = $(Package/dnsmasq/install)

define Package/dnsmasq-full/install
$(call Package/dnsmasq/install,$(1))
ifneq ($(CONFIG_PACKAGE_dnsmasq_full_dnssec),)
	$(INSTALL_DIR) $(1)/usr/share/dnsmasq
	$(INSTALL_DATA) $(PKG_BUILD_DIR)/trust-anchors.conf $(1)/usr/share/dnsmasq
endif
endef

$(eval $(call BuildPackage,dnsmasq))
$(eval $(call BuildPackage,dnsmasq-dhcpv6))
$(eval $(call BuildPackage,dnsmasq-full))

1.1.1.1 rules.mk文件中经常使用的变量

  • INCLUDE_DIR : 源代码目录下的include目录
  • BUILD_DIR : 代码编译的根目录,通常为build_dir/target-
  • TARGET_CFLAGS : 指定目标平台的C语言编译选项
  • TARGET_LDFLAGS : 指定目标平台的编译连接选项
  • INSTALL_DIR : 创建目录,并设置目录权限
  • INSTALL_DATA : 安装数据文件,并设置权限为0644
  • INSTALL_CONF : 安装配置文件,并设置权限为0600
  • INSTALL_BIN : 安装可执行文件,并设置权限为0777

1.1.1.2 Makefile常用变量

变量 含义 示例
PKG_NAME 软件包名称
PKG_VERSION 版本号
PKG_RELEASE Makefile的版本
PKG_SOURCE 原始代码文件名
PKG_SOURCE_URL 下载源码的地址
PKG_MD5SUM 软件包的MD5值
PKG_LICENSE 这个软件的许可协议
PKG_LICENSE_FILES 许可协议文件
PKG_BUILD_DIR 软件包的编译目录
PKG_INSTALL 设置为1将调用软件包自己的“make install”,安装目录前缀为PKG_INSTALL_DIR
PKG_BUILD_PARALLEL 是否可以并行编译,“并行为1”
PKG_CONFIG_DEPENDS 编译依赖,指定那些选项依赖本软件包
PKG_INSTALL_DIR 调用原始软件包“make install”的安装目录
PKG_SOURCE_PROTO 用于下载的传输协议(git,svn)。如果为压缩包则不用指定
PKG_SOURCE_SUBDIR 下载目录,如果下载传输协议为:git svn时需要指定 PKG_SOURCE_SUBDIR:=$(PKG_NAME)-$(PKG_VERSION)
PKG_SOURCE_VERSION 下载协议为“git”时必须指定
PKG_MAINTAINER 维护者的姓名和邮箱
PKG_BUILD_DEPENDS 软件包编译依赖,即需要在这个包编译之前编译

1.1.1.3 软件包定义

软件包定义用于编译前的软件包选择和编译后的IPKG安装包生成。这些参数传递给buildroot进行交叉编译
Package/开头,Package开头的定义用于make menuconfig,选择编译生成的软件包
Build/开头,这些用于代码编译


  • Package选项
  1. SECTION:软件包的类型。eg: betwork、Sound
  2. CATEGORY:在menuconfig中显示到菜单分类中
  3. TITLE:标题,是软包的简短描述
  4. URL:软件包的原始网站地址
  5. MAINTAINER:维护者的姓名和邮件地址
  6. DEPENDS:依赖项,需要在本软件包之前安装的软件包
define Package/dnsmasq/Default
  SECTION:=net
  CATEGORY:=Base system
  TITLE:=DNS and DHCP server
  URL:=http://www.thekelleys.org.uk/dnsmasq/
  USERID:=dnsmasq=453:dnsmasq=453
endef

  • Package的选项
  1. Package/<>
    定义软件包的描述信息
  2. Package/<>/Default
    可选。软件包的默认选项
  3. Package/<>/description
    软包的详细描述
  4. Package/<>/install
    复制文件到ipkg目录中,使用$(1)代表ipkg目录
  5. Package/<>/config
    可选。对编译选项进行定义
  6. Package/<>/conffiles
    可选。定义本软件包的运行配置文件列表。一行一个文件
  7. Package/<>/preinst
    可选。安装之前实际执行的脚本
  8. Package/<>/postinst
    可选。安装完成之后执行的脚本
  9. Package/<>/prerm
    可选。在删除之前执行的脚本
  10. Package/<>/postrm
    可选。在删除之后执行的脚本

1.1.1.4 软件包的构建

软件包的编译步骤为:准备(Prepare)、配置(Configure)、编译(Compile)、安装(Install)
MAKE_FLAGS:指定编译选项
CONFIGURE_ARGS:指定配置选项
以上变量在package-default.mk中定义

  • Build/Prepare
    可选,用于解包和打补丁命令。
  • Build/Configure
    可选
  • Build/Compile
    可选,编译代码
  • Build/Install
    可选。安装编译后的命令。默认使用make install
  • Build/InstallDev
    可选。只对静态库和头文件等

1.1.2 软件包的编译

单独编译

make package/hello/build
make package/hello/install
make package/hello/{clean,compile,install}

加入平台编译(两种方法)

  • 使用make menuconfig选择hello软件包
  • 直接修改.config在其中添加CONFIG_PACKAGE_hello=y,(这个名字在软件包中定义)

1.1.3 软件的启动机制

启动机制

init进程是所有系统进程的父进程,它被内核调用并负责调用所有其他进程。如果其他进程的父进程退出,则init进程会成为它的父进程
内核启动后会调用/etc/inittab,然后执行inittab中的sysinit所指的脚本

cat /etc/inittab 
::sysinit:/etc/init.d/rcS S boot
::shutdown:/etc/init.d/rcS K shutdown
::askconsole:/bin/login

内核调用/etc/inittab,然后调用脚本/etc/init.d/rcS。再由rcS逐个启动各个软件进程
OpenWrt会将需要自启动的软件在/etc/rc.d目录下创建对应的软链接。之后由rcS按照软链接的顺序执行就ok了(所有的启动脚本都放在/etc/init.d下面。然后软链接到/etc/rc.d
设备将以/etc/rc.d/S开头的脚本按顺序传递给rcS

原文地址:https://www.cnblogs.com/burnk/p/15806934.html