如何寫Android init.rc(該文章翻譯自/system/core/init/readme.txt)

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

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

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章