Android init脚本语法

system/core/init/Readme里有init.rc语法的描述

1.      #开头的行也被忽略掉,用于注释;

2.      ‘’、‘\t’、‘\r’都会被忽略,所以属性中含有空格的话,后面的不会被识别;每一个Action里command前的缩进并无语法的要求,只是便于人阅读;

3.      ‘\n’是换行的标志,init语法里新解析的开始都是基于新行开始才进行的,是逐行扫描解析的;


内容:

  • Commands:命令
  • Actions:动作
  • Triggers:触发条件
  • Services:服务
  • Options:选项
  • Properties:属性

Actions和Services声明一个新的分组Section。所有的命令或选项都属于最近声明的分组。位于第一个分组之前的命令或选项将会被忽略。
Actions和Services有唯一的名字。如果有重名的情况,第二个申明的将会被作为错误忽略。

Actions(行为)
  Actions其实就是一序列的Commands(命令)。Actions都有一个trigger(触发器),它被用于决定action的执行时间。当一个符合action触发条件的事件发生时,action会被加入到执行队列的末尾,除非它已经在队列里了。
    队列中的每一个action都被依次提取出,而这个action中的每个command(命令)都将被依次执行。
Actions的形式如下: 
     on <trigger>
           <command1>
           <command2>
           <command3>
on后面跟着一个触发器,当trigger被触发时,command1,command2,command3,会依次执行,直到下一个Action或下一个Service。
简单来说,Actions就是Android在启动时定义的一个启动脚本,当条件满足时,会执行该脚本,脚本里都是一些命令commands,不同的脚本用on来区分。

Triggers(触发器)
    Triggers(触发器)是一个用于匹配特定事件类型的字符串,用于使Actions发生。
        boot:
            这是init执行后的第一个被触发的Triggers(触发器)。(在 /init.conf (启动配置文件)被装载之后)
        <name>=<value>:
            这种形式的Triggers(触发器)会在属性<name>被设置为指定的<value>时被触发。
        device-added-<path>:
        device-removed-<path>:
            这种形式的Triggers(触发器)会在一个设备节点文件被增删时触发。
        service-exited-<name>:
            这种形式的Triggers(触发器)会在一个特定的服务退出时触发。
触发器通常和on一起来联合使用。
示例:
on init 
  export LD_LIBRARY_PATH /system/lib
  insmod modules/fsr.ko
  symlink /system/etc /etc
  mkdir /sdcard 0000 system system
  write /proc/cpu/alignment 4

on boot
  …
on property:ro.kernel.qemu=1
   start adbd
上面声明了三个action:init,boot和一个属性触发器,当init被触发时,会顺序执行后面的命令,直到on boot新的action。Init的触发是由init.c里的函数action_for_each_trigger来决定的。当属性ro.kernel.qemu为1 时,会触发start adbd命令。


Services(服务)
Services(服务)是一个程序,它在初始化时启动,并在退出时可选择让其重启。Services(服务)的形式如下: 
        service <name> <pathname> [ <argument> ]*
           <option>
           <option>
           ...
name:服务名
pathname:当前服务对应的程序位置
option:当前服务设置的选项

service   zygote   /system/bin/app_process     -Xzygote   /system/bin    --zygote    --start-system-server
    socket zygote stream 666
    onrestart write /sys/android_power/request_state wake
    onrestart write /sys/power/state on
    onrestart restart media
    onrestart restart netd


Options(选项)
    Options(选项)是一个Services(服务)的修正者。他们影响Services(服务)在何时,并以何种方式运行。
    
critical:
            说明这是一个对于设备关键的服务。如果他四分钟内退出大于四次,系统将会重启并进入recovery(恢复)模式。

     disabled:
            说明这个服务不会同与他同trigger(触发器)下的服务自动启动。他必须被明确的按名启动。

     setenv <name> <value> (设置环境变量)
            在进程启动时将环境变量<name>设置为<value>。

     socket <name> <type> <perm> [ <user> [ <group> ] ]
            创建一个Uinx域的名为/dev/socket/<name> 的套接字,并传递它的文件描述符给已启动的进程。<type> 必须是 "dgram"或"stream"。User 和 group默认为0。

     user <username>
            在启动这个服务前改变该服务的用户名。此时默认为root。(???有可能的话应该默认为nobody)。当前,如果你的进程要求Linux capabilities(能力),你无法使用这个命令。即使你是root,你也必须在程序中请求capabilities(能力)。然后降到你想要的 uid。

     group <groupname> [ <groupname> ]*
            在启动这个服务前改变该服务的组名。除了(必需的)第一个组名,附加的组名通常被用于设置进程的补充组(通过setgroups())。此时默认为root。(???有可能的话应该默认为nobody)。
    
    
oneshot
            服务退出时不重启。

     class <name>
            指定一个服务类。所有同一类的服务可以同时启动和停止。如果不通过class选项指定一个类,则默认为"default"类服务。

     onrestart
            当服务重启,执行一个命令(下详)。

Commands(命令)
   
exec <path> [ <argument> ]*
         创建和执行一个程序(<path>)。在程序完全执行前,init将会阻塞。由于它不是内置命令,应尽量避免使用exec,它可能会引起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>,可以选择性地指定mode、owner以及group。如果没有指定,默认的权限为755,并属于root用户和root组。
    mount <type> <device> <dir> [ <mountoption> ]*
        试图在目录<dir>挂载指定的设备。<device> 可以是以 mtd@name 的形式指定一个mtd块设备。<mountoption>包括 "ro"、"rw"、"remount"、"noatime"、 ...
    setprop <name> <value>
           设置系统属性 <name> 为 <value>值. 
    setrlimit <resource> <cur> <max>
        设置<resource>的rlimit(资源限制)。
    start <service>
        启动指定服务(如果此服务还未运行)。
    stop <service>
        停止指定服务(如果此服务在运行中)。
    symlink <target> <path>
        创建一个指向<path>的软连接<target>。
    sysclktz <mins_west_of_gmt>
        设置系统时钟基准(0代表时钟滴答以格林威治平均时(GMT)为准)
    trigger <event>
           触发一个事件。用于将一个action与另一个 action排列。
    write <path> <string> [ <string> ]*
           打开路径为<path>的一个文件,并写入一个或多个字符串。

Properties(属性)
    Init更新一些系统属性以提供对正在发生的事件的监控能力: 
        init.action
               此属性值为正在被执行的action的名字,如果没有则为""。
        init.command
               此属性值为正在被执行的command的名字,如果没有则为""。
        init.svc.<name>
               名为<name>的service的状态("stopped"(停止), "running"(运行), "restarting"(重启))



你可能感兴趣的:(android,init脚本)