# init启动引导组件
- [init启动引导的配置文件](#section56901555917)
- [开发指导](#section15371931131117)
- [开发实例](#section173413113565)
init启动引导组件负责在系统启动阶段启动关键服务进程,若用户需要新增随开机自启动的系统服务,可将新增服务加入配置文件init.cfg中。
## init启动引导的配置文件
init启动引导组件配置文件包含了所有需要由init进程启动的系统关键服务的服务名、可执行文件路径、权限和其他信息,该文件位于代码仓库“vendor/huawei/camera/init\_configs/“目录,烧写单板后可在“/etc/“目录下找到,文件名称为init.cfg,采用json格式,文件大小目前限制在100KB以内。
init进程启动后读取/etc/init.cfg,然后解析其json格式内容,并根据解析结果依次加载系统服务。
## 开发指导
1. 配置jobs数组。
init启动引导组件将系统启动分为三个阶段:
- “pre-init”阶段:启动系统服务之前需要先执行的操作,例如挂载文件系统、创建文件夹、修改权限等。
- “init”阶段:系统服务启动阶段。
- “post-init”阶段:系统服务启动完后还需要执行的操作。
上述每个阶段用一个job表示,一个job对应一个命令集合,init通过依次执行每个job中的命令来完成系统初始化。job执行顺序:先执行“pre-init”,再执行“init”,最后执行“post-init”。
```
"jobs" : [{
"name" : "pre-init",
"cmds" : [
"mkdir /testdir",
"chmod 0700 /testdir",
"chown 99 99 /testdir",
"mkdir /testdir2",
"mount vfat /dev/mmcblk0p0 /testdir2 noexec nosuid" // mount命令,格式为:mount 文件系统类型 source target flags data
]
}, {
"name" : "init",
"cmds" : [
"start service1",
"start service2"
]
}, {
"name" : "post-init",
"cmds" : []
}
],
```
**表 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条。
|
2. 配置services数组,service集合(数组形式),包含了init进程需要启动的所有系统服务(最多支持100个)。
```
"services" : [{
"name" : "service1",
"path" : ["/bin/process1", "param1", "param2"],
"uid" : 1,
"gid" : 1,
"once" : 0,
"importance" : 1,
"caps" : [0, 1, 2, 5]
}, {
"name" : "service2",
"path" : "/bin/process2",
"uid" : 2,
"gid" : 2,
"once" : 1,
"importance" : 0,
"caps" : [ ]
}
]
```
**表 3** service字段说明
字段名
|
说明
|
name
|
当前服务的服务名,须确保非空且长度<=32字节。
|
path
|
当前服务的可执行文件全路径和参数,数组形式。须确保第一个数组元素为可执行文件路径、数组元素个数<=20、每个元素为字符串形式以及每个字符串长度<=64字节。
|
uid
|
当前服务进程的uid值。
|
gid
|
当前服务进程的gid值。
|
once
|
当前服务进程是否为一次性进程:
1:一次性进程,当该进程退出时,init不会重新启动该服务进程
0 : 常驻进程,当该进程退出时,init收到SIGCHLD信号并重新启动该服务进程;
注意,对于常驻进程,若在4分钟之内连续退出5次,第5次退出时init将不会再重新拉起该服务进程。
|
importance
|
当前服务进程是否为关键系统进程:
0:非关键系统进程,当该进程退出时,init不会将系统复位重启;
1:关键系统进程,当该进程退出时,init将系统复位重启。
|
caps
|
当前服务所需的capability值,根据安全子系统已支持的capability,评估所需的capability,遵循最小权限原则配置(当前最多可配置100个值)。
|
## 开发实例
init启动引导程序,此处以要新增一个名为MySystemApp的系统服务为例进行说明,使用如下配置:
```
{
"jobs" : [{
"name" : "pre-init",
"cmds" : [
"mkdir /storage/MyDir", // MySystemApp服务启动之前需要先创建文件夹,因此放在 “pre-init”中进行
"chmod 0600 /storage/MyDir", // MySystemApp服务要求该文件加只有本用户和属组才可读写,因此需要修改权限
"chown 10 10 /storage/MyDir"
]
}, {
"name" : "init",
"cmds" : [
"start MySystemApp" // 在“init”中启动该系统服务
]
}, {
"name" : "post-init",
"cmds" : [] // MySystemApp系统服务启动后无需进行其他操作,因此不用配置“post-init”
}
],
"services" : [{
"name" : "MySystemApp", // 系统服务名称
"path" : ["/bin/MySystemAppExe", "param1", "param2", "param3"], // MySystemApp系统服务的可执行文件路径为"/bin/MySystemAppExe",其启动需要传入三个参数,分别是"param1"、"param2"和"param3
"uid" : 20, // MySystemApp系统服务的uid是20
"gid" : 20, // MySystemApp系统服务的gid是20
"once" : 0, // MySystemApp系统服务的非一次性进程,即如果MySystemApp系统服务因任何原因退出,init进程需要将其重新拉起
"importance" : 0, // MySystemApp系统服务不是关键系统进程,即如果MySystemApp系统服务因任何原因退出,init进程无需重启单板
"caps" : [] // MySystemApp系统服务不需要任何capability权限(即MySystemApp系统服务不涉及与capability相关的操作)
}
]
}
```
完成配置后,编译出包烧写单板:
1. 启动后使用task -a(liteos-a版本)或ps命令(linux版本)查看是否MySystemApp系统服务进程已启动。
2. 使用kill命令将上述新增的MySystemApp进程杀死,观察该进程是否会被重新拉起(此处应该为重新拉起)。
3. 使用kill命令将上述新增的MySystemApp进程杀死,观察是否会导致单板重启(此处应该为不重启)。