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

    技术2022-05-19  18

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

     

    Android 初始化语言由四大类声明组成 : 行为类 (Actions), 命令类 (Commands) ,服务类 (Services), 选项类 (Options).

      * 初始化语言以行为单位,由以空格间隔的语言符号组成。

    C 风格的反斜杠转义符可以用来插入空白到语言符号。 双引号也可以用来防止文本被空格分成多个语言符号。 当反斜杠在行末时,作为折行符。

     

      * # 开始 ( 前面允许有空格 ) 的行为注释行。

      * ActionsServices 隐含声明一个新的段落。

    所有该段落下 CommandsOptions 的声明属于该段落。 第一段落前的 CommandsOptions 被忽略。

     

      * ActionsServices 拥有独一无二的命名。在它们之后声明相同命名的类将被当作错误并忽略。

    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

    -------

    OptionsServices 的修饰,它们影响 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 权限, ownerroot,grouproot 创建 .

     

    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>

         设置 resourcerlimit.

     

    start <service>

         启动一个没有运行的服务。

     

    stop <service>

         停止一个正在运行的服务

     

    symlink <target> <path>

         创建一个 <path> 的符号链接到 <target>

     

    sysclktz <mins_west_of_gmt>

         设置系统时区 (GMT0)

     

    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

    最新回复(0)