Android启动流程之点rc文件

文章来源声明: 原文作者:求索君Fly; 来源站点:掘金; 原文链接:https://juejin.cn/post/7709284827502100515; 本文基于上述来源整理/加工,觅优补充点评,仅供技术学习交流。版权归原作者所有。
觅优短评

系统梳理rc文件语法与常用配置项,适合Android系统开发与定制ROM读者查阅,尤其适合作为自定义开机服务的实操前理论参考。

本文目录
系列推荐 ----

ubuntu编译android12源码

使用AndroidStudio阅读源码

Aosp开发神器Cuttlefish

Aosp源码学习之目录介绍

Aosp之mk文件简介

AOSP实战之bp文件介绍

Aosp15之添加自己的产品Product

Aosp之编译命令介绍

Aosp之添加C++可执行程序

Aosp之添加C++动态库

SEAndroid理论基础

Aosp实战之SEAndroid实战

Aosp开发磨刀石之ADB速查

Aosp之属性系统介绍

Aosp15之定制化开机向导

Android启动流程简要介绍

Android启动流程之Init进程第一阶段

Android启动流程之Init进程第二阶段

今天还是理论性的内容,这很枯燥无味,但是我们又不得不啃它,为下一章我们自定义开机服务磨好刀。。。

了解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选项有很多,不必死记硬背,又使用到的地方再查即可,这里整理一个文档表格,后续可查。

  1. 服务生命周期、启动与重启控制
选项/语法说明关键点/默认值
`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=] [target=]`设备关键服务;异常退出超过阈值或 boot 完成前退出会触发重启。`window` 默认 4 分钟;`target` 默认 `bootloader`;测试时可将 `init.svc_debug.no_fatal.` 设为 `true` 跳过致命重启。
`shutdown `设置服务关机行为。未指定时关机中用 SIGTERM/SIGKILL 杀死;`critical` 服务关机时不杀直到关机超时;超时后仍会杀;若关机开始时未运行则启动。
`reboot_on_failure `进程无法启动,或以非 `CLD_EXITED`/非 0 状态终止时重启系统。`target` 格式同 `sys.powerctl` 参数;适合与 `exec_start` 做启动必须检查。
`gentle_kill`停止服务时先发 SIGTERM 而非 SIGKILL。200 ms 超时后再发 SIGKILL。
  1. 身份、权限与安全上下文
选项/语法说明关键点/默认值
`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 上下文。
  1. 环境、命名空间、文件、套接字与接口
选项/语法说明关键点/默认值
`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 <pidmnt>`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` 属性。
  1. 资源、调度、内存与 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 ` / `memcg.limit_percent `设置子进程 `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//tasks`;用于 cgroup 已过时,建议用 `task_profiles`。

④ Commands(命令)

命令是构成系统行为的基础执行单元。它们通常不会单独出现,而是作为Action(动作)的一部分,在特定触发器(Trigger)条件满足时被成组地执行。

Commands的数量众多,可以根据其功能进行归类。以下是一些核心命令的说明:

分类命令说明
文件系统操作`mkdir [mode] [owner] [group]`创建一个目录,并可指定权限、所有者和用户组。
文件系统操作`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。

是不是感觉内容很多?其实也不用死记硬背,我们先对它有一个大致的了解,后面用到的时候不断实践,自然而然的就懂啦。。。