startup_init/README_zh.md

init组件

• 简介
• 目录
• 约束
• 使用说明
• 相关仓

简介

init组件负责处理从内核加载第一个用户态进程开始，到第一个应用程序启动之间的系统服务进程启动过程。启动恢复子系统除负责加载各系统关键进程之外，还需在启动的同时设置其对应权限，并在子进程启动后对指定进程实行保活（若进程意外退出要重新启动），对于特殊进程意外退出时，启动恢复子系统还要执行系统复位操作。

目录

base/startup/init_lite/             # init组件
├── LICENSE
└── services
    ├── include                  # init组件头文件目录
    ├── src                      # init组件源文件目录
    └── test                     # init组件测试用例源文件目录
        └── unittest
vendor
└──huawei
        └──camera
                └──init_configs  # init配置文件目录（json格式，镜像烧写后部署于/etc/init.cfg）

约束

目前支持小型系统设备（参考内存≥1MB），如Hi3516DV300、Hi3518EV300。

使用说明

init将系统启动分为三个阶段：

“pre-init”阶段：启动系统服务之前需要先执行的操作，例如挂载文件系统、创建文件夹、修改权限等

“init”阶段：系统服务启动阶段

“post-init”阶段：系统服务启动完后还需要执行的操作

上述每个阶段在配置文件init.cfg中都用一个job表示，每个job都对应一个命令集合，init通过依次执行每个job中的命令来完成系统初始化。job执行顺序：先执行“pre-init”，再执行“init”，最后执行“post-init”，所有job都集中放在init.cfg的jobs数组中。

除上述jobs数组之外，init.cfg中还有一个services数组，用于存放所有需要由init进程启动的系统关键服务的服务名、可执行文件路径、权限和其他属性信息。

配置文件init.cfg位于代码仓库/vendor/hisilicon/hispark_aries/init_configs/目录，部署在/etc/下，采用json格式，文件大小目前限制在100KB以内。

配置文件格式和内容说明如下所示：

{
    "jobs" : [{
            "name" : "pre-init",
            "cmds" : [
                "mkdir /testdir",
                "chmod 0700 /testdir",
                "chown 99 99 /testdir",
                "mkdir /testdir2",
                "mount vfat /dev/mmcblk0p0 /testdir2 noexec nosuid"
            ]
        }, {
            "name" : "init",
            "cmds" : [
                "start service1",
                "start service2"
             ]
        }, {
             "name" : "post-init",
             "cmds" : []
        }
    ],
    "services" : [{
            "name" : "service1",
            "path" : "/bin/process1",
            "uid" : 1,
            "gid" : 1,
            "secon" : "u:r:untrusted_app:s0",
            "once" : 0,
            "importance" : 1,
            "caps" : [0, 1, 2, 5]
    }, {
            "name" : "service2",
            "path" : "/bin/process2",
            "uid" : 2,
            "gid" : 2,
            "secon" : "u:r:untrusted_app:s0",
            "once" : 1,
            "importance" : 0,
            "caps" : []
        }
    ]
}

表 1 执行job介绍

job名	说明
pre-init	最先执行的job，如果开发者的进程在启动之前需要首先执行一些操作（例如创建文件夹），可以把操作放到pre-init中先执行。
init	中间执行的job，例如服务启动。
post-init	最后被执行的job，如果开发者的进程在启动完成之后需要有一些处理（如驱动初始化后再挂载设备），可以把这类操作放到该job执行。

单个job最多支持30条命令（当前仅支持start/mkdir/chmod/chown/mount/loadcfg），命令名称和后面的参数（参数长度≤128字节）之间有且只能有一个空格。

表 2 命令集说明

命令	命令格式和示例	说明
mkdir	mkdir 目标文件夹 如：mkdir /storage/myDirectory	创建文件夹命令，mkdir和目标文件夹之间有且只能有一个空格。
chmod	chmod 权限 目标 如：chmod 0600 /storage/myFile.txt chmod 0750 /storage/myDir	修改权限命令，chmod 权限 目标 之间间隔有且仅有一个空格，权限必须为0xxx格式。
chown	chown uid gid 目标 如：chown 900 800 /storage/myDir chown 100 100 /storage/myFile.txt	修改属组命令，chown uid gid 目标 之间间隔有且仅有一个空格。
mount	mount fileSystemType src dst flags data 如：mount vfat /dev/mmcblk0 /sdc rw,umask=000 mount jffs2 /dev/mtdblock3 /storage nosuid	挂载命令，各参数之间有且仅有一个空格。flags当前仅支持nodev、noexec、nosuid、rdonly，data为可选字段。
start	start serviceName 如：start foundation start shell	启动服务命令，start后面跟着service名称，该service名称必须能够在services数组中找到。
loadcfg	loadcfg filePath 如：loadcfg /patch/fstab.cfg	加载其他cfg文件命令。后面跟着的目标文件大小不得超过50KB，且目前仅支持加载/patch/fstab.cfg，其他文件路径和文件名均不支持。/patch/fstab.cfg文件的每一行都是一条命令，命令类型和格式必须符合本表格描述，命令条数不得超过20条。

表 3 service字段说明

字段名	说明
name	当前服务的名称，须确保非空且长度≤32字节。
path	当前服务的可执行文件全路径和参数，数组形式。须确保第一个数组元素为可执行文件路径、数组元素个数≤20、每个元素为字符串形式以及每个字符串长度≤64字节。
uid	当前服务进程的uid值。
gid	当前服务进程的gid值。
secon	当前服务进程的安全上下文（当前不需要设置该字段）。
once	当前服务进程是否为一次性进程： 1：一次性进程，当该进程退出时，init不会重新启动该服务进程 0 : 常驻进程，当该进程退出时，init收到SIGCHLD信号并重新启动该服务进程； 注意：对于常驻进程，若在4分钟之内连续退出5次，第5次退出时init将不会再重新拉起该服务进程。
importance	当前服务进程是否为关键系统进程： 0：非关键系统进程，当该进程退出时，init不会将系统复位重启； 1：关键系统进程，当该进程退出时，init将系统复位重启。
caps	当前服务所需的capability值，根据安全子系统已支持的capability，评估所需的capability，遵循最小权限原则配置（当前最多可配置100个值）。

相关仓

启动恢复子系统

startup_syspara_lite

startup_appspawn_lite

startup_bootstrap_lite

startup_init_lite