1. 简述
2. 关键字
3. 语句解析
1. 动作Action
2. 服务services
3. 选项options
4. 触发器trigger
5. 命令commands
6. 属性Properties
5. 调试注意事项
本文主要来自$ANDROID_SOURCE/system/init/readme.txt的翻译.
Android init.rc文件由系统第一个启动的init程序解析,此文件由语句组成,主要包含了四种类型的语句:Action,Commands,Services,Options.在init.rc文件中一条语句通常是占据一行.单词之间是通过空格符来相隔的.如果需要在单词内使用空格,那么得使用转义字符"\",如果在一行的末尾有一个反斜杠,那么是换行折叠符号,应该和下一行合并成一起来处理,这样做主要是为了避免一行的字符太长,与C语言中的含义是一致的。注释是以#号开头。 Action和services显式声明了一个语句块,而commands和options属于最近声明的语句块。在第一个语句块之前 的commands和options会被忽略.
在具体讲解这之前,有些关键词得先了解.
token: 计算机语言中的一个单词,就跟英文中的单词差不多一人概念.
Section: 语句块,相当于C语言中大括号内的一个块。一个Section以Service或On开头的语句块.以Service开头的Section叫做服务,而以On开头的叫做动作(Action).
services: 服务.
Action: 动作
commands:命令.
options:选项.
trigger:触发器,或者叫做触发条件.
class: 类属,即可以为多个service指定一个相同的类属,方便操作同时启动或停止.
动作表示了一组命令(commands)组成.动作包含一个触发器,决定了何时执行这个动作。当触发器的条件满足时,这个动作会被加入到已被执行的队列尾。如果此动作在队列中已经存在,那么它将不会执行.
一个动作所包含的命令将被依次执行。动作的语法如下所示:
[plain] view plaincopy
1. on <trigger>
2. <command>
3. <command>
4. <command>
服务是指那些需要在系统初始化时就启动或退出时自动重启的程序.
它的语法结构如下所示:
[plain] view plaincopy
1. service <name> <pathname> [ <argument> ]*
2. <option>
3. <option>
4. ...
选项是用来修改服务的。它们影响如何及何时运行这个服务.
选项 | 描述 |
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 | 当服务重启时执行一条指令, |
触发器用来描述一个触发条件,当这个触发条件满足时可以执行动作.
触发器 | 描述 |
boot | 当init程序执行,并载入/init.conf文件时触发. |
<name>=<value> | 当属性名对应的值设置为指定值时触发. |
device-added-<path> | 当添加设备时触发. |
device-removed-<path> | 当设备移除时触发. |
service-exited-<name> | 当指定的服务退出时触发. |
命令 | 描述 |
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> ]* | 往指定的文件写字符串. |
init程序在运行时会更新属性系统的一些属性,提供程序内部正在执行的信息.
属性名 | 描述 |
init.action | 当前正在执行的动作,如果没有则为空字符串"" |
init.command | 当前正在执行的命令.没有则为空字符串. |
init.svc.<name> | 当前某个服务的状态,可为"stopped", "running", "restarting" |
[plain] view plaincopy
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.
在默认情况下,通过init程序启动的程序的标准输出stdout和标准错误输出stderr会重定向到/dev/null.如:
[plain] view plaincopy
1. service akmd /system/bin/logwrapper /sbin/akmd
为了更方便调试你的程序,你可以使用Android的log系统,标准输出和标准错误输出会重定义到Android的log系统中来.