系列推荐
今天还是理论性的内容,这很枯燥无味,但是我们又不得不啃它,为下一章我们自定义开机服务磨好刀。。。
了解rc文件
前面提到Init进程的第二阶段一个重要的职责就是解析rc文件,并且执行里面的动作。 那么这个rc文件到底是一个什么样的东西呢?
rc文件是由 Android Init Language(AIL)编写的运行命令式的文件控制。
首先我们来看一个rc文件的例子init.zygote64_32.rc:
import /system/etc/init/hw/init.zygote64.rc
service zygote_secondary /system/bin/app_process32 -Xzygote /system/bin --zygote --socket-name=zygote_secondary --enable-lazy-preload
class main
priority -20
user root
group root readproc reserved_disk
socket zygote_secondary stream 660 root system
socket usap_pool_secondary stream 660 root system
onrestart restart zygote
task_profiles ProcessCapacityHigh MaxPerformance
这就是Init进程启动zygote进程的rc文件。
AIL由五大类语句组成:Actions(动作)、Commands(命令)、Services(服务)、Options(选项)和 Imports(导入)。
① Action(动作):一段被触发器唤醒时批量执行的命令,一般以 on 关键字开头:
Actions 是命名的命令序列。Actions 有一个 trigger,用于确定 action 何时执行。 当发生与 action 的 trigger 匹配的事件时,该 action 会被添加到待执行队列尾部(除非它已经在队列中)。
队列中的每个 action 按顺序出队,该 action 中的每个 command 按顺序执行。 Init 会在 commands 执行“之间”处理其他活动(设备创建/销毁、属性设置、进程重启)。
on <trigger> [&& <trigger>]*
<command>
<command>
<command>
# 例子
on boot
setprop a 1
setprop b 2
on boot && property:true=true
setprop c 1
setprop d 2
上面的Trigger表示触发器:用于标明什么时候执行 Action。
Triggers 是字符串,可用于匹配某些类型的事件,并用于使 action 发生。
Triggers 细分为事件触发器和属性触发器:
事件触发器是由 trigger 命令或 init 可执行文件内的 QueueEventTrigger() 函数触发的字符串。它们采用简单字符串形式,例如 boot 或 late-init。
属性触发器是当命名属性变为给定新值,或命名属性变为任意新值时触发的字符串。它们分别采用 property:= 和 property:=* 形式。属性触发器在 init 的初始启动阶段也会相应评估和触发。
例如下面就是一些常用的触发器:
on early-init # 非常早期,在 SELinux 完全建立之前
on init # 基础初始化之后
on late-init # 所有 init 任务之后
on boot # 系统准备就绪可以启动服务时
on charger # 启动进入充电模式时
属性触发器(属性变化时执行):
on property:sys.boot_completed=1
on property:ro.debuggable=1
组合触发器:
on boot && property:ro.debuggable=1
一个 Action 可以有多个属性触发器,但只能有一个事件触发器。
② Service(服务):声明一个"可被启动的进程",只声明不执行,等 start 才跑。以 service 关键字开头:
service <name> <可执行文件路径> [参数...]
<option1>
<option2>
③ Options(选项)
Options 是服务的修饰符,也就是上面的例子中的 ...
它们影响 init 如何以及何时运行服务。
Options选项有很多,不必死记硬背,又使用到的地方再查即可,这里整理一个文档表格,后续可查。
- 服务生命周期、启动与重启控制
| 选项/语法 | 说明 | 关键点/默认值 |
|---|---|---|
class <name> [ <name>* ] | 为服务指定类名;同类服务可一起启动/停止。 | 未指定时属于 default 类;第一个类名必需,后续类名用于分组。animation 类用于启动/关机动画,不能保证访问 /data。 |
disabled | 服务不会随其类自动启动。 | 必须通过名称或接口名显式启动。 |
oneshot | 服务退出后不重启。 | 与 timeout_period 等配合时尊重此标志。 |
onrestart | 服务重启时执行一个 Command。 | 原文注明“见下文”。 |
override | 表示此服务定义要覆盖之前同名服务定义。 | 常用于 /odm 覆盖 /vendor;init 解析到的最后一个带此关键字的定义生效;注意 init.rc 解析顺序。 |
updatable | 标记服务可在启动后期由 APEX 覆盖。 | 通过 override 覆盖;若在 APEX 全部激活前启动,执行会延迟到激活完成;未标记则不能被 APEX 覆盖。 |
restart_period <seconds> | 非 oneshot 服务退出后,在“上次启动时间 + 周期”重启。 | 默认 5s;可设 3600/86400 实现周期服务;小于 5s 仅在服务故意成功 exit(0) 时遵守,崩溃重启强制最小 5s 延迟。 |
timeout_period <seconds> | 服务在此时间后被杀死。 | 尊重 oneshot:oneshot 不自动重启,其他服务会;适合与 restart_period 配合做周期服务。 |
critical [window=<fatal crash window mins>] [target=<fatal reboot target>] | 设备关键服务;异常退出超过阈值或 boot 完成前退出会触发重启。 | window 默认 4 分钟;target 默认 bootloader;测试时可将 init.svc_debug.no_fatal.<service-name> 设为 true 跳过致命重启。 |
shutdown <shutdown_behavior> | 设置服务关机行为。 | 未指定时关机中用 SIGTERM/SIGKILL 杀死;critical 服务关机时不杀直到关机超时;超时后仍会杀;若关机开始时未运行则启动。 |
reboot_on_failure <target> | 进程无法启动,或以非 CLD_EXITED/非 0 状态终止时重启系统。 | target 格式同 sys.powerctl 参数;适合与 exec_start 做启动必须检查。 |
gentle_kill | 停止服务时先发 SIGTERM 而非 SIGKILL。 | 200 ms 超时后再发 SIGKILL。 |
- 身份、权限与安全上下文
| 选项/语法 | 说明 | 关键点/默认值 |
|---|---|---|
capabilities [ <capability>* ] | exec 服务时设置 Linux capabilities。 | capability 不带 CAP_ 前缀,如 NET_ADMIN、SETPCAP;未提供时:root 用户获得全部 capabilities(能否使用由 SELinux 控制),非 root 全部丢弃。 |
user <username> | exec 前切换用户。 | 当前默认 root(原文注:可能应默认 nobody);Android M 起即使需要 capabilities 也应使用此选项;Android O 起可在 .rc 中直接请求 capabilities。 |
group <groupname> [ <groupname>* ] | exec 前切换组。 | 第一个组名必需;附加组名通过 setgroups() 设置补充组;当前默认 root(原文注:可能应默认 nobody)。 |
seclabel <seclabel> | exec 前切换 SELinux 安全上下文。 | 主要用于 rootfs 服务如 ueventd、adbd;未指定且策略无转换时默认 init 上下文。 |
- 环境、命名空间、文件、套接字与接口
| 选项/语法 | 说明 | 关键点/默认值 | |
|---|---|---|---|
console [<console>] | 服务需要控制台;将 stdin/stdout/stderr 连接到控制台。 | 默认 /dev/console,可由内核参数 androidboot.console 更改;指定时省略 /dev/,如 console tty0;与 stdio_to_kmsg 互斥。 | |
stdio_to_kmsg | 将 stdout/stderr 重定向到 /dev/kmsg_debug。 | 仅 /dev/kmsg_debug 启用时生效,即仅 userdebug/eng 构建;与 console 互斥。 | |
setenv <name> <value> | 在启动进程中设置环境变量。 | name 设为 value。 | |
enter_namespace <type> <path> | 进入位于 path 的 type 命名空间。 | 仅支持 type=net 网络命名空间;给定 type 只能进入一个。 | |
| `namespace <pid | mnt>` | fork 服务时进入新的 PID 或 mount 命名空间。 | 参数为 pid 或 mnt。 |
file <path> <type> | 打开文件并把 fd 传给启动进程。 | type 必须为 r、w 或 rw;原生可执行文件参见 android_get_control_file()。 | |
socket <name> <type> <perm> [ <user> [ <group> [ <seclabel> ] ] ] | 创建 /dev/socket/name UNIX 域套接字并传 fd。 | type 为 dgram/stream/seqpacket;可加 +passcred 启用 SO_PASSCRED,或 +listen 同步监听;user/group 默认 0;seclabel 默认服务安全上下文。 | |
interface <interface name> <instance name> | 关联服务提供的 AIDL/HIDL 接口。 | 接口名必须完全限定;多个接口多次使用;HIDL 示例 interface vendor.foo.bar@1.0::IBaz default;AIDL 用 interface aidl <instance name>。 | |
keycodes <keycode> [ <keycode>* ] | 设置触发服务的 keycodes;全部同时按下则启动。 | 常用于 bugreport;可改用属性展开,如 keycodes ${some.property.name:-none};属性为逗号分隔 keycode 或 none;因处理很早,只能用 PRODUCT_DEFAULT_PROPERTY_OVERRIDES 属性。 |
- 资源、调度、内存与 cgroup
| 选项/语法 | 说明 | 关键点/默认值 |
|---|---|---|
ioprio <class> <priority> | 通过 SYS_ioprio_set 设置 IO 优先级和类。 | class 为 rt/be/idle;priority 为 0–7 整数。 |
priority <priority> | 设置服务进程调度优先级。 | 范围 -20–19;默认 0;通过 setpriority() 设置。 |
oom_score_adjust <value> | 设置子进程 /proc/self/oom_score_adj。 | 范围 -1000–1000。 |
memcg.limit_in_bytes <value> / memcg.limit_percent <value> | 设置子进程 memory.limit_in_bytes 为字节值和物理内存百分比对应值中的较小者。 | 仅挂载 memcg 时生效;值必须 ≥0。 |
memcg.limit_property <value> | 用指定属性值设置子进程 memory.limit_in_bytes。 | 仅挂载 memcg 时生效;覆盖 memcg.limit_in_bytes 和 memcg.limit_percent。 |
memcg.soft_limit_in_bytes <value> | 设置子进程 memory.soft_limit_in_bytes。 | 仅挂载 memcg 时生效;值 ≥0。 |
memcg.swappiness <value> | 设置子进程 memory.swappiness。 | 仅挂载 memcg 时生效;值 ≥0。 |
rlimit <resource> <cur> <max> | 对服务应用 rlimit;子进程继承。 | 实际作用于该服务启动的进程树;解析方式类似 setrlimit 命令。 |
task_profiles <profile> [ <profile>* ] | 设置任务 profiles。 | Android U 前应用于主线程;Android U 及之后应用于整个服务进程;用于替代 writepid 移入 cgroup。 |
writepid <file> [ <file>* ] | fork 时把子进程 pid 写入文件,用于 cgroup/cpuset。 | 若未指定 /dev/cpuset/ 文件但 ro.cpuset.default 非空,则写 /dev/cpuset/<cpuset_name>/tasks;用于 cgroup 已过时,建议用 task_profiles。 |
④ Commands(命令)
命令是构成系统行为的基础执行单元。它们通常不会单独出现,而是作为Action(动作)的一部分,在特定触发器(Trigger)条件满足时被成组地执行。
Commands的数量众多,可以根据其功能进行归类。以下是一些核心命令的说明:
| 分类 | 命令 | 说明 |
|---|---|---|
| 文件系统操作 | mkdir <path> [mode] [owner] [group] | 创建一个目录,并可指定权限、所有者和用户组。 |
| 文件系统操作 | rmdir <path> | 删除一个目录。 |
| 文件系统操作 | chmod <octal-mode> <path> | 更改文件或目录的访问权限。 |
| 文件系统操作 | chown <owner> <group> <path> | 更改文件或目录的所有者和用户组。 |
| 文件系统操作 | copy <src> <dst> | 复制文件,尤其适用于二进制文件或大量数据。 |
| 文件系统操作 | write <path> <content> | 向文件写入内容。 |
| 文件系统操作 | wait <path> [<timeout>] | 等待某个文件出现,可设置超时时间。 |
| 属性与参数管理 | setprop <name> <value> | 设置系统属性的值。 |
| 属性与参数管理 | getprop <name> | 获取系统属性的值;在 init.rc 中通常用于 trigger 条件,而非直接作为命令执行。 |
| 属性与参数管理 | export <name> <value> | 设置全局环境变量,该变量对随后启动的所有进程都有效。 |
| 服务控制 | start <service> | 启动一个指定的服务。 |
| 服务控制 | stop <service> | 停止一个指定的服务。 |
| 服务控制 | restart <service> | 重启一个指定的服务。 |
| 服务控制 | class_start <serviceclass> | 启动某个类别下所有未运行的服务。 |
| 服务控制 | class_stop <serviceclass> | 停止并禁用某个类别下所有正在运行的服务。 |
| 服务控制 | class_reset <serviceclass> | 停止某个类别下所有正在运行的服务,但不禁用它们,之后可再用 class_start 启动。 |
| 服务控制 | enable <servicename> | 将一个在 Service 定义中标记为 disabled 的服务变为启用状态。 |
| 挂载与设备 | mount <type> <device> <dir> [<flag>*] [<options>] | 挂载一个文件系统。 |
| 挂载与设备 | mount_all <fstab> [--<option>] | 根据 fstab 文件挂载所有相关分区。 |
| 挂载与设备 | swapon_all [<fstab>] | 根据 fstab 文件启用所有交换分区。 |
| 挂载与设备 | ifup <interface> | 激活一个网络接口。 |
| 进程与系统执行 | exec [<seclabel> [<user> [<group>*]]] -- <command> [<argument>*] | Fork 并执行一个带参数的命令;-- 之后是真正要执行的命令,之前的部分用于指定 SELinux 上下文、用户和用户组。 |
| 进程与系统执行 | trigger <trigger_name> | 手动触发一个已定义的 Action。 |
| 进程与系统执行 | bootchart_init | 如果配置了 bootchart,则启动其数据收集功能。 |
⑤ Imports(导入)
它的主要作用就是可以导入其他的rc文件,它的格式:
import <path>
解析 init 配置文件,扩展当前配置。如果 path 是目录,则目录中的每个文件都会作为配置文件解析。它不是递归的,嵌套目录不会被解析。
解读一个rc文件
以上面的init.zygote64_32.rc为例子,我们来解读一下这个rc文件都干了些什么。
-
service zygote_secondary /system/bin/app_process32 ...- 类型:service 定义。
- 解析:定义服务名
zygote_secondary;可执行文件为/system/bin/app_process32;后面是传给它的参数。
-
class main- 类型:service option。
- 解析:将该服务归入
main服务类。init 执行class_start main时会启动该类中未禁用/未运行的服务。
-
priority -20- 类型:service option。
- 解析:设置进程 nice 值为
-20,即最高调度优先级。通常需要 root 权限才能设置负 nice 值。
-
user root- 类型:service option。
- 解析:指定服务以
root用户身份运行。zygote 通常先以 root 启动,fork 应用进程时再降权到应用 UID。
-
group root readproc reserved_disk- 类型:service option。
- 解析:设置服务的组:主组/运行组为
root,并加入readproc、reserved_disk补充组。readproc通常用于读取/proc信息,reserved_disk与保留磁盘空间相关。
-
socket zygote_secondary stream 660 root system- 类型:service option。
- 解析:让 init 创建 Unix domain socket
/dev/socket/zygote_secondary,类型为SOCK_STREAM,权限0660,所有者root,所属组system。进程启动后通过继承的 fd 使用该 socket。
-
socket usap_pool_secondary stream 660 root system- 类型:service option。
- 解析:再创建一个名为
usap_pool_secondary的 stream socket,权限同样为660 root:system。USAP 池用于优化应用启动。
-
onrestart restart zygote- 类型:service option + command。
- 解析:当
zygote_secondary服务重启时,执行命令restart zygote,即重启主zygote服务。注意这里重启的是名为zygote的服务,不是zygote_secondary自己。
-
task_profiles ProcessCapacityHigh MaxPerformance- 类型:service option。
- 解析:将服务进程应用到一个或多个 task profile。
ProcessCapacityHigh、MaxPerformance是系统预定义 profile,通常映射到 cgroup/调度策略,用于提升 CPU 容量和性能表现。具体定义取决于task_profiles.json。
是不是感觉内容很多?其实也不用死记硬背,我们先对它有一个大致的了解,后面用到的时候不断实践,自然而然的就懂啦。。。