如何去写 Android init.rc (Android init language)

转自：http://www.cnblogs.com/sdphome/archive/2011/03/20/1989806.html
如何去写 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

Services

---

Services 是由 init 启动 ，在它们退出时重启 ( 可选 ) 。 Service 表现形式为 :

service [ ]*

…

Options

---

Options 是 Services 的修饰，它们影响 init 何时、如何运行 service .

critical

 这是一个设备关键服务 (device-critical service) . 如果它在 4 分钟内退出超过 4 次，设备将重启并进入恢复模式。

disabled

 这个服务的级别将不会自动启动，它必须被依照服务名指定启动才可以启动。

setenv

 设置已启动的进程的环境变量 <name> 的值 <value>

socket [ [ ] ]

 创建一个名为 /dev/socket/<name> 的 unix domin socket ，并传送它的 fd 到已启动的进程。 <type> 必须为 "dgram" 或 "stream". 用户和组默认为 0.

user

 在执行服务前改变用户名。当前默认为 root. 如果你的进程需要 linux 能力，你不能使用这个命令。你必须在还是 root 时请求能力，并下降到你需要的 uid.

group [ ]*

 在执行服务前改变组。在第一个组后的组将设为进程附加组 ( 通过 setgroups()). 当前默认为 root.

oneshot

 在服务退出后不重启。

class

 为 service 指定一个类别名。同样类名的所有的服务可以一起启动或停止。如果没有指定类别的服务默认为 "default" 类。

onrestart

   当服务重启时执行一个命令。

Triggers

---

 Triggers( 触发器 ) 是一个字符串，可以用来匹配某种类型的事件并执行一个 action 。

boot

 这是当 init 开始后执行的第一个触发器 ( 当 /init.conf 被加载 )

=

 当 property <name> 被设为指定的值 <value> 时触发。

device-added-

device-removed-

 当设备节点被添加或移除时触发。

service-exited-

 当指定的服务存在时触发

Commands

---

exec [ ]*

 Fork 并执行一个程序 (<path>). 这将被 block 直到程序执行完毕。最好避免执行例如内建命令以外的程序，它可能会导致 init 被阻塞不动。

export

 设定全局环境变量 <name> 的值 <value> ，当这个命令执行后所有的进程都可以取得。

ifup

 使网络接口 <interface> 联机。

import

 解析一个 init 配置文件，扩展当前配置文件。

hostname

 设置主机名

chmod

 改变文件访问权限

chown

 改变文件所属和组

class_start

 当指定类别的服务没有运行，启动该类别所有的服务。

class_stop

 当指定类别的服务正在运行，停止该类别所有的服务。

domainname

 设置域名。

insmod

 加载该路径 <path> 的模块

mkdir [mode] [owner] [group]

 在 <path> 创建一个目录 , 可选选项 :mod,owner,group. 如果没有指定，目录以 755 权限， owner 为 root,group 为 root 创建 .

mount

[ ]*

 尝试 mount <device> 到目录 <dir>. <device> 可以用 mtd@name 格式以命名指定一个 mtd 块设备。 <mountoption> 包含 "ro","rw","remount","noatime".

setkey

 暂时没有

setprop

 设置系统 property <name> 的值 <value>.

setrlimit

 设置 resource 的 rlimit.

start

 启动一个没有运行的服务。

stop

 停止一个正在运行的服务 。

symlink

 创建一个 <path> 的符号链接到 <target>

sysclktz

 设置系统时区 (GMT 为 0)

trigger

 触发一个事件。用于调用其它 action 。

write [ ]*

 打开 <path> 的文件并写入一个或多个字符串。

Properties

---

Init 会更新一些系统 property 以提供查看它正在干嘛。

init.action

 当前正在执行的 action, 如果没有则为 ""

init.command

 被执行的命令，如果没有则为 ""

init.svc.

 命名为 <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