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

http://www.cnblogs.com/sdphome/archive/2011/03/20/1989806.html

 

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

分类: android