android init.rc语法标准

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

参考：http://blog.163.com/fenglang_2006/blog/static/13366231820108203223442/