今天还是理论性的内容,这很枯燥无味,但是我们又不得不啃它,为下一章我们自定义开机服务磨好刀。。。
了解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 | 为服务指定类名;同类服务可一起启动/停止。 | 未指定时属于 `default` 类;第一个类名必需,后续类名用于分组。`animation` 类用于启动/关机动画,不能保证访问 `/data`。 |
| `disabled` | 服务不会随其类自动启动。 | 必须通过名称或接口名显式启动。 |
| `oneshot` | 服务退出后不重启。 | 与 `timeout_period` 等配合时尊重此标志。 |
| `onrestart` | 服务重启时执行一个 Command。 | 原文注明“见下文”。 |
| `override` | 表示此服务定义要覆盖之前同名服务定义。 | 常用于 `/odm` 覆盖 `/vendor`;init 解析到的最后一个带此关键字的定义生效;注意 init.rc 解析顺序。 |
| `updatable` | 标记服务可在启动后期由 APEX 覆盖。 | 通过 `override` 覆盖;若在 APEX 全部激活前启动,执行会延迟到激活完成;未标记则不能被 APEX 覆盖。 |
| `restart_period | 非 oneshot 服务退出后,在“上次启动时间 + 周期”重启。 | 默认 `5s`;可设 3600/86400 实现周期服务;小于 5s 仅在服务故意成功 `exit(0)` 时遵守,崩溃重启强制最小 5s 延迟。 |
| `timeout_period | 服务在此时间后被杀死。 | 尊重 `oneshot`:oneshot 不自动重启,其他服务会;适合与 `restart_period` 配合做周期服务。 |
| `critical [window= | 设备关键服务;异常退出超过阈值或 boot 完成前退出会触发重启。 | `window` 默认 4 分钟;`target` 默认 `bootloader`;测试时可将 `init.svc_debug.no_fatal. |
| `shutdown | 设置服务关机行为。 | 未指定时关机中用 SIGTERM/SIGKILL 杀死;`critical` 服务关机时不杀直到关机超时;超时后仍会杀;若关机开始时未运行则启动。 |
| `reboot_on_failure | 进程无法启动,或以非 `CLD_EXITED`/非 0 状态终止时重启系统。 | `target` 格式同 `sys.powerctl` 参数;适合与 `exec_start` 做启动必须检查。 |
| `gentle_kill` | 停止服务时先发 SIGTERM 而非 SIGKILL。 | 200 ms 超时后再发 SIGKILL。 |
- 身份、权限与安全上下文
| 选项/语法 | 说明 | 关键点/默认值 |
|---|---|---|
| `capabilities [ | exec 服务时设置 Linux capabilities。 | capability 不带 `CAP_` 前缀,如 `NET_ADMIN`、`SETPCAP`;未提供时:root 用户获得全部 capabilities(能否使用由 SELinux 控制),非 root 全部丢弃。 |
| `user | exec 前切换用户。 | 当前默认 root(原文注:可能应默认 nobody);Android M 起即使需要 capabilities 也应使用此选项;Android O 起可在 .rc 中直接请求 capabilities。 |
| `group | exec 前切换组。 | 第一个组名必需;附加组名通过 `setgroups()` 设置补充组;当前默认 root(原文注:可能应默认 nobody)。 |
| `seclabel | exec 前切换 SELinux 安全上下文。 | 主要用于 rootfs 服务如 ueventd、adbd;未指定且策略无转换时默认 init 上下文。 |
- 环境、命名空间、文件、套接字与接口
| 选项/语法 | 说明 | 关键点/默认值 | |
|---|---|---|---|
| `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`。 | |
| `enter_namespace | 进入位于 `path` 的 `type` 命名空间。 | 仅支持 `type=net` 网络命名空间;给定 type 只能进入一个。 | |
| `namespace <pid | mnt>` | fork 服务时进入新的 PID 或 mount 命名空间。 | 参数为 `pid` 或 `mnt`。 |
| `file | 打开文件并把 fd 传给启动进程。 | `type` 必须为 `r`、`w` 或 `rw`;原生可执行文件参见 `android_get_control_file()`。 | |
| `socket | 创建 `/dev/socket/name` UNIX 域套接字并传 fd。 | `type` 为 `dgram`/`stream`/`seqpacket`;可加 `+passcred` 启用 `SO_PASSCRED`,或 `+listen` 同步监听;user/group 默认 0;seclabel 默认服务安全上下文。 | |
| `interface | 关联服务提供的 AIDL/HIDL 接口。 | 接口名必须完全限定;多个接口多次使用;HIDL 示例 `interface vendor.foo.bar@1.0::IBaz default`;AIDL 用 `interface aidl | |
| `keycodes | 设置触发服务的 keycodes;全部同时按下则启动。 | 常用于 bugreport;可改用属性展开,如 `keycodes ${some.property.name:-none}`;属性为逗号分隔 keycode 或 `none`;因处理很早,只能用 `PRODUCT_DEFAULT_PROPERTY_OVERRIDES` 属性。 |
- 资源、调度、内存与 cgroup
| 选项/语法 | 说明 | 关键点/默认值 |
|---|---|---|
| `ioprio | 通过 `SYS_ioprio_set` 设置 IO 优先级和类。 | `class` 为 `rt`/`be`/`idle`;`priority` 为 0–7 整数。 |
| `priority | 设置服务进程调度优先级。 | 范围 -20–19;默认 0;通过 `setpriority()` 设置。 |
| `oom_score_adjust | 设置子进程 `/proc/self/oom_score_adj`。 | 范围 -1000–1000。 |
| `memcg.limit_in_bytes | 设置子进程 `memory.limit_in_bytes` 为字节值和物理内存百分比对应值中的较小者。 | 仅挂载 memcg 时生效;值必须 ≥0。 |
| `memcg.limit_property | 用指定属性值设置子进程 `memory.limit_in_bytes`。 | 仅挂载 memcg 时生效;覆盖 `memcg.limit_in_bytes` 和 `memcg.limit_percent`。 |
| `memcg.soft_limit_in_bytes | 设置子进程 `memory.soft_limit_in_bytes`。 | 仅挂载 memcg 时生效;值 ≥0。 |
| `memcg.swappiness | 设置子进程 `memory.swappiness`。 | 仅挂载 memcg 时生效;值 ≥0。 |
| `rlimit | 对服务应用 rlimit;子进程继承。 | 实际作用于该服务启动的进程树;解析方式类似 `setrlimit` 命令。 |
| `task_profiles | 设置任务 profiles。 | Android U 前应用于主线程;Android U 及之后应用于整个服务进程;用于替代 `writepid` 移入 cgroup。 |
| `writepid | fork 时把子进程 pid 写入文件,用于 cgroup/cpuset。 | 若未指定 `/dev/cpuset/` 文件但 `ro.cpuset.default` 非空,则写 `/dev/cpuset/ |
④ Commands(命令)
命令是构成系统行为的基础执行单元。它们通常不会单独出现,而是作为Action(动作)的一部分,在特定触发器(Trigger)条件满足时被成组地执行。
Commands的数量众多,可以根据其功能进行归类。以下是一些核心命令的说明:
| 分类 | 命令 | 说明 |
|---|---|---|
| 文件系统操作 | `mkdir | 创建一个目录,并可指定权限、所有者和用户组。 |
| 文件系统操作 | `rmdir | 删除一个目录。 |
| 文件系统操作 | `chmod | 更改文件或目录的访问权限。 |
| 文件系统操作 | `chown | 更改文件或目录的所有者和用户组。 |
| 文件系统操作 | `copy | 复制文件,尤其适用于二进制文件或大量数据。 |
| 文件系统操作 | `write | 向文件写入内容。 |
| 文件系统操作 | `wait | 等待某个文件出现,可设置超时时间。 |
| 属性与参数管理 | `setprop | 设置系统属性的值。 |
| 属性与参数管理 | `getprop | 获取系统属性的值;在 `init.rc` 中通常用于 `trigger` 条件,而非直接作为命令执行。 |
| 属性与参数管理 | `export | 设置全局环境变量,该变量对随后启动的所有进程都有效。 |
| 服务控制 | `start | 启动一个指定的服务。 |
| 服务控制 | `stop | 停止一个指定的服务。 |
| 服务控制 | `restart | 重启一个指定的服务。 |
| 服务控制 | `class_start | 启动某个类别下所有未运行的服务。 |
| 服务控制 | `class_stop | 停止并禁用某个类别下所有正在运行的服务。 |
| 服务控制 | `class_reset | 停止某个类别下所有正在运行的服务,但不禁用它们,之后可再用 `class_start` 启动。 |
| 服务控制 | `enable | 将一个在 `Service` 定义中标记为 `disabled` 的服务变为启用状态。 |
| 挂载与设备 | `mount | 挂载一个文件系统。 |
| 挂载与设备 | `mount_all | 根据 `fstab` 文件挂载所有相关分区。 |
| 挂载与设备 | `swapon_all [ | 根据 `fstab` 文件启用所有交换分区。 |
| 挂载与设备 | `ifup | 激活一个网络接口。 |
| 进程与系统执行 | `exec [ | Fork 并执行一个带参数的命令;`--` 之后是真正要执行的命令,之前的部分用于指定 SELinux 上下文、用户和用户组。 |
| 进程与系统执行 | `trigger | 手动触发一个已定义的 `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。
是不是感觉内容很多?其实也不用死记硬背,我们先对它有一个大致的了解,后面用到的时候不断实践,自然而然的就懂啦。。。
系统梳理rc文件语法与常用配置项,适合Android系统开发与定制ROM读者查阅,尤其适合作为自定义开机服务的实操前理论参考。