1. 简介
init.rc由许多的Action和Service组成。
每一个语句占据一行,并且各个关键字被空格分开。c规范中的(如 /n)反斜杠将被忽略(backslash escapes)而被认为是一个空格 ,双引号用来保证空格不会把一个文字串分分为多个关键字。行最后的反斜杠用作续行。
由 # (前面允许有空格)开始的行都是注释行(comment)
一个actions 或 services 的开始隐含声明了一个新的段,所有commands 或 options 属于最近的声明。在第一个段之前的 commands 或 options 都会被忽略
每一个actions 和 services 都有不同的名字。后面与前面发生重名的,那么这个后面重名的将被忽略或被认为是一个错误。
2. Action
action其实就是一组被命名的命令序列。actions 都有一个触发条件,触发条件决定了action何时执行。当一个事件发生如果匹配action的触发条件,那么这个action将会被添加到预备执行队列的尾部(除非它已经在队列当中)
每一个action中的命令将被顺序执行。init进程负责在其它activities(如:设备创建/销毁,属性设置,进程重启)之间执行这些命令序列。
每一个action格式如下:
on <trigger>
<command>
<command>
...
2.1 Trigger
trigger是一个action触发的条件,一共有如下几种:
1) boot
发生在init启动时,/init.conf被加载以后。
2) <name>=<value>
发生在名字为<name>的属性的值被设置为<value>时。
3) device-added-<path>/device-removed-<path>
当一个device node被添加/删除时。
4) service-exited-<name>当某个服务退出时。
Triggers are strings used to match certain kinds of events that cause an action to occur.
Trigger | Description |
---|---|
boot | This is the first trigger that occurs when init starts (after /init.conf is loaded). |
<name>=<value> | Triggers of this form occur when the property <name> is set to the specific value<value> . |
device-added-<path> | Triggers of these forms occur when a device node is added or removed. |
service-exited-<name> | Triggers of this form occur when the specified service exits. |
2.2 Command
command一共有如下几种:
1) exec <path> [<argument>]*
fork并execute一个路径<path>下面的程序,直到程序执行完毕后,init才会继续前进。尽量避免使用这个command,它有可能导致init阻塞。其它command不存在这个问题。
2) export <name> <value>
把全局环境变量<name>的值设置为<value>。这个命令执行完毕以后启动的所有进程都会继承这个全局变量。
3) ifup <interface>
Bring the network interface <interface> online.(打开某个网卡)
4) import <filename>
Parse an init config file, extending the current configuration.
5) hostname <name>
Set the host name.
6) class_start <serviceclass>
如果某一类service没有运行,启动它们。
7) class_stop <serviceclass>
如果某一类service正在运行,停止它们。
8) domainname <name>
Set the domain name.
9) insmod <path>
安装路径<path>指定的模块。
10) mkdir <path>
创建<path>代表的文件夹,只能一层层地创建。
11) mount <type> <device> <dir> [ <mountoption> ]*
把<device>挂载到系统类型为<type>的文件系统的<dir>目录下。<device>可能有mtd@name的形式,代表名字为name的mtd块设备。
12) setkey
未定义
13) setprop <name> <value>
设置系统属性。
14) setrlimit <resource> <cur> <max>
Set the rlimit for a resource.
15) start <service>
如果服务没有运行,启动它。
16) stop <service>
如果服务正在运行,停止它。
17) symlink <target> <path>
把<target>链接到目录<path>下。
18) write <path> <string> [ <string> ]*
打开<path>所指的文件,并把<string>写入。
关于3、5、8,参见init.rc里面的
on boot
# basic network init
ifup lo
hostname localhost
domainname localdomain
关于14,参见init.rc里面的
# set RLIMIT_NICE to allow priorities from 19 to -20
setrlimit 13 40 40
Command | Description |
---|---|
exec <path> [ <argument> ]* | Fork and execute a program (<path> ). This will block until the program completes execution. Try to avoid exec. Unlike thebuiltin commands, it runs the risk of getting init "stuck". |
export <name> <value> | Set the environment variable <name> equal to<value> in the global environment (which will be inherited by all processes started after this command is executed). |
ifup <interface> | Bring the network interface <interface> online. |
import <filename> | Parse an init config file, extending the current configuration. |
hostname <name> | Set the host name. |
class_start <serviceclass> | Start all services of the specified class if they are not already running. |
class_stop <serviceclass> | Stop all services of the specified class if they are currently running. |
domainname <name> | Set the domain name. |
insmod <path> | Install the module at <path> . |
mkdir <path> | Make a directory at <path> . |
mount <type> <device> <dir> [ <mountoption> ]* | Attempt to mount the named device at the directory<dir> <device> . This may be of the form mtd@name to specify a mtd block device by name. |
setkey | - currenlty undefined - |
setprop <name> <value> | Set system property <name> to <value> . |
setrlimit <resource> <cur> <max> | Set the rlimit for a resource. |
start <service> | Start a service running if it is not already running. |
stop <service> | Stop a service from running if it is currently running. |
symlink <target> <path> | Create a symbolic link at <path> with the value<target> . |
write <path> <string> [ <string> ]* | Open the file at <path> and write one or more strings to it with write(2). |
3. Service
Service是一些由init 启动或重新(如果有需要)启动的程序,当然这些程序如果是存在的。
每一个service格式如下:
service <name> <pathname> [ <argument> ]*
<option>
<option>
...
option是service的修饰符,用来告诉init 怎样及何时启动service。一共有如下几种:
1) disabled
这个服务不能通过启动一类服务来启动,只能单独以名字来启动。
2) socket <type> <name> <perm> [ <user> [ <group> ] ]
创建一个名字为/dev/socket/<name>的unix domain socket,并把它的fd传递给加载的进程。<type>的值是dgram或stream。user和group默认值是0.
注意:在init.rc中使用socket时,<type>是放在<name>之后的。
3) user <username>
在启动服务之前,把用户名切换到<username>。默认是root
4) group <groupname> [ <groupname> ]*
在启动服务之前,把组名切换到<groupname>。一个服务可能属于多个组。
5) capability [ <capability> ]+
Set linux capability before executing this service
6) oneshot
服务之运行一次,退出后不再重启。
7) class <name>
为服务设定一个类别,一个类别是中的服务可以同时启动或停止。如果没有这个属性,服务的默认类别是“default”
8) console
服务的STDIO被重定向到/dev/console,而不是默认的/dev/null
默认情况下,通过init启动的程序都会把stdout和stderr定向到/dev/null。有时为了调试方便,可以通过Android的logwrapper程序启动某个程序。这样,被启动程序stdout和stderr就被定向到了Android的LOG系统中,可以通过logcat来查看了。
例如:
service akmd /system/bin/logwraper /sbin/akmd
Option | Description |
---|---|
disabled | This service will not automatically start with its class. It must be explicitly started by name. |
socket <type> <name> <perm> [ <user> [ <group> ] ] | Create a unix domain socket named |
user <username> | Change to username before exec'ing this service. Currently defaults to root. |
group <groupname> [ <groupname> ]* | Change to groupname before exec'ing this service. Additional groupnames beyond the first, which is required, are used to set additional groups of the process (withsetgroups() ). Currently defaults to root. |
capability [ <capability> ]+ | Set linux capability before exec'ing this service |
oneshot | Do not restart the service when it exits. |
class <name> | Specify a class name for the service. All services in a named class must start and stop together. A service is considered of class "default" if one is not specified via the class option. |
4. Property
init程序在运行过程中可能会设置几个特殊属性的值,来告诉其它程序它正在做什么。这些属性是:
1) init.action
当前正在执行的action的名字,如果没有,就是“”。
2) init.command
当前正在执行的command的名字,如果没有,就是“”。
3) init.svc.<name>
一个服务的状态。可能的值有:“stopped”,"running","restarting"
Property | Description |
---|---|
init.action | Equal to the name of the action currently being executed or "" if none. |
init.command | Equal to the command being executed or "" if none. |
init.svc.<name> | State of a named service ("stopped", "running", or "restarting"). |
在init.rc中使用属性的范例如下:
setprop ro.FOREGROUND_APP_MEM 1536 setprop ro.VISIBLE_APP_MEM 2048 on property:ro.kernel.qemu=1 start adbd |
setprop用于设置属性,on property可以用于判断属性,这里的属性在整个Android系统运行中都是一致的。
英文描述参见:/system/core/init/readme.txt
init脚本中的关键字参见:system/core/init/keywords.h