Android初始化語言(init.rc文法)

Android初始化語言(init.rc文法)

 

 

安卓初始化語言

安卓初始化語言套件括四種類型的語句，它們是：

動作 Action命令 Command服務 Service選項 Option

所有語句都是面向行的，以空格分割每行包含的若干token。C風格的反斜線可以用於token中插入空格，雙引號同樣可以避免空格將文本分為多個token。反斜線是一行的最後一個字元時，將用於續行（PS：下一行也屬於該句）。

以#開頭的行（前面有空格也是允許的）是注釋。

Action和Service隱式定義了一個新的section（段），所有Command或Option屬於最近定義的section。在第一個section之前的Command或Option將被忽略。

Action和Service有唯一的名字。如果有第二個Action或Service定義為和一個已存在的（Action或Service）同名，它將被作為錯誤忽略掉。

 

動作 Action

Action是有名字的一系列的命令。Action有一個tirgger（觸發器），用於決定該Action應在何時執行。當一個事件發生並匹配了一個Action的trigger，相應的Action將被添加到即將執行（to-be-executed）隊列的尾部（除非她已經在隊列上了）。

每個action在隊列中順序排列，每個action中的command將會順序執行。init在執行command的過程中還有執行其他活動（裝置節點的建立/銷毀，屬性設定，進程重啟）。

Action具有以下格式：

 

on    

 

服務 Service

Service是init載入的和是退出重啟的（可選）程式。Service具有如下格式：

 

service   [  ]*   ...

 

選項 Option

Option是Service的修改者。它們影響著init如何及何時運行Service。可用的Option有：

critical
這是十分關鍵的服務。如果在四分鐘內超過四次，手機將會重啟並進入recovery模式。

disabled
這種類型的服務不會自動啟動。它必須明確的使用名字啟動。

setenv
設定環境變數=在載入的進程中。

socket [ [ [ ] ] ]
建立一個名為/dev/socket/的UNIX域socket並將fd傳遞到載入的進程中。
必須是dgram, stream, seqpacket中的一種。
和預設為0.
是 SELinux socket 安全上下文，預設為service安全層級，可以指定為seclabel或根據service的可執行檔的安全層級計算。

user
在執行該service前改變使用者名稱，預設為root。如果你的進程請求Linux的特殊能力，就不要用這個命令。需以進入進程仍是root->請求特權->切換到你期望的uid來替換此法。

group [ ]*
在執行該service前改變組名。第一個以後的附加組名用於設定進程的附加組（通過setgroups()）。當前預設是root。

seclabel
在執行服務之前改變安全層級。主要用於從rootfs執行服務，比如ueventd, adbd. 在system分區上可以用基於檔案安全層級的策略定義的transition，如果沒有指定且沒有定義策略的transition，預設是init上下文。
Change to securitycontext before exec'ing this service.
Primarily for use by services run from the rootfs, e.g. ueventd, adbd.
Services on the system partition can instead use policy-defined transitions
based on their file security context.
If not specified and no transition is defined in policy, defaults to the init context.

oneshot
退出不重啟服務（名副其實，一次性）。

class
為一service指定一個類名，所有有相同類名的service可以一同啟動或停止。如果沒有用class選項指定類名，該service屬於default。

onrestart
在service重啟的時候執行。

 

觸發器 Trigger

觸發器是可以用來匹配一些種類的事件和用來引發一個行為發生的字串。

boot
這是init啟動後最先被觸發的trigger（在Init.conf被載入以後）。

=
這種形式額trigger（觸發器）屬性被設定為時被觸發。

device-added-
device-removed-
這種形式的Triggers（觸發器）會在裝置節點被添加或移除時觸發。

service-exited-
這種形式的Triggers會在指定的service退出時被觸發。

 

命令 Command

exec [ ]*
建立和執行程式(). 這將會阻塞init，直到程式執行完成。由於它不是內建命令，應盡量避免使用exec，它可能會引起init卡死。

export
在全域環境變數中設在環境變數 為。（這將會被所有在這命令之後啟動並執行進程所繼承）

ifup
啟動網路介面

import
解析一個init設定檔，擴充當前配置。

hostname
設定主機名稱。

chdir
改變工作目錄。

chmod
變更檔存取權限。

chown
變更檔的所有者和組。

chroot
改變進程的根目錄。

class_start
啟動該類service所有尚未啟動並執行服務。

class_stop
停止所有該類正在啟動並執行service。

domainname
設定網域名稱。

enable
改變一個disable的service為enabled，就像他們好像沒有明確的關閉一樣。如果該service已經應該運行，它會立刻啟動。典型的用法是，當bootloader設定一個表示特定的變數，service應該啟動。比如：

     on property:ro.boot.myfancyhardware=1        enable my_fancy_service_for_my_fancy_hardware

insmod
安裝位於的模組（PS：驅動）。

mkdir [mode] [owner] [group]
在建立一個目錄，（可選）使用給定的模式，所有者個組。如果沒有提供，該目錄將用755許可權，所有者為root使用者，組為root。

mount [ ]*
嘗試掛載到，可能有mtd@name形式，以指定名為name的mtd塊裝置。
包括 ro, rw, remount, noatime, ...

restorecon [ ]*
恢複名為的檔案在file_contexts中配置的的安全層級。自動被init標記正確，不需要用init.rc建立的目錄。
restorecon_recursive [ ]*

遞迴的恢複指出的分類樹中file_contexts配置指定的安全層級。 path不要用shell可寫或app可寫的目錄，如/data/locla/temp， /data/data，或者有類似首碼的（目錄）。

 

setcon
設定當前進程的security context為特定的字串。這是典型的僅用於所有進程啟動之前的early-init設定init context。

setenforce 0|1
設定SELinux系統範圍的enfoucing狀態。0 is permissive (i.e. log but do not deny), 1 is enforcing.

setkey
TBD

setprop
設定系統屬性為.

setrlimit
為特定資源設定rlimit.

setsebool
設定SELinux的bool類型為。 may be 1|true|on or 0|false|off

start
啟動一個服務（如果服務尚未啟動）。

stop
停止服務（如果正在運行）。

symlink
建立一個符號串連，at with the value 。

sysclktz
Set the system clock base (0 if system clock ticks in GMT)

trigger
觸發一個事件。一個動作將另一動作排隊。

wait [ ]
poll特定的，出現後返回，或timeout到達。如果timeout沒有指定，預設為5秒。

write
開啟一個位於的檔案，寫入（不是追加）字串。


屬性 Propertiesinit進程會更新一些系統屬性，下面是一些具體的屬性：

init.action
等於當前正在執行的action，或者若果沒有的話。

init.command
等於當前正在執行的command，或者如果沒有的話。

init.svc.
一個有名service的狀態(stopped, running, restarting)

Example init.conf-----------------

# 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

Debugging notes---------------
By default, programs executed by init will drop stdout and stderr into
/dev/null. To help with debugging, you can execute your program via the
Andoird program logwrapper. This will redirect stdout/stderr into the
Android logging system (accessed via logcat).

For example
service akmd /system/bin/logwrapper /sbin/akmd