如何写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

 

 

init.rc由许多的Action和Service组成。

每一个语句占据一行，并且各个关键字被空格分开。c规范中的（如 /n）反斜杠将被忽略(backslash escapes)而被认为是一个空格 ，双引号用来保证空格不会把一个文字串分分为多个关键字。行最后的反斜杠用作续行。

由 # （前面允许有空格）开始的行都是注释行(comment)

一个actions 或 services 的开始隐含声明了一个新的段，所有commands 或 options 属于最近的声明。在第一个段之前的 commands 或 options 都会被忽略

每一个actions 和 services 都有不同的名字。后面与前面发生重名的，那么这个后面重名的将被忽略或被认为是一个错误。

actions其实就是一组被命名的命令序列。actions 都有一个触发条件，触发条件决定了action何时执行。当一个事件发生如果匹配action的触发条件，那么这个action将会被添加到预备执行队列的尾部（除非它已经在队列当中）

每一个action中的命令将被顺序执行。init进程负责在其它activities（如：设备创建/销毁，属性设置，进程重启）之间执行这些命令序列。

每一个action格式如下：

on <trigger>

<command>

<command>

  ...

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>当某个服务退出时。

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

services 是一些由init 启动 和 重新（如果有需要）启动的程序，当然这些程序如果是存在的。

每一个service格式如下：

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

<option>

<option>

  ...

options 是service的修饰符，用来告诉init 怎样及何时启动service。一共有如下几种:

1、diabled

这个服务不能通过启动一类服务来启动，只能单独以名字来启动。

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>之后的。

init程序在运行过程中可能会设置几个特殊属性的值，来告诉其它程序它正在做什么。这些属性是：

1、init.action

当前正在执行的action的名字，如果没有，就是“”。

2、init.command

当前正在执行的command的名字，如果没有，就是“”。

3、init.svc.<name>

一个服务的状态。可能的值有：“stopped”,"running","restarting"

4、user <username>

在启动服务之前，把用户名切换到<username>。默认是root

5、group <groupname> [ <groupname> ]*

在启动服务之前，把组名切换到<groupname>。一个服务可能属于多个组。

6、capability [ <capability> ]+

Set linux capability before exec'ing this service

7、oneshot

服务之运行一次，退出后不再重启。

8、class <name>

为服务设定一个类别，一个类别是中的服务可以同时启动或停止。如果没有这个属性，服务的默认类别是“default”

9、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

 

参考：

Linux2.6内核的vivi分区及内核MTD分区

http://blogold.chinaunix.net/u2/66601/showart_1010926.html

android init.rc语法标准

http://blog.youkuaiyun.com/liushaogeng/archive/2010/10/18/5949244.aspx

http://www.kandroid.org/android_pdk/bring_up.html

http://blog.163.com/fenglang_2006/blog/static/13366231820108203223442/

 

本文来自优快云博客，转载请标明出处：http://blog.youkuaiyun.com/a345017062/archive/2011/03/11/6239204.aspx
本文来自优快云博客，转载请标明出处：http://blog.youkuaiyun.com/liushaogeng/archive/2010/10/18/5949244.aspx