Android init.rc文件浅析

本文主要来自$ANDROID_SOURCE/system/init/readme.txt的翻译.

1 简述

Android init.rc文件由系统第一个启动的init程序解析，此文件由语句组成，主要包含了四种类型的语句:Action,Commands,Services,Options.在init.rc文件中一条语句通常是占据一行.单词之间是通过空格符来相隔的.如果需要在单词内使用空格，那么得使用转义字符"\",如果在一行的末尾有一个反斜杠，那么是换行折叠符号，应该和下一行合并成一起来处理，这样做主要是为了避免一行的字符太长，与C语言中的含义是一致的。注释是以#号开头。 Action和services显式声明了一个语句块，而commands和options属于最近声明的语句块。在第一个语句块之前 的commands和options会被忽略.

在具体讲解这之前，有些关键词得先了解.

2 关键字

token:  计算机语言中的一个单词，就跟英文中的单词差不多一人概念.

Section: 语句块，相当于C语言中大括号内的一个块。一个Section以Service或On开头的语句块.以Service开头的Section叫做服务,而以On开头的叫做动作(Action).

services: 服务.

Action: 动作

commands:命令.

options:选项.

trigger:触发器，或者叫做触发条件.

class: 类属，即可以为多个service指定一个相同的类属，方便操作同时启动或停止.

3 语句解析

3.1 动作(Action)

动作表示了一组命令(commands)组成.动作包含一个触发器，决定了何时执行这个动作。当触发器的条件满足时，这个动作会被加入到已被执行的队列尾。如果此动作在队列中已经存在，那么它将不会执行.

 一个动作所包含的命令将被依次执行。动作的语法如下所示:

[plain]  view plain copy

1. on <trigger>  
2.    <command>  
3.    <command>  
4.    <command>  

3.2 服务(services)

服务是指那些需要在系统初始化时就启动或退出时自动重启的程序.

它的语法结构如下所示:

[plain]  view plain copy

1. service <name> <pathname> [ <argument> ]*  
2.    <option>  
3.    <option>  
4.    ...  

3.3 选项（options)

选项是用来修改服务的。它们影响如何及何时运行这个服务.

选项	描述
critical	据设备相关的关键服务，如果在4分钟内，此服务重复启动了4次，那么设备将会重启进入还原模式。
disabled	服务不会自动运行，必须显式地通过服务器来启动。
setenv <name> <value>	设置环境变量
socket <name> <type> <perm> [ <user> [ <group> ] ]	在/dev/socket/下创建一个unix domain的socket，并传递创建的文件描述符fd给服务进程.其中type必须为dgram或stream,seqpacket.用户名和组名默认为0
user <username>	在执行此服务之前先切换用户名。当前默认为root.
group <groupname> [ <groupname> ]*	类似于user,切换组名
oneshot	当此服务退出时不会自动重启.
class <name>	给服务指定一个类属,这样方便操作多个服务同时启动或停止.默认情况下为default.
onrestart	当服务重启时执行一条指令，

3.4 触发器(trigger)

触发器用来描述一个触发条件，当这个触发条件满足时可以执行动作.

触发器	描述
boot	当init程序执行，并载入/init.conf文件时触发.
<name>=<value>	当属性名对应的值设置为指定值时触发.
device-added-<path>	当添加设备时触发.
device-removed-<path>	当设备移除时触发.
service-exited-<name>	当指定的服务退出时触发.

3.5 命令(commands)

命令	描述
exec <path> [ <argument> ]*	执行指定路径下的程序，并传递参数.
export <name> <value>	设置全局环境参数，此参数被设置后对所有进程都有效.
ifup <interface>	使指定的网络接口"上线",相当激活指定的网络接口
import <filename>	导入一个额外的init配置文件.
hostname <name>	设置主机名
chdir <directory>	改变工作目录.
chmod <octal-mode> <path>	改变指定文件的读取权限.
chown <owner> <group> <path>	改变指定文件的拥有都和组名的属性.
chroot <directory>	改变进行的根目录.
class_start <serviceclass>	启动指定类属的所有服务，如果服务已经启动，则不再重复启动.
class_stop <serviceclass>	停止指定类属的所胡服务.
domainname <name>	设置域名
insmod <path>	安装模块到指定路径.
mkdir <path> [mode] [owner] [group]	用指定参数创建一个目录，在默认情况下，创建的目录读取权限为755.用户名为root,组名为root.
mount <type> <device> <dir> [ <mountoption> ]*	类似于linux的mount指令
setkey	TBD(To Be Determined),待定.
setprop <name> <value>	设置属性及对应的值.
setrlimit <resource> <cur> <max>	设置资源的rlimit(资源限制），不懂就百度一下rlimit
start <service>	如果指定的服务未启动，则启动它.
stop <service>	如果指定的服务当前正在运行，则停止它.
symlink <target> <path>	创建一个符号链接.
sysclktz <mins_west_of_gmt>	设置系统基准时间.
trigger <event>	Trigger an event.  Used to queue an action from another action.这名话没有理解，望高手指点.
write <path> <string> [ <string> ]*	往指定的文件写字符串.

3.6 属性(Properties)

init程序在运行时会更新属性系统的一些属性，提供程序内部正在执行的信息.

属性名	描述
init.action	当前正在执行的动作，如果没有则为空字符串""
init.command	当前正在执行的命令.没有则为空字符串.
init.svc.<name>	当前某个服务的状态，可为"stopped", "running", "restarting"

4 一个 init.conf例子

[plain]  view plain copy

1. # not complete -- just providing some examples of usage  
2. #  
3. on boot  
4.    export PATH /sbin:/system/sbin:/system/bin  
5.    export LD_LIBRARY_PATH /system/lib  
6.   
7.    mkdir /dev  
8.    mkdir /proc  
9.    mkdir /sys  
10.   
11.    mount tmpfs tmpfs /dev  
12.    mkdir /dev/pts  
13.    mkdir /dev/socket  
14.    mount devpts devpts /dev/pts  
15.    mount proc proc /proc  
16.    mount sysfs sysfs /sys  
17.   
18.    write /proc/cpu/alignment 4  
19.   
20.    ifup lo  
21.   
22.    hostname localhost  
23.    domainname localhost  
24.   
25.    mount yaffs2 mtd@system /system  
26.    mount yaffs2 mtd@userdata /data  
27.   
28.    import /system/etc/init.conf  
29.   
30.    class_start default  
31.   
32. service adbd /sbin/adbd  
33.    user adb  
34.    group adb  
35.   
36. service usbd /system/bin/usbd -r  
37.    user usbd  
38.    group usbd  
39.    socket usbd 666  
40.   
41. service zygote /system/bin/app_process -Xzygote /system/bin --zygote  
42.    socket zygote 666  
43.   
44. service runtime /system/bin/runtime  
45.    user system  
46.    group system  
47.   
48. on device-added-/dev/compass  
49.    start akmd  
50.   
51. on device-removed-/dev/compass  
52.    stop akmd  
53.   
54. service akmd /sbin/akmd  
55.    disabled  
56.    user akmd  
57.    group akmd  
58.    

5 调试注意事项

在默认情况下，通过init程序启动的程序的标准输出stdout和标准错误输出stderr会重定向到/dev/null.如:

[plain]  view plain copy

1. service akmd /system/bin/logwrapper /sbin/akmd  

为了更方便调试你的程序，你可以使用Android的log系统，标准输出和标准错误输出会重定义到Android的log系统中来.