首页 > 代码库 > Android init.rc文件浅析

Android init.rc文件浅析

本文主要来自$ANDROID_SOURCE/system/init/readme.txt的翻译.

1 简述

Android init.rc文件由系统第一个启动的init程序解析。此文件由语句组成,主要包括了四种类型的语句:Action,Commands,Services,Options.在init.rc文件里一条语句一般是占领一行.单词之间是通过空格符来相隔的.假设须要在单词内使用空格,那么得使用转义字符"\",假设在一行的末尾有一个反斜杠,那么是换行折叠符号,应该和下一行合并成一起来处理,这样做主要是为了避免一行的字符太长。与C语言中的含义是一致的。凝视是以#号开头。

Action和services显式声明了一个语句块。而commands和options属于近期声明的语句块。在第一个语句块之前 的commands和options会被忽略.

在详细解说这之前。有些关键词得先了解.

2 keyword

token:  计算机语言中的一个单词,就跟英文中的单词几乎相同一人概念.

Section: 语句块,相当于C语言中大括号内的一个块。一个Section以Service或On开头的语句块.以Service开头的Section叫做服务,而以On开头的叫做动作(Action).

services: 服务.

Action: 动作

commands:命令.

options:选项.

trigger:触发器。或者叫做触发条件.

class: 类属,即能够为多个service指定一个同样的类属,方便操作同一时候启动或停止.

3 语句解析

3.1 动作(Action)

动作表示了一组命令(commands)组成.动作包括一个触发器,决定了何时运行这个动作。当触发器的条件满足时,这个动作会被增加到已被运行的队列尾。假设此动作在队列中已经存在,那么它将不会运行.

 一个动作所包括的命令将被依次运行。动作的语法例如以下所看到的:

[plain] view plaincopy
  1. on <trigger>  
  2.    <command>  
  3.    <command>  
  4.    <command>  

3.2 服务(services)

服务是指那些须要在系统初始化时就启动或退出时自己主动重新启动的程序.

它的语法结构例如以下所看到的:

[plain] view plaincopy
  1. service <name> <pathname> [ <argument> ]*  
  2.    <option>  
  3.    <option>  
  4.    ...  


3.3 选项(options)

选项是用来改动服务的。它们影响怎样及何时执行这个服务.

选项 描写叙述
critical 据设备相关的关键服务,假设在4分钟内。此服务反复启动了4次,那么设备将会重新启动进入还原模式。
disabled 服务不会自己主动执行,必须显式地通过server来启动。
setenv <name> <value> 环境变量设置
socket <name> <type> <perm> [ <user> [ <group> ] ] 在/dev/socket/下创建一个unix domain的socket。并传递创建的文件描写叙述符fd给服务进程.当中type必须为dgram或stream,seqpacket.username和组名默觉得0
user <username> 在运行此服务之前先切换username。当前默觉得root.
group <groupname> [ <groupname> ]* 类似于user,切换组名
oneshot 当此服务退出时不会自己主动重新启动.
class <name> 给服务指定一个类属,这样方便操作多个服务同一时候启动或停止.默认情况下为default.
onrestart 当服务重新启动时运行一条指令。

3.4 触发器(trigger)

触发器用来描写叙述一个触发条件,当这个触发条件满足时能够运行动作.

触发器 描写叙述
boot init程序运行,并加载/init.conf文件时触发.
<name>=<value> 当属性名相应的值设置为指定值时触发.
device-added-<path> 当加入设备时触发.
device-removed-<path> 当设备移除时触发.
service-exited-<name> 当指定的服务退出时触发.

3.5 命令(commands)

