Android Init Language(android初始化语言)
d## Android Init Language
Android初始化语言
Android初始化语言包含四个广泛的陈述类，为Actions(行为),Commands(命令),
Services(服务)和Options(选项)。
所有的这些都是基于行的，包括空格分隔符。C风格的反斜杠可以用来插入空格到一个
命令中。双引号可以被用来阻止空格将文本分割成多个标记。当反斜杠为一行中的最后
一个字符的时候，可以被用于换行。
以#开始的行为注释。
Actions和Services声明一个新的部分。所有的commands和options属于最近声明
的那个部分。位于第一个部分之前的Commands和Actions是被忽略的。
Actions和Services用于独一无二的名称。如果有一个Action或Service被声明了一个
和之前相同名称，则他被忽略为一个错误。
行为
Actions是被命名的命令序列。Actions有一个触发器用来决定什么时候这个action应该发生。
当一个时间触发了符合一个action的触发器，那么这个action将被添加到要处理队列的
尾部（除非他已经在队列中了）。
在队列中的每一个action都是按照顺序出列的，位于那个action中的每一个command
也是按照顺序执行的。在活动中，初始化处理其他活动（设备创建和销毁，属性设置，
进程重启）介于commands的运行之间。
Actions组织形式位：
on <trigger>
<command>
<command>
<command>服务
服务是，当他们退出的时候，init进程启动和重新启动(可选)的程序。Services的形式为：
service <name> <pathname> [ <argument> ]*
<option>
<option>
...
选项
选项是服务的调节器。他们影响init进程如何并且何时运行这个服务。
critical
这是一个设备关键服务。如果他在四分钟内存在超过四次，设备将会重启进入恢复模式。
disabled
这个服务将不能与他的类自动启动。他必须通过名称被显示启动。
setenv <名称> <值>
在启动进程中设置环境变量<名称>到<数值>
socket <name> <type> <perm> [ <user> [ <group> [ <seclabel> ] ] ]
创建一个unix域套接字，命名为 /dev/socket/<name>，并且传递他的文件描述符fd到启动进程中。
<type>必须是"dgram","stream"或者是"seqpacket"。
User和group默认为0。
'seclabel'是这个套接字的SELinux安全上下文。
他默认为服务安全上下文，由seclabel指定或者是基于服务可执行文件安全上下文计算得来。
user <username>
在运行这个服务之前改为username(用户名称)。
当前默认为root.目前，如果你的进程需要linux功能，那么你不能使用这个命令。你必须在进程中
请求功能但依然root，然后降级到你期望的uid。
group <groupname> [ <groupname> ]*
在运行这个服务之前修改为groupname。在第一个之前的组名称被用来设置进程的追加的组（通过setgrooups()）
。目前默认为root。
seclabel <seclabel>
在执行这个服务之前改为seclabel。主要是从rootfs等中被services使用。
位于系统分区的services可以基于他们的文件安全上下文使用策略定义的转换。
如果未被指定或者是在策略中没有转换被定义，默认为初始化上下文。
oneshot
当他退出的时候不要重启服务。
class <name>
为服务指定一个类名称。位于一个命名的类中的所有服务一起被启动或停止。
如果服务未被class选项指定，则该服务位于类'default'中。
onrestart
当services重启的时候运行一个命令。
writepid <file...>
当子进程被创建的时候，将子进程的pid写入到给定的文件中。意味着cgroup/cpuset
用法。
触发器
触发器是一系列字符串，被用于匹配确定种类的事件，并且被用于出发一个行为。
boot
这是第一个触发器，当init进程启动的时候被触发（在/init.conf被加载之后）。
<name>=<value>
当属性<name>被设置为指定的值<value>的时候，这种形式的触发器被触发。
这个可以测试多个属性去运行一组命令。例如：
on property:test.a=1 && property:test.b=1
setprop test.c 1
上面的一小段只有当test.a=1和test.b=1都被设置的时候，才会设置test.1为1。
命令
bootchart_init
如果被配置的话，开启bootcharting。他被默认包含在init.rc中。
chmod <octal-mode> <path>
修改文件访问权限。
chown <owner> <group> <path>
修改文件拥有者和组。
class_start <serviceclass>
如果他们没有运行的话，启动所有指定类的服务。
class_stop <serviceclas
如果他们当前正在运行的话，停止并且禁用所有指定类的服务。
class_reset <serviceclass>
如果他们正在运行的话，停止所有指定类的服务，并不禁用他们。后期他们使用
class_start被重新启动。
copy <src> <dst>
复制一个文件。类似于写，但是对二进制/大数量数据是有用的。
domainname <name>
设置域名称。
enable <servicename>
将一个禁用的服务转换为可用，好像这个服务并没有被指定禁用过。
如果服务期望去运行，他将会现在被启动。特别是当bootloader设置了一个变量来指示一个指定
的服务应该在被需要的时候启动。
on property:ro.boot.myfancyhardware=1
enable my_fancy_service_for_my_fancy_hardware
exec [ <seclabel> [ <user> [ <group> ]* ] ] -- <command> [ <argument> ]*
使用给定的参数创建并且执行命令。这个命令在"--"之后运行，所以一个可选的安全上下文，用户，
和追加的组可以被提供。在这个结束之前没有其他的命令可以被运行。<seclabel>可以被一个-来
指定为默认。
export <name> <value>
在全局环境中设置环境变量<name>等于<value>。（这个命令执行之后启动的所有
进程都将继承他。）
hostname <name>
设置主机名
ifup <interface>
将网络接口<interface>联机。
import <filename>
解析一个初始化配置文件，扩展当前的配置。
insmod <path>
在<path>中安装模块
load_all_props
从/system,/vendor等中加载属性。这个被包含在默认的init.rc中。
load_persist_props
当/data被加密之后，加载持久化的属性。
这个被包含在默认的init.rc中。
loglevel <level>
一层一层的设置内核日志。属性被扩展到<level>中。
mkdir <path> [mode] [owner] [group]
在路径<path>中创建一个目录，可选的使用给定的模式，所有者和组。如果没有提供，该目录则
以权限755被创建并且以root用户为拥有者和以root为组。如果提供了，模式，所有者和组将会被
更新，如果该目录已经存在的话。
mount_all <fstab>
在给定的fs_mgr-format fstab中调用fs_mgr_mount_all。
mount <type> <device> <dir> [ <flag> ]* [<options>]
尝试在目录<dir>中挂载命名的设备。<device>可以是mtd@name的形式来通过名称
指定一个mtd块设备。
<flag>s包含"ro","rw","remount","noatime"等。
<options>包含"barrier=1", "noauto_da_alloc", "discard"等作为一个逗号分离的字符串。例如，
barrier=1,noauto_da_alloc
powerctl
内部实现系统用来响应改变"sys.powerctl"属性，用于实现重启。
restart <service>
类似于stop，但是并不禁用服务。
restorecon <path> [ <path> ]*
重新以file_contexts配置中指定的安全上下文来将文件重新以<path>存储。
不需要被init.rc创建的目录，因为这些都是被init初始化进程自动正确标记的。
restorecon_recursive <path> [ <path> ]*
递归的重新以名称<path>将目录树保存到安全上下文中，这个安全上下文由
file_contexts配置指定。
rm <path>
在指定的路径调用unlink(2)。你可能想要使用"exec -- rm ..."（提供的系统
分区已经被挂载了）。
rmdir <path>
对给定的目录调用rmdir(2)
setprop <name> <value>
这是系统属性<name>到<value>。属性被扩展到<value>。
setrlimit <resource> <cur> <max>
为一个资源设置rlimit。
start <service>
开启一个服务运行，如果这个服务没有运行的话。
stop <service>
从运行的服务中停止一个服务，如果这个服务正在运行的话。
swapon_all <fstab>
对给定的fstab文件执行fs_mgr_swapon_all
symlink <target> <path>
使用值<target>在<path>中创建一个符号链接。
sysclktz <mins_west_of_gmt>
设置系统时钟基础（如果系统时钟在格林尼治时间为0）
trigger <event>
触发一个事件。用于从另一个动作中排队一个动作。
verity_load_state
内部实现细节用于加载dm-verity状态。
verity_update_state <mount_point>
内部实现细节用于更新dm-verity状态并且设置分区。<mount_point>被adb remount
使用来验证属性，因为fm_mgr不能直接自己设置他们。
wait <path> [ <timeout> ]
轮询给定文件的存在性，并且当找到的时候返回，或者是到达超时状态。
如果超时未被指定，则默认为5秒。
write <path> <content>
在路径<path>中打开文件，并且使用write(2)写一个字符串进去。
如果文件不存在，他将被创建。如果文件存在，他将被覆盖。属性在<content>
被扩展。
属性
init进程更新一些系统属性，并且提供一些他要干什么的信息：
init.action
相当于当前被执行的action的名称，如果不存在则为""。
init.command
相当于当前被运行的command，如果没有则为""。
init.svc.<name>
一个被命名的服务的状态("停止","运行","重启")。
Bootcharting
init的这个版本包含运行”bootcharting”的代码：生成一个日志文件，后期能够被 www.bootchart.org
提供的工具处理。
在虚拟机中，使用-bootchart 选项来使启动的时候带有bootcharting持续秒。
在一个设备中，使用命令创建 /data/bootchart/start：
adb shell 'echo $TIMEOUT > /data/bootchart/start'
$TIMEOUT的值对应着期望bootchart持续的秒数。当这些时间过后，Bootcharting将会停止。
你可以通过下面的命令在任何时候停bootcharting：
adb shell 'echo 1 > /data/bootchart/stop'
注意，/data/bootchart/stop会在bootcharting最后被init自动删除。对于/data/bootchart/start
情况并非如此，所以当你收集完数据之后，不要忘记删除他。
日志文件被写入/data/bootchart中。一个脚本被提供去恢复他们，并且创建一个bootchart.tgz文件
，这个文件可以被bootchart命令行工具使用：
sudo apt-get install pybootchartgui
# grab-bootchart.sh uses $ANDROID_SERIAL.
$ANDROID_BUILD_TOP/system/core/init/grab-bootchart.sh
一个需要注意的事情就是，bootchart将会显示init好像是他从0s的时候开始运行。当内核
开始init的时候，你必须查看dmesg的工作。
Debugging init
默认的，由init执行的程序将会把标准输出和标准错误丢入到/dev/null。为了帮助调试，
你可以通过安卓程序日志封装程序运行你的程序。这个将会重定向标准输出/标准错误到
安卓日志系统中。
例如
service akmd /system/bin/logwrapper /sbin/akmd
当在init中自己运行的时候，为了快速的转变，使用：
mm -j
m ramdisk-nodeps
m bootimage-nodeps
adb reboot bootloader
fastboot boot $ANDROID_PRODUCT_OUT/boot.img
可选的，使用虚拟机：
emulator -partition-size 1024 -verbose -show-kernel -no-window
在klog_init()调用之后，你可能想要调用klog_set_level(6)，所以你需要在
dmesg或者是虚拟机输出中查看内核日志。
