diff --git a/zh-cn/device-dev/subsystems/subsys-boot-init.md b/zh-cn/device-dev/subsystems/subsys-boot-init.md index 3006198ed52dba3145fc409df1de59cb81fcba49..30fd9cc13a10643b0a4c716d662e0db6954d63e2 100755 --- a/zh-cn/device-dev/subsystems/subsys-boot-init.md +++ b/zh-cn/device-dev/subsystems/subsys-boot-init.md @@ -10,24 +10,87 @@ init启动引导组件负责在系统启动阶段启动关键服务进程。 若 init进程启动后读取/etc/init.cfg，然后解析其json格式内容，并根据解析结果依次加载系统服务。 - 各模块需要配置或添加关键服务时，可以在对应模块的cfg文件进行配置，编译过程会将配置后的文件拷贝到/system/etc/init目录下，单板中可在"/etc/init/"目录下查找到对应的cfg文件， + 各模块需要配置或添加关键服务时，可以在对应模块的cfg文件进行配置，编译过程中会将配置后的文件拷贝到/system/etc/init目录下，单板中可在"/etc/init/"目录下查找到对应的cfg文件， + + 对于单板中/etc/init下存在的cfg文件，init进程会逐一解析，下面分别介绍一下init扫描cfg文件的规则和cfg文件内容的具体组成格式。 + + - cfg文件扫描规则 + + 对于标准系统和小型系统，cfg文件扫描是共用一个相同的接口，接口代码如下： + ``` + void ReadConfig(void) + { + // parse cfg + if (InChargerMode() == 1) { + ParseInitCfg(INIT_CONFIGURATION_FILE, NULL); + ReadFileInDir(OTHER_CHARGE_PATH, ".cfg", ParseInitCfg, NULL); + } else if (InUpdaterMode() == 0) { + ParseInitCfg(INIT_CONFIGURATION_FILE, NULL); + ReadFileInDir(OTHER_CFG_PATH, ".cfg", ParseInitCfg, NULL); + ReadFileInDir("/vendor/etc/init", ".cfg", ParseInitCfg, NULL); + } else { + ReadFileInDir("/etc", ".cfg", ParseInitCfg, NULL); + } + } + ``` + 以下是这段代码中的宏定义： + + #define INIT_CONFIGURATION_FILE "/etc/init.cfg" + + #define OTHER_CHARGE_PATH "/system/etc/charge" + + #define OTHER_CFG_PATH "/system/etc/init" + + 对于充电模式和升级模式下cfg的扫描此处不作详细说明，我们关注正常系统启动时init扫描cfg文件的规则。 + 1. 对于/etc/init.cfg文件，是应当最先解析，因此直接调用解析接口解析该文件。 + 2. 对于/etc/init目录（note：/etc是指向/system/etc的一个符号链接，可以把它们看作是等价的），init进程会遍历该目录下的文件，匹配文件的后缀名，匹配到cfg文件时就会调用解析接口对该文件进行解析。 + 3. init还会遍历/vendor/etc/init目录下的cfg文件并进行解析，这个目录下的cfg文件应当是与硬件平台相关的。 + + - cfg文件的组成格式 + + 下面展示一个cfg文件的框架： + ``` + { + "import" : [ + "/etc/init.xxx.cfg", + "/vendor/etc/init.${ohos.boot.hardware}.cfg" + ], + "jobs" : [{ + "name" : "example-stage", + "cmds" : [ + "write /example/file 0", + "start example" + ] + } + ], + "services" : [{ + "name" : "example", + "path" : ["/system/bin/example"], + } + ] + } + ``` + 前面已经提到，cfg文件是json格式的文本文件。对于启动组件来说，init进程能够解析的cfg文件中的内容主要包括3种json对象，其对象名分别为"import", "jobs", "services"。下面逐一讲解这3个部分。 + + 1. "import": 导入其他cfg文件。一个cfg文件中导入的其他cfg文件，会在当前cfg文件解析完成后，按顺序继续解析。 + 2. "jobs": 带名字的命令组。一个job被执行时，会按照先后顺序逐条执行"cmds"中的命令。触发执行job的方式在下文中有详细介绍。 + 3. "services": 服务。最简单的服务可以只有一个名字和一个可执行文件路径。一个服务的基本运行逻辑是在init进程中fork一个子进程，然后在子进程中执行路径中的可执行文件。服务是启动组件中的核心内容，cfg中服务的配置还包括了各种各样的属性，服务的控制方式也涵盖了多方面的内容，这些都将在下文中展开详细的叙述。 - init服务启动控制(仅标准系统以上提供) init会根据用户的服务配置，把服务分成三类，在不同的阶段进行启动。 - - “boot”类型：对应系统中需要优先启动的服务，该类服务在init阶段完成后启动。 - - “normal”类型：默认配置，对应系统中的普通服务，这类服务在init命令执行完成后启动。 - - “condition”类型：对应有特殊要求的服务，可以直接通过start xxx 命令执行启动，一般在条件job或者在init的某个阶段使用命令启动。 + - “boot”类型：对应系统中需要优先启动的服务，该类服务在“init”阶段启动。 + - “normal”类型：默认配置，对应系统中的普通服务，该类服务在“post-init"阶段启动。 + - “condition”类型：表示服务按照条件启动。对有特殊要求的服务，可以直接通过start xxx 命令执行启动，一般在条件“job”或者在“init”的某个阶段使用命令启动。 服务间或服务与命令之间存在依赖关系，需要通过"condition"描述服务，配置参考如下： - ``` + ``` "services" : [{ "name" : "serviceName", "start-mode" : "condition", }, - - ``` + ``` - init服务并行控制(仅标准系统以上提供) init提供服务并行处理能力，启动服务在不同的阶段执行job的能力。 @@ -38,7 +101,7 @@ init启动引导组件负责在系统启动阶段启动关键服务进程。 若 配置参考如下： ``` - "services" : [{ + "services" : [{ "name" : "serviceName", "jobs" : { "on-boot" : "boot", @@ -47,7 +110,7 @@ init启动引导组件负责在系统启动阶段启动关键服务进程。 若 "on-restart" : "services:serviceName_restart" } }, - ``` + ``` - init 按需启动(仅标准系统以上提供) @@ -83,7 +146,7 @@ init启动引导组件负责在系统启动阶段启动关键服务进程。 若 - init提供修改\*.cfg配置文件， 为服务提供抑制机制。 服务进程启动&回收能力增强配置，如下： - ``` + ``` "services" : [{ "name" : "serviceName", "importance" : 1, // 服务进程提供优先级设置 @@ -94,7 +157,7 @@ init启动引导组件负责在系统启动阶段启动关键服务进程。 若 "secon" : "u:r:distributedsche:s0" / 服务的SELinux标签， "u:r:distributedsche:s0"为要设置的SELinux标签信息 }, - ``` + ``` - init FD代持(仅标准系统以上提供) FD代持是按需启动的一个辅助扩展机制，按需启动进程可以保持退出前的fd状态句柄不丢失。按需启动进程退出前可将fd发送给init代持，再次启动后再从init获取fd。 @@ -105,14 +168,14 @@ init启动引导组件负责在系统启动阶段启动关键服务进程。 若 init提供job能力，一个job就是一组命令的集合。job可以在init.cfg中配置，也可以在模块的自定义cfg中配置。init解析程序会把相同名字job的命令合并到一个job中。同一名字的job只能保证init.cfg中的命令优先执行，其他cfg间的命令执行顺序不保证。 - - 普通job：一般是init启动的固定阶段，如“pre-init“，”init“，”post-init“等，这类job在init启动的固定阶段执行。 + - 普通job：一般是init启动的固定阶段，如“pre-init“，“init”，“post-init”等，这类job在init启动的固定阶段执行。 - 自定义job：用户自定义的job，这类job按照一定的规则进行触发。 - job：用户任意定义，可以通过trigger命令执行。 - 控制job(仅标准系统以上提供)：按条件触发处理的能力。在job中可以设置触发条件，当对应的属性值满足设置的条件时，就会触发job执行。触发条件支持&&和||操作，可以根据不同的属性自行组合。 - bootchart 插件 - bootchart是一个用于linux启动过程性能分析的开源工具软件，在系统中自动收集CPU占用率、磁盘吞吐率、进程等信息，并以图形方式显示分析结果，可用作指导优化系统启动过程。 + bootchart是一个用于linux启动过程性能分析的开源工具软件，在系统中自动收集CPU占用率、磁盘吞吐率、进程等信息，并以图形方式显示分析结果，可用作指导优化系统启动过程。begetctl命令参考：[begetctl命令说明](#table14737791480) 如下所示： ``` @@ -152,8 +215,7 @@ init启动引导组件负责在系统启动阶段启动关键服务进程。 若 - “init”阶段：系统服务启动阶段。 - “post-init”阶段：系统服务启动完成后还需要执行的操作。 - - ``` + ``` "jobs" : [{ "name" : "pre-init", "cmds" : [ @@ -172,28 +234,62 @@ init启动引导组件负责在系统启动阶段启动关键服务进程。 若 "cmds" : [] } ] - ``` + ``` - **表1** 执行job介绍 - + **表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进程需要启动的所有系统服务。 + | 命令 | 命令格式和示例 | 说明 | 支持系统类型 | + | -------- | -------- | -------- | -------- | + | mkdir | mkdir 目标文件夹
如：mkdir /storage/myDirectory | 创建文件夹命令，mkdir和目标文件夹之间有且只能有一个空格。 | small&standard | + | chmod | chmod 权限 目标
如：chmod 0600 /storage/myFile.txt
chmod 0750 /storage/myDir | 修改权限命令，chmod权限目标之间间隔有且仅有一个空格，权限必须为0xxx格式。 | small&standard | + | chown | chown uid gid 目标
如：chown 900 800 /storage/myDir
chown 100 100 /storage/myFile.txt | 修改属组命令，chown uid gid目标之间间隔有且仅有一个空格。 | small&standard | + | 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为可选字段。 | small&standard | + | start | start serviceName
如：start foundation
start shell | 启动服务命令，start后面跟着service名称，该service名称必须能够在services数组中找到。 | small&standard | + | export | export key value
如：export TEST /data/test | 设置环境变量命令。后面跟两个参数，第一个参数是环境变量名，第二个参数是环境变量值。| small&standard | + | rm | rm filename
如：rm /data/testfile | 删除文件命令。后面跟一个参数，即文件的绝对路径。 | small&standard | + | rmdir | rmdir dirname
如：rmdir /data/testdir | 删除目录命令。后面跟一个参数，即目录的绝对路径。 | small&standard | write | write filename value
如：write /data/testfile 0 | 写文件命令。后面跟两个参数，第一个参数是文件的绝对路径，第二个参数是要写入文件的字符串。 | small&standard | + | stop | stop servicename
如：stop console | 关闭服务命令。后面跟一个参数，即要关闭的服务名。 | small&standard | + | copy | copy oldfile newfile
如：copy /data/old /data/new | 拷贝文件命令。后面跟两个参数，第一个参数是原文件绝对路径，第二个参数是新文件绝对路径。 | small&standard | + | reset | reset servicename
如：reset console | 重启服务命令。后面跟一个参数，即要重启的服务名。目前reset命令的策略是，如果一个服务没有启动，则该命令会将其拉起，如果一个服务处于运行状态，则该命令会将其关闭后重启。| small&standard | + | reboot | reboot (subsystem)
如：reboot updater | 重启系统命令。后面可以跟一个参数，也可以没有参数，当没有参数时执行该命令，将会使设备重启到当前系统，当后面跟参数时，参数应当是子系统的名字，例如,reboot updater，将会重启进入updater子系统。 | small&standard | + | sleep | sleep time
如：sleep 5 | 睡眠命令。后面可以跟一个参数，该参数是睡眠时间。 | small&standard | + | domainname | domainname name
如：domainname localdomain | 设置域名 | small&standard | + | hostname | hostname name
如：hostname localhost | 设置主机名命令。 | small&standard | + | wait | wait PID
如：wait pid | 等待命令。| small&standard | + | setrlimit | setrlimit resource curValue maxValue
如：| 设定资源使用限制命令。 | small&standard | + | write | write path content
如：write /proc/sys/kernel/sysrq 0 | 写文件命令。 | small&standard | + | exec | exec 可执行文件路径 可执行文件传的参数
如：exec /system/bin/udevadm trigger | 系统调用命令。 | small&standard | + | mknode |mknod name { b \| c } Major Minor
如mknod path b 0644 1 9| 建立一个目录项和一个特殊文件的对应索引节点。 参考mknod命令 |standard | + | makedev | makedev major minor
如：makedev -v update | 创建静态的设备节点命令，通常位于/dev目录下。| standard | + | symlink | symlink path1 path2
如：symlink /proc/self/fd/0 /dev/stdin | 符号链接命令。 | standard | + | trigger | trigger jobName
如：trigger early-fs | 触发job执行的命令。 | standard | + | insmod | insmod ko文件
如：insmod xxx.ko| 内核模块文件载入命令。 | standard | + | setparam | setparam paramname paramvalue
如：setparam sys.usb.config hdc| 设置系统参数。| standard | + | load_persist_params | load persist params
如：load_persist_params | 加载persist参数。load_persist_params命令后有且仅有一个空格 | standard | + | load_param | load params
如：load_param /data/test.normal.para| 将文件里的param加载到内存。| standard | + | load_access_token_id | 如：load_access_token_id | 将access token信息写入data/service/el0/access_token/nativetoken.json文件，load_access_token_id后有且只有一个空格。| standard | + | ifup | ifup 激活网络接口
如：ifup eth0 | 激活指定的网络接口。| standard | + | mount_fstab | mount_fstab fstab.test
如：mount_fstab /vendor/etc/fstab.test| 按照fstab挂载分区的命令。 | standard | + | umount_fstab | umount_fstab fstab.test
如：umount_fstab /vendor/etc/fstab.test | 按照fstab卸载分区的命令。 | standard | + | restorecon | restorecon file or dir
如：restorecon /file | 重新加载selinux 的context。 | standard | + | stopAllServices | stopAllServices [bool]
如：stopAllServices false 或 stopAllServices | 停止所有服务。 | standard | + | umount |umount path
如：umount /vendor | 卸载已经挂载的硬件设备 。 | standard | + | sync | 如：sync  | 同步写入数据到磁盘。sync后有且仅有一个空格。| standard | + | timer_start | timer_start serviceName
如：timer_start console | 启动服务计时器。 | standard | + | timer_stop | timer_stop serviceName
如：timer_stop console | 停止服务计时器。 | standard | + | init_global_key | init_global_key path 如：init_global_key /data | data分区文件加密key初始化。| standard | + | init_main_user | 如：init_main_user| 主用户目录加密。| standard | + | mkswap | mkswap file
如：mkswap /swapfile1 | 在一个文件或者设备上建立交换分区。 | standard | + | swapon | swapon file
如：swapon /swapfile1| 激活交换空间 | standard | + | loadcfg | loadcfg filePath
如：loadcfg /patch/fstab.cfg | 加载其他cfg文件命令。后面跟着的目标文件大小不得超过50KB，且目前仅支持加载/patch/fstab.cfg，其他文件路径和文件名均不支持。/patch/fstab.cfg文件的每一行都是一条命令，命令类型和格式必须符合本表格描述，命令条数不得超过20条。 | small | + +2. 配置services数组，service集合（数组形式），包含了init进程需要启动的所有系统服务。 ``` "services" : [{ @@ -230,32 +326,33 @@ init启动引导组件负责在系统启动阶段启动关键服务进程。 若 }] ``` -**表3** service字段说明 - | 字段名 | 字段说明 | 备注 | - | ---------- |-------- | --------| - | name | 当前服务的服务名。 | 类型：字符串； 服务名非空且长度<=32字节。| - | path | 当前服务的可执行文件全路径和参数，数组形式。 | 确保第一个数组元素为可执行文件路径、数组元素个数<=20。
每个元素为字符串形式以及每个字符串长度<=64字节。| - | uid | 当前服务进程的uid值。 | 类型：int | - | gid | 当前服务进程的gid值。 | 类型：int | - | once | 当前服务进程是否为一次性进程。 | 1：一次性进程，当该进程退出时，init不会重新启动该服务进程。
0 : 常驻进程，当该进程退出时，init收到SIGCHLD信号并重新启动该服务进程。 - | importance | 当前服务优先级 | 标准系统中:
   服务优先级取值范围 [-20， 19]，超出为无效设置。
