Android启动流程之点rc文件

0 阅读12分钟

系列推荐

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 <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。
  1. 身份、权限与安全上下文
选项/语法说明关键点/默认值
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 上下文。
  1. 环境、命名空间、文件、套接字与接口
选项/语法说明关键点/默认值
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 <pidmnt>`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 属性。
  1. 资源、调度、内存与 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。

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