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)组成.动作包含一个触发器，决定了何时执行这个动作。当触发器的条件满足时，这个动作会被加入到已被执行的队列尾。如果此动作在队列中已经存在，那么它将不会执行.
一个动作所包含的命令将被依次执行。动作的语法如下所示:
- on <trigger>
- <command>
- <command>
- <command>
3.2 服务(services)
服务是指那些需要在系统初始化时就启动或退出时自动重启的程序.
它的语法结构如下所示:
- service <name> <pathname> [ <argument> ]*
- <option>
- <option>
- ...
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例子
- # not complete -- just providing some examples of usage
- #
- on boot
- export PATH /sbin:/system/sbin:/system/bin
- export LD_LIBRARY_PATH /system/lib
- mkdir /dev
- mkdir /proc
- mkdir /sys
- mount tmpfs tmpfs /dev
- mkdir /dev/pts
- mkdir /dev/socket
- mount devpts devpts /dev/pts
- mount proc proc /proc
- mount sysfs sysfs /sys
- write /proc/cpu/alignment 4
- ifup lo
- hostname localhost
- domainname localhost
- mount yaffs2 mtd@system /system
- mount yaffs2 mtd@userdata /data
- import /system/etc/init.conf
- class_start default
- service adbd /sbin/adbd
- user adb
- group adb
- service usbd /system/bin/usbd -r
- user usbd
- group usbd
- socket usbd 666
- service zygote /system/bin/app_process -Xzygote /system/bin --zygote
- socket zygote 666
- service runtime /system/bin/runtime
- user system
- group system
- on device-added-/dev/compass
- start akmd
- on device-removed-/dev/compass
- stop akmd
- service akmd /sbin/akmd
- disabled
- user akmd
- group akmd
5 调试注意事项
在默认情况下，通过init程序启动的程序的标准输出stdout和标准错误输出stderr会重定向到/dev/null.如:
- service akmd /system/bin/logwrapper /sbin/akmd
为了更方便调试你的程序，你可以使用Android的log系统，标准输出和标准错误输出会重定义到Android的log系统中来.
===================================================================================================================
Android init.rc (Android init language)
Android初始化语言由四大类声明组成:行为类(Actions),命令类(Commands)，服务类(Services),选项类(Options).
* 初始化语言以行为单位，由以空格间隔的语言符号组成。C风格的反斜杠转义符可以用来插入空白到语言符号。双引号也可以用来防止文本被空格分成多个语言符号。当反斜杠在行末时，作为折行符。
* 以#开始(前面允许有空格)的行为注释行。
* Actions和Services隐含声明一个新的段落。所有该段落下Commands或Options的声明属于该段落。第一段落前的Commands或Options被忽略。
* Actions和Services拥有独一无二的命名。在它们之后声明相同命名的类将被当作错误并忽略。
Actions
-------
Actions是一系列命令的命名。Actions拥有一个触发器(trigger)用来决定action何时执行。当一个action在符合触发条件被执行时，如果它还没被加入到待执行队列中的话，则加入到队列最后。
队列中的action依次执行，action中的命令也依次执行。Init在执行命令的中间处理其它活动(设备创建/销毁,property设置，进程重启)。
Actions表现形式为：
on <trigger>
<command>
<command>
<command>
Services
--------
Services是由init启动，在它们退出时重启(可选)。Service表现形式为:
service <name> <pathname> [ <argument> ]*
<option>
<option>
...
Options
-------
Options是Services的修饰，它们影响init何时、如何运行service.
critical
这是一个设备关键服务(device-critical service) .如果它在4分钟内退出超过4次，设备将重启并进入恢复模式。
disabled
这个服务的级别将不会自动启动，它必须被依照服务名指定启动才可以启动。
setenv <name> <value>
设置已启动的进程的环境变量<name>的值<value>
socket <name> <type> <perm> [ <user> [ <group> ] ]
创建一个名为/dev/socket/<name>的unix domin socket，并传送它的fd到已启动的进程。<type>必须为"dgram"或"stream".用户和组默认为0.
user <username>
在执行服务前改变用户名。当前默认为root.如果你的进程需要linux能力，你不能使用这个命令。你必须在还是root时请求能力，并下降到你需要的uid.
group <groupname> [ <groupname> ]*
在执行服务前改变组。在第一个组后的组将设为进程附加组(通过setgroups()).当前默认为root.
oneshot
在服务退出后不重启。
class <name>
为service指定一个类别名。同样类名的所有的服务可以一起启动或停止。如果没有指定类别的服务默认为"default"类。
onrestart
当服务重启时执行一个命令。
Triggers
--------
Triggers(触发器)是一个字符串，可以用来匹配某种类型的事件并执行一个action。
boot
这是当init开始后执行的第一个触发器(当/init.conf被加载)
<name>=<value>
当property <name>被设为指定的值<value>时触发。
device-added-<path>
device-removed-<path>
当设备节点被添加或移除时触发。
service-exited-<name>
当指定的服务存在时触发
Commands
--------
exec <path> [ <argument> ]*
Fork并执行一个程序(<path>).这将被block直到程序执行完毕。最好避免执行例如内建命令以外的程序，它可能会导致init被阻塞不动。
export <name> <value>
设定全局环境变量<name>的值<value>，当这个命令执行后所有的进程都可以取得。
ifup <interface>
使网络接口<interface>联机。
import <filename>
解析一个init配置文件，扩展当前配置文件。
hostname <name>
设置主机名
chmod <octal-mode> <path>
改变文件访问权限
chown <owner> <group> <path>
改变文件所属和组
class_start <serviceclass>
当指定类别的服务没有运行，启动该类别所有的服务。
class_stop <serviceclass>
当指定类别的服务正在运行，停止该类别所有的服务。
domainname <name>
设置域名。
insmod <path>
加载该路径<path>的模块
mkdir <path> [mode] [owner] [group]
在<path>创建一个目录,可选选项:mod,owner,group.如果没有指定，目录以755权限，owner为root,group为root创建.
mount <type> <device> <dir> [ <mountoption> ]*
尝试mount <device>到目录<dir>. <device>可以用mtd@name格式以命名指定一个mtd块设备。<mountoption>包含"ro","rw","remount","noatime".
setkey
暂时没有
setprop <name> <value>
设置系统property <name>的值<value>.
setrlimit <resource> <cur> <max>
设置resource的rlimit.
start <service>
启动一个没有运行的服务。
stop <service>
停止一个正在运行的服务。
symlink <target> <path>
创建一个<path>的符号链接到<target>
sysclktz <mins_west_of_gmt>
设置系统时区(GMT为0)
trigger <event>
触发一个事件。用于调用其它action。
write <path> <string> [ <string> ]*
打开<path>的文件并写入一个或多个字符串。
Properties
----------
Init会更新一些系统property以提供查看它正在干嘛。
init.action
当前正在执行的action,如果没有则为""
init.command
被执行的命令，如果没有则为""
init.svc.<name>
命名为<name>的服务的状态("stopped", "running", "restarting")
init.rc 示例:
-----------------
# not complete -- just providing some examples of usage
#
on boot
export PATH /sbin:/system/sbin:/system/bin
export LD_LIBRARY_PATH /system/lib
mkdir /dev
mkdir /proc
mkdir /sys
mount tmpfs tmpfs /dev
mkdir /dev/pts
mkdir /dev/socket
mount devpts devpts /dev/pts
mount proc proc /proc
mount sysfs sysfs /sys
write /proc/cpu/alignment 4
ifup lo
hostname localhost
domainname localhost
mount yaffs2 mtd@system /system
mount yaffs2 mtd@userdata /data
import /system/etc/init.conf
class_start default
service adbd /sbin/adbd
user adb
group adb
service usbd /system/bin/usbd -r
user usbd
group usbd
socket usbd 666
service zygote /system/bin/app_process -Xzygote /system/bin --zygote
socket zygote 666
service runtime /system/bin/runtime
user system
group system
on device-added-/dev/compass
start akmd
on device-removed-/dev/compass
stop akmd
service akmd /sbin/akmd
disabled
user akmd
group akmd
调试
---------------
默认情况下，init执行的程序输出的信息和错误到/dev/null.为了debug，你可以通过Android程序logwrapper执行你的程序。这将复位向输出/错误输出到Android logging系统(通过logcat访问)。
例如
service akmd /system/bin/logwrapper /sbin/akmd
扫一扫
802
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