小型系统中：
   0 : 非重要进程
   非0 : 重要进程 | - | caps | 当前服务所需的capability值，根据安全子系统已支持的capability，评估所需的capability，遵循最小权限原则配置。| 类型：数字或者字符串数组，在配置数字时，按linux标准的capability进行配置。字符串时，使用标准定义的宏的名字进行配置。 | - | critical | 为服务提供抑制机制，服务在配置时间 T 内，频繁重启次数超过设置次数 N 重启系统。 | 标准系统中
   类型：int型数组，如："critical" : [M, N, T]
    M：使能标志位（0：不使能；1：使能）， N：频繁拉起服务次数， T：时间(单位：秒)。
    M > 0; N > 0
小型系统中 & 标准系统中：
   类型：int，如："critical" : M
    M：使能标志位（0：不使能；1：使能）
   默认拉起服务次数：4次， 时间：20秒。 | - | cpucore | 服务需要的绑定的cpu核心数 | 类型：int型数组， 如"cpucore" : [N1, N2, ...], N1， N2均为需要绑定的cpu核索引
如单核设备 cpucore : [0] | - | d-caps | 服务分布式能力（仅标准系统以上提供）。| 类型：字符串数组， 如 "d-caps" : ["OHOS_DMS"] | - | apl | 服务能力特权级别（仅标准系统以上提供）。 | 类型：字符串， 如 "apl" : "system_core"。
目前支持"system_core"（默认值）, "normal", "system_basic"。 | - | start-mode | 服务的启动模式（仅标准系统以上提供）。 | 类型：字符串， 如 "start-mode" : "condition"。
目前支持"boot", "normal", "condition"。具体说明参考：[init服务启动控制](#section56901555918) | - | jobs | 当前服务在不同阶段可以执行的job（仅标准系统以上提供）。 | 具体说明参考：[init服务并行控制](#section56901555919) | - | ondemand | 按需启动服务的标志（仅标准系统以上提供）。 | 类型：bool，如"ondemand" : true，具体说明参考：[init服务按需启动](#section56901555920)| - + **表3** service字段说明 + + | 字段名 | 字段说明 | 字段解释 | 支持系统类型 | + | ---------- |-------- | --------| --------| + | name | 当前服务的服务名。 | 类型：字符串； 服务名非空且长度<=32字节。| small&standard | + | path | 当前服务的可执行文件全路径和参数，数组形式。 | 确保第一个数组元素为可执行文件路径、数组元素个数<=20。
每个元素为字符串形式以及每个字符串长度<=64字节。| small&standard | + | uid | 当前服务进程的uid值。 | 类型：int | small&standard | + | gid | 当前服务进程的gid值。 | 类型：int | small&standard | + | once | 当前服务进程是否为一次性进程。 | 1：一次性进程，当该进程退出时，init不会重新启动该服务进程。
0 : 常驻进程，当该进程退出时，init收到SIGCHLD信号并重新启动该服务进程。 | small&standard | + | importance | 当前服务优先级 | 标准系统中:
   服务优先级取值范围 [-20， 19]，超出为无效设置。
小型系统中：
   0 : 非重要进程
   非0 : 重要进程 | small&standard | + | caps | 当前服务所需的capability值，根据安全子系统已支持的capability，评估所需的capability，遵循最小权限原则配置。| 类型：数字或者字符串数组，在配置数字时，按linux标准的capability进行配置。字符串时，使用标准定义的宏的名字进行配置。 | small&standard | + | critical | 为服务提供抑制机制，服务在配置时间 T 内，频繁重启次数超过设置次数 N 重启系统。 | 标准系统中
   类型：int型数组，如："critical" : [M, N, T]
    M：使能标志位（0：不使能；1：使能）， N：频繁拉起服务次数， T：时间(单位：秒)。
    M > 0; N > 0
小型系统中 & 标准系统中：
   类型：int，如："critical" : M
    M：使能标志位（0：不使能；1：使能）
   默认拉起服务次数：4次， 时间：20秒。 | small&standard | + | cpucore | 服务需要的绑定的cpu核心数 | 类型：int型数组， 如"cpucore" : [N1, N2, ...], N1， N2均为需要绑定的cpu核索引
如单核设备 cpucore : [0] | small&standard | + | d-caps | 服务分布式能力（仅标准系统以上提供）。| 类型：字符串数组， 如 "d-caps" : ["OHOS_DMS"] | standard | + | apl | 服务能力特权级别（仅标准系统以上提供）。 | 类型：字符串， 如 "apl" : "system_core"。
目前支持"system_core"（默认值）, "normal", "system_basic"。 | standard | + | start-mode | 服务的启动模式（仅标准系统以上提供）。 | 类型：字符串， 如 "start-mode" : "condition"。
目前支持"boot", "normal", "condition"。具体说明参考：[init服务启动控制](#section56901555918) | standard | + | jobs | 当前服务在不同阶段可以执行的job。 | 具体说明参考：[init服务并行控制](#section56901555919) | small&standard | + | ondemand | 按需启动服务的标志。 | 类型：bool，如"ondemand" : true，小型系统只在Linux内核上支持。具体说明参考：[init服务按需启动](#section56901555920)| small&standard | + | disable | 预留字段，无实际意义。 | | small&standard | 3. 服务中socket配置和按需启动。 - 服务中支持配置 "socket" 属性，该属性以一个JSON对象的格式配置。配置有 "socket" 属性的服务，init将会为其创建socket，以是否为按需启动服务来区分其创建的时机。 - - 按需启动的服务，init会在解析到该服务时，根据解析到的socket配置进行创建。 - - 正常启动的服务，init会在拉起该服务时，执行服务可执行文件之前创建其配置的socket。 + 服务中支持配置 "socket" 属性，该属性以一个JSON对象的格式配置。配置有 "socket" 属性的服务，init将会为其创建socket，以是否为按需启动服务来区分其创建的时机。 + - 按需启动的服务，init会在解析到该服务时，根据解析到的socket配置进行创建。 + - 正常启动的服务，init会在拉起该服务时，执行服务可执行文件之前创建其配置的socket。 - 无论服务是否按需启动，其真正被拉起后，都需要通过特定接口获取init为其创建的socket句柄，进而接手该socket的管理，成为服务自有的socket。 - 除以上socket的配置和创建流程，对于按需启动的服务，init还有不同行为。当init在创建根据服务的socket配置创建完socket后，将会判断服务的ondemand属性是否为true（按需启动服务），若是则会调用接口对socket进行轮询监听，直到socket有消息上报，此时将停止监听并拉起对应服务，由服务接管该socket并处理消息。 + 无论服务是否按需启动，其真正被拉起后，都需要通过特定接口获取init为其创建的socket句柄，进而接手该socket的管理，成为服务自有的socket。 + 除以上socket的配置和创建流程，对于按需启动的服务，init还有不同行为。当init在创建根据服务的socket配置创建完socket后，将会判断服务的ondemand属性是否为true（按需启动服务），若是则会调用接口对socket进行轮询监听，直到socket有消息上报，此时将停止监听并拉起对应服务，由服务接管该socket并处理消息。 下面以ueventd服务为例介绍服务中socket和按需启动的配置以及各字段的含义。 @@ -278,11 +375,12 @@ init启动引导组件负责在系统启动阶段启动关键服务进程。 若 "SOCK_NONBLOCK" ] }], - "critical" : [ 0, 15, 5], + "critical" : [ 0, 5, 15], "ondemand" : true, "start-mode" : "condition" }] ``` + **表4** socket字段说明 |字段名 | 说明 | | -------- | -------- | @@ -295,7 +393,7 @@ init启动引导组件负责在系统启动阶段启动关键服务进程。 若 |gid|socket节点文件的组ID。此项配置仅对如AF_UNIX地址族等有实体节点文件的socket类型有效。| |option|socket的可选配置。在调用setsockopt接口时传入设置，目前支持的option选项有SOCKET_OPTION_PASSCRED、SOCKET_OPTION_RCVBUFFORCE、SOCK_CLOEXEC和SOCK_NONBLOCK。| - **表5** FD代持接口介绍 + **表5** FD代持接口介绍 | 函数名 | 函数解释 |参数解释 | | ---------- | ---------- |--------| @@ -303,7 +401,8 @@ init启动引导组件负责在系统启动阶段启动关键服务进程。 若 | int ServiceSaveFd(const char *serviceName, int *fds, int fdCount) | 请求init代持fd | 返回值：成功返回0，失败返回-1
参数：
serviceName: 服务名
fds: 需要init代持的fd数组指针
fdCount: fd数组长度 | int ServiceSaveFdWithPoll(const char *serviceName, int *fds, int fdCount) | 使用poll方式，请求fd代持 | 返回值：成功返回0，失败返回-1
参数：
serviceName: 服务名
fds: fd代持数组指针
fdCount 数组长度 - **表6** 服务控制接口介绍 + **表6** 服务控制接口介绍 + | 函数名 | 函数解释 |参数解释 | | :---------- | :---------- |:--------| | int ServiceControlWithExtra(const char *serviceName, int action, const char *extArgv[], int extArgc) | 配置服务参数 | 返回值：成功返回0，失败返回-1
参数:
serviceName: 服务名
action: 服务行为（"start", "stop", "restart"）
extArgv: 参数数组
extArgc: 参数个数 | @@ -313,13 +412,43 @@ init启动引导组件负责在系统启动阶段启动关键服务进程。 若 | int StartServiceByTimer(const char *serviceName, uint64_t timeout) | 定时启动服务 | 返回值：成功返回0，失败返回-1
参数:
serviceName: 服务名
timeout: 超时时间 | | int StopServiceTimer(const char *serviceName) | 停止服务计时器 | 返回值：成功返回0，失败返回-1
参数：
serviceName: 服务名 | + **表7** begetctl 命令说明 + + | 命令 | 命令格式和示例 | 说明 | + | :---------- | :---------- |:--------| + | init group test [stage] | init group test | statge参见ServiceStatus | + | param ls [-r] [name] | 显示系统参数，例如：
查看usb系统参数：begetctl param ls persist.sys.usb | 无 | + | param get [name] | 获取系统参数信息，例如：
begetctl param get 或 param get | 无 | + | param set name value| 设置系统参数，例如：
begetctl param set ohos.servicectrl.display 1 或 param set ohos.servicectrl.display 1| 无 | + | param wait name [value] [timeout] | 等待系统参数，例如：
begetctl param wait persist.sys.usb.config hdc 或 param wait persist.sys.usb.config hdc | timeout默认值：30 | + | param dump [verbose] | dump 系统参数信息，例如：
begetctl param dump 或 param dump| 无 | + | param shell [name] | 进入Parameter shell，例如：
begetctl param shell 或 param shell| 无 | + | timer_stop servicename | 停止服务计时器，例如：
begetctl timer_stop appspawn | servicename长度不超过96字符 | + | timer_start servicename timeout | 启动服务计时器，例如：
begetctl timer_start appspawn | servicename长度不超过96；timeout默认值：10 | + | start_service servicename | 启动服务，例如：
begetctl start_service appspawn 或 start_service appspawn | 无 | + | stop_service servicename | 停止服务，例如：
begetctl stop_service appspawn 或 stop_service appspawn | 无 | + | service_control start servicename | 启动服务，例如：
begetctl service_control start appspawn 或 service_control start appspawn | 无 | + | service_control stop servicename | 停止服务，例如：
begetctl service_control stop appspawn 或 service_control stop appspawn | 无 | + | misc_daemon --write_logo xxx.rgb | 写入开机logo，例如：
begetctl misc_daemon --write_logo logo.rgb 或 misc_daemon --write_logo logo.rgb| rgb文件最大不超过1024*2038，仅支持hi3516dv300 | + | reboot | 重启系统，例如：
begetctl reboot 或 reboot|无 | + | reboot shutdown | 关闭系统，例如：
begetctl reboot shutdown 或 reboot shutdown |无 | + | reboot suspend | 暂停系统，例如：
begetctl reboot suspend 或 reboot suspend | 无 | + | reboot updater | 重新启动并进入updater，例如：
begetctl reboot updater 或 reboot updater | 无 | + | reboot updater[:options] | 重新启动并进入updater，例如：
begetctl reboot updater 或 reboot updater | 无 | + | reboot flashd | 重新启动并进入flashd，例如：
begetctl reboot flashd 或 reboot flashd | 无 | + | reboot flashd[:options] | 重新启动并进入flashd，例如：
begetctl reboot flashd 或 reboot flashd | 无 | + | reboot charing | 重新启动并进入charing，例如：
begetctl reboot charing 或 reboot charing| 无 | + | reboot loader | 重新启动并进入烧写模式，例如：
begetctl reboot loader 或 reboot loader | 无 | + | bootchart stop | 停止图形分析，例如：
begetctl bootchart stop | 仅支持rk3568| + | bootchart start | 开始图形分析，例如：
begetctl bootchart start | 无 | + | bootchart disable | 图形分析不使能，例如：
begetctl bootchart disable | 无 | + | bootchart enable | 图形分析使能，例如：
begetctl bootchart enable | 无 | ## 开发实例 init启动引导程序，此处以要新增一个名为MySystemApp的系统服务为例进行说明，使用如下配置： - -``` + ``` { "jobs" : [{ "name" : "pre-init", @@ -360,7 +489,7 @@ init启动引导程序，此处以要新增一个名为MySystemApp的系统服 } ] } -``` + ``` 完成配置后，编译出包烧写单板：