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>

Services

--------

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

service <name> <pathname> [ <argument> ]*

...

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 被加载)

当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> 可以用[email protected] 格式以命名指定一个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[email protected] /system

mount yaffs2[email protected] /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

更多相关文章

随机推荐