命令 描写叙述
exec <path> [ <argument> ]* 运行指定路径下的程序,并传递參数.
export <name> <value> 设置全局环境參数。此參数被设置后对全部进程都有效.
ifup <interface> 使指定的网络接口"上线",相当激活指定的网络接口
import <filename> 导入一个额外的init配置文件.
hostname <name> 设置主机名
chdir <directory> 改变工作文件夹.
chmod <octal-mode> <path> 改变指定文件的读取权限.
chown <owner> <group> <path> 改变指定文件的拥有都和组名的属性.
chroot <directory> 改变进行的根文件夹.
class_start <serviceclass> 启动指定类属的全部服务,假设服务已经启动,则不再反复启动.
class_stop <serviceclass> 停止指定类属的所胡服务.
domainname <name> 设置域名
insmod <path> 安装模块到指定路径.
mkdir <path> [mode] [owner] [group] 用指定參数创建一个文件夹,在默认情况下,创建的文件夹读取权限为755.username为root,组名为root.
mount <type> <device> <dir> [ <mountoption> ]* 类似于linux的mount指令
setkey TBD(To Be Determined),待定.
setprop <name> <value> 设置属性及相应的值.
setrlimit <resource> <cur> <max> 设置资源的rlimit(资源限制),不懂就百度一下rlimit
start <service> 假设指定的服务未启动,则启动它.
stop <service> 假设指定的服务当前正在执行。则停止它.
symlink <target> <path> 创建一个符号链接.
sysclktz <mins_west_of_gmt> 设置系统基准时间.
trigger <event> Trigger an event.  Used to queue an action from another action.这名话没有理解,望高手指点.
write <path> <string> [ <string> ]* 往指定的文件写字符串.

3.6 属性(Properties)

init程序在执行时会更新属性系统的一些属性,提供程序内部正在执行的信息.

属性名 描写叙述
init.action 当前正在运行的动作,假设没有则为空字符串""
init.command 当前正在运行的命令.没有则为空字符串.
init.svc.<name> 当前某个服务的状态,可为"stopped", "running", "restarting"

4 一个 init.conf样例

[plain] view plaincopy
  1. # not complete -- just providing some examples of usage  
  2. #  
  3. on boot  
  4.    export PATH /sbin:/system/sbin:/system/bin  
  5.    export LD_LIBRARY_PATH /system/lib  
  6.   
  7.    mkdir /dev  
  8.    mkdir /proc  
  9.    mkdir /sys  
  10.   
  11.    mount tmpfs tmpfs /dev  
  12.    mkdir /dev/pts  
  13.    mkdir /dev/socket  
  14.    mount devpts devpts /dev/pts  
  15.    mount proc proc /proc  
  16.    mount sysfs sysfs /sys  
  17.   
  18.    write /proc/cpu/alignment 4  
  19.   
  20.    ifup lo  
  21.   
  22.    hostname localhost  
  23.    domainname localhost  
  24.   
  25.    mount yaffs2 mtd@system /system  
  26.    mount yaffs2 mtd@userdata /data  
  27.   
  28.    import /system/etc/init.conf  
  29.   
  30.    class_start default  
  31.   
  32. service adbd /sbin/adbd  
  33.    user adb  
  34.    group adb  
  35.   
  36. service usbd /system/bin/usbd -r  
  37.    user usbd  
  38.    group usbd  
  39.    socket usbd 666  
  40.   
  41. service zygote /system/bin/app_process -Xzygote /system/bin --zygote  
  42.    socket zygote 666  
  43.   
  44. service runtime /system/bin/runtime  
  45.    user system  
  46.    group system  
  47.   
  48. on device-added-/dev/compass  
  49.    start akmd  
  50.   
  51. on device-removed-/dev/compass  
  52.    stop akmd  
  53.   
  54. service akmd /sbin/akmd  
  55.    disabled  
  56.    user akmd  
  57.    group akmd  
  58.    

5 调试注意事项

在默认情况下,通过init程序启动的程序的标准输出stdout和标准错误输出stderr会重定向到/dev/null.如:

[plain] view plaincopy
  1. service akmd /system/bin/logwrapper /sbin/akmd  

为了更方便调试你的程序,你能够使用Android的log系统。标准输出和标准错误输出会重定义到Android的log系统中来.

Android init.rc文件浅析