From ead7328460e7a16619bf0cbefb631e619772a1e8 Mon Sep 17 00:00:00 2001 From: handyohos Date: Fri, 27 May 2022 09:53:43 +0800 Subject: [PATCH] feat: update startup system documentation MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 1）更新启动子系统的readme。 2）更新标准系统移植指导中的链接。 Signed-off-by: handyohos Change-Id: I6afeae2c9e313195781490ac22efc4c3480792c6 --- .../porting/standard-system-porting-guide.md | 2 +- ...15\345\255\220\347\263\273\347\273\237.md" | 233 +++--------------- 2 files changed, 32 insertions(+), 203 deletions(-) diff --git a/zh-cn/device-dev/porting/standard-system-porting-guide.md b/zh-cn/device-dev/porting/standard-system-porting-guide.md index 5ed66d6021..94565f72ec 100644 --- a/zh-cn/device-dev/porting/standard-system-porting-guide.md +++ b/zh-cn/device-dev/porting/standard-system-porting-guide.md @@ -161,7 +161,7 @@ BUILD.gn是subsystem构建的唯一入口。 init相关进程代码在//base/startup/init_lite目录下，该进程是系统第一个进程，无其它依赖。 - 初始化配置文件具体的开发指导请参考 [init启动引导组件](../subsystems/subsys-boot-init.md)。 + 初始化配置文件具体的开发指导请参考 [init启动子系统概述](../subsystems/subsys-boot-overview.md)。 ## HDF驱动移植 diff --git "a/zh-cn/readme/\345\220\257\345\212\250\346\201\242\345\244\215\345\255\220\347\263\273\347\273\237.md" "b/zh-cn/readme/\345\220\257\345\212\250\346\201\242\345\244\215\345\255\220\347\263\273\347\273\237.md" index d8c9947fa5..d4c67976bc 100755 --- "a/zh-cn/readme/\345\220\257\345\212\250\346\201\242\345\244\215\345\255\220\347\263\273\347\273\237.md" +++ "b/zh-cn/readme/\345\220\257\345\212\250\346\201\242\345\244\215\345\255\220\347\263\273\347\273\237.md" @@ -8,32 +8,32 @@ ## 简介 -启动恢复负责在内核启动之后到应用启动之前的系统关键进程和服务的启动过程以及设备恢复出厂设置的功能。涉及以下组件： +启动恢复负责在内核启动之后到应用启动之前的系统关键进程和服务的启动过程的功能。涉及以下组件： - init组件 - 支持使用LiteOS-A内核的平台，当前包括：Hi3516DV300平台和Hi3518EV300平台。 + 支持使用LiteOS-A和Linux内核的平台。 - 负责处理从内核加载第一个用户态进程开始，到第一个应用程序启动之间的系统服务进程启动过程。启动恢复子系统除负责加载各系统关键进程之外，还需在启动的同时设置其对应权限，并在子进程启动后对指定进程实行保活（若进程意外退出要重新启动），对于特殊进程意外退出时，启动恢复子系统还要执行系统复位操作。 + 负责处理从内核加载第一个用户态进程开始，到第一个应用程序启动之间的系统服务进程启动过程。启动恢复子系统除负责加载各系统关键进程之外，还需在启动的同时设置其对应权限，并在子进程启动后对指定进程实行保活（若进程意外退出要重新启动），对于核心进程意外退出时，启动恢复子系统还要执行系统重启操作。详见“[init启动引导组件](../device-dev/subsystems/subsys-boot-init.md)”部分。 - appspawn应用孵化器组件 - 支持使用LiteOS-A内核的平台，当前包括：Hi3516DV300平台和Hi3518EV300平台。 + 提供了Lite和Standard两个版本，Lite版本支持使用LiteOS-A内核的平台；Standard版本支持使用Linux内核的平台。 负责接受应用程序框架的命令孵化应用进程，设置其对应权限，并调用应用程序框架的入口。 - bootstrap启动引导组件 - 支持使用LiteOS-M内核的平台，当前包括：Hi3861平台。 + 支持使用LiteOS-M内核的平台。 提供了各服务和功能的启动入口标识。在SAMGR启动时，会调用boostrap标识的入口函数，并启动系统服务。 -- syspara系统属性组件 +- syspara系统参数组件 负责提供获取与设置操作系统相关的系统属性。 - LiteOS-M内核和LiteOS-A内核的平台，包括：Hi3861平台，Hi3516DV300平台，Hi3518EV300平台。支持的系统属性包括：默认系统属性、OEM厂商系统属性和自定义系统属性。OEM厂商部分仅提供默认值，具体值需OEM产品方按需进行调整，详见“[使用说明](#section8533192617117)”部分。 + 支持全量系统平台。支持的系统属性包括：默认系统属性、OEM厂商系统属性和自定义系统属性。OEM厂商部分仅提供默认值，具体值需OEM产品方按需进行调整，详见“[syspara系统属性组件](../device-dev/subsystems/subsys-boot-syspara.md)”部分。 ## 目录 @@ -41,6 +41,7 @@ **表 1** 启动恢复源代码目录结构 + - + + + + - - + - +

名称

描述

@@ -53,37 +54,39 @@

应用孵化器组件，appspawn进程，负责通过IPC机制接收Ability Manager Service消息，然后根据消息解析结果启动应用进程并赋予其对应权限。

Hi3516DV300

-

Hi3518EV300

+		LiteOS-A内核平台 +

base/startup/appspawn_standard

+

应用孵化器组件，appspawn进程，负责通过IPC机制接收Ability Manager Service消息，然后根据消息解析结果启动应用进程并赋予其对应权限。

+		Linux内核平台

base/startup/bootstrap_lite

启动引导组件，启动系统核心服务外的其他服务。

Hi3861

+		LiteOS-M内核平台

base/startup/init_lite

init组件，init进程，内核完成初始化后加载的第一个用户态进程，启动后解析/etc/init.cfg配置文件，并根据解析结果拉起其他系统关键进程，同时分别赋予其对应权限。

Hi3516DV300

-

Hi3518EV300

-		LiteOS-A内核平台以及Linux内核平台

base/startup/syspara_lite

系统属性组件。提供获取设备信息接口，如：产品名、品牌名、品类名、厂家名等。

Hi3861

-

Hi3516DV300

-

Hi3518EV300

-		全量平台
+ ``` base/startup/ ├── appspawn_standard # 标准系统应用孵化器组件 @@ -106,199 +109,25 @@ base/startup/ │ ├── include # init组件头文件目录 │ ├── src # init组件源文件目录 │ └── test # init组件测试用例源文件目录 -└── syspara_lite # 系统属性组件 - ├── adapter # 系统属性适配层源文件目录 - ├── frameworks # 系统属性组件源文件目录 - ├── hals # 系统属性组件硬件抽象层头文件目录 - ├── interfaces # 系统属性组件对外接口目录 +└── syspara_lite # 系统参数组件 + ├── adapter # 系统参数适配层源文件目录 + ├── frameworks # 系统参数组件源文件目录 + ├── hals # 系统参数组件硬件抽象层头文件目录 + ├── interfaces # 系统参数组件对外接口目录 └── simulator # 模拟器适配 ``` -## 约束 - -系统属性：OEM厂商相关仅提供默认值，具体值需产品方按需进行调整。 - -## 使用说明 - -- init的配置文件 +## 相关内容 - init配置文件包含了所有需要由init进程启动的系统关键服务的服务名、可执行文件路径、权限和其他属性信息，该文件位于代码仓库/vendor/hisilicon/hispark\_aries/init\_configs/目录，部署在/etc/下，文件名称为init.cfg，采用json格式，文件大小目前限制在100KB以内。 +[启动恢复子系统概述](../device-dev/subsystems/subsys-boot-overview.md) - init进程启动后首先读取/etc/init.cfg，然后解析其json内容，并根据解析结果依次加载系统服务。配置文件格式和内容说明如下所示： +[startup\_appspawn\_lite](https://gitee.com/openharmony/startup_appspawn_lite) +[startup\_appspawn](https://gitee.com/openharmony/startup_appspawn) -``` -{ - "jobs" : [{ - "name" : "pre-init", -------- 在init之前执行的job，可以放置一些启动进程之前的预操作（如新建文件夹等） - "cmds" : [ -------- 当前job支持的命令集合（当前cmd仅支持start/mkdir/chmod/chown/mount） - -------- 命令名称和参数（长度<=128字节）之间有且只能有一个空格 - "mkdir /testdir", -------- 创建文件夹命令，mkdir和目标文件夹之间有且只能有一个空格 - "chmod 0700 /testdir", -------- 修改权限命令，chmod 权限 目标 之间间隔有且仅有一个空格，权限必须为0xxx格式 - "chown 99 99 /testdir",-------- 修改属组命令，chown uid gid 目标 之间间隔有且仅有一个空格 - "mkdir /testdir2", - "mount vfat /dev/mmcblk0p0 /testdir2 noexec nosuid" -------- mount命令，格式为：mount 文件系统类型 source target flags data - -------- flags当前仅支持nodev、noexec、nosuid和rdonly，各项均以一个空格分开 - ] - }, { - "name" : "init", -------- job名称当前仅支持识别“pre-init”、“init”和“post-init” - "cmds" : [ -------- 单个job目前最多支持30条cmd - "start service1", -------- 启动服务命令1 - "start service2" -------- 启动服务命令2（可以根据需要调整命令在数组中的顺序，init进程将根据解析顺序依次执行） - ] - }, { - "name" : "post-init", -------- 在init之后执行的 job，可以放置一些启动进程之后的操作 - "cmds" : [] - } - ], - "services" : [{ -------- service集合（数组形式），包含了init进程需要启动的所有系统服务（当前最多支持100个服务） - "name" : "service1", -------- 当前服务的服务名，须确保非空且长度<=32字节 - "path" : "/bin/process1" -------- 当前服务的可执行文件全路径，须确保非空且长度<=64字节 - "uid" : 1, -------- 当前服务进程的uid值 - "gid" : 1, -------- 当前服务进程的gid值 - "once" : 0, -------- 当前服务进程是否为一次性进程 - 0 --- 当前服务非一次性进程，当进程因任何原因退出时，init收到SIGCHLD信号后将重新启动该服务进程 - 非0 --- 当前服务为一次性进程，当进程因任何原因退出时，init不会重新启动该服务进程 - "importance" : 1, -------- 当前服务是否为关键系统进程 - 0 --- 当前服务非关键系统进程，当进程因任何原因退出时，init不会做系统复位操作 - 非0 --- 当前服务为关键系统进程，当进程因任何原因退出时，init收到SIGCHLD信号后进行系统复位重启 - "caps" : [0, 1, 2, 5] -------- 当前服务所需的capability值，根据安全子系统已支持的capability，评估所需的capability，遵循最小权限原则配置（当前最多可配置100个值） - }, { - "name" : "service2", -------- 下一个需要init启动的服务。此处服务的顺序与启动顺序无关，启动顺序取决于上面job中的cmd顺序。 - "path" : "/bin/process2", - "uid" : 2, - "gid" : 2, - "once" : 1, - "importance" : 0, - "caps" : [ ] - } - ] -} -``` - -**表 2** cmds支持列表 - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

命令名称

-

命令格式

-

命令说明

-

start

-

start ServiceName 间隔有且仅有一个空格

-

启动服务，服务名称与文件中services数组中服务名称相同

-

mkdir

-

mkdir /xxxx/xxx 间隔有且仅有一个空格

-

创建目录

-

chmod

-

chmod 0xxx /xxx/xx 间隔有且仅有一个空格

-

修改权限，权限值必须为0xxx格式，如0755，0600等，需要遵循权限最小原则配置

-

chown

-

chown uid gid /xxx/xx 间隔有且仅有一个空格

-

修改属组

-

mount

-

mount fileSysType source target flags data

-

间隔有且仅有一个空格

-

挂载命令，其中flags目前仅支持nodev、noexec、nosuid和rdonly，其它字串均判定为data项

-
- -需要注意的是，init.cfg文件的修改需要保持json格式不被破坏，否则init进程解析失败后不会启动任何服务。对于配置的服务权限（uid/gid/capability）需要符合安全子系统要求且遵循权限最小原则。另外，对于once和importance项均为0的服务，若其在4分钟内连续退出次数超过4次，则init将终止重新启动该服务的操作。 - -- 系统参数 - - OEM厂商相关系统属性 - - Hi3516DV300，Hi3518EV300开发板需要修改vendor/hisilicon/hispark\_aries/hals/utils/sys\_param目录下源文件： - - ``` - static const char HOS_PRODUCT_TYPE[] = {"****"}; - static const char HOS_MANUFACTURE[] = {"****"}; - static const char HOS_BRAND[] = {"****"}; - static const char HOS_MARKET_NAME[] = {"****"}; - static const char HOS_PRODUCT_SERIES[] = {"****"}; - static const char HOS_PRODUCT_MODEL[] = {"****"}; - static const char HOS_SOFTWARE_MODEL[] = {"****"}; - static const char HOS_HARDWARE_MODEL[] = {"****"}; - static const char HOS_HARDWARE_PROFILE[] = {"aout:true,display:true"}; - static const char HOS_BOOTLOADER_VERSION[] = {"bootloader"}; - static const char HOS_SECURE_PATCH_LEVEL[] = {"2020-6-5"}; - static const char HOS_ABI_LIST[] = {"****"}; - ``` - - Hi3861开发板需要修改vendor/hisilicon/hispark\_pegasus/hals/utils/sys\_param目录下源文件： - - ``` - static const char HOS_PRODUCT_TYPE[] = {"****"}; - static const char HOS_MANUFACTURE[] = {"****"}; - static const char HOS_BRAND[] = {"****"}; - static const char HOS_MARKET_NAME[] = {"****"}; - static const char HOS_PRODUCT_SERIES[] = {"****"}; - static const char HOS_PRODUCT_MODEL[] = {"****"}; - static const char HOS_SOFTWARE_MODEL[] = {"****"}; - static const char HOS_HARDWARE_MODEL[] = {"****"}; - static const char HOS_HARDWARE_PROFILE[] = {"aout:true,display:true"}; - static const char HOS_BOOTLOADER_VERSION[] = {"bootloader"}; - static const char HOS_SECURE_PATCH_LEVEL[] = {"2020-6-5"}; - static const char HOS_ABI_LIST[] = {"****"}; - ``` - - - 获取默认系统属性 - - ``` - const char* value1 = GetProductType(); - printf("Product type =%s\n", value1); - const char* value2 = GetManufacture(); - printf("Manufacture =%s\n", value2); - const char* value3 = GetBrand(); - printf("GetBrand =%s\n", value3); - ``` - - - - 设置获取自定义系统属性 - - ``` - const char* defSysParam = "data of sys param ***..."; - char key[] = "rw.parameter.key"; - char value[] = "OEM-hisi-10.1.0"; - int ret = SetParameter(key, value); - char valueGet[128] = {0}; - ret = GetParameter(key, defSysParam, valueGet, 128); - printf("value = %s\n", valueGet); - ``` - - - -## 相关仓 - -启动恢复子系统 +[startup\_bootstrap\_lite](https://gitee.com/openharmony/startup_bootstrap_lite) [startup_init_lite](https://gitee.com/openharmony/startup_init_lite) -[startup_syspara_lite](https://gitee.com/openharmony/startup_syspara_lite) - -[startup_bootstrap_lite](https://gitee.com/openharmony/startup_bootstrap_lite) +[startup\_syspara\_lite](https://gitee.com/openharmony/startup_syspara_lite) -[startup_appspawn_lite](https://gitee.com/openharmony/startup_appspawn_lite) \ No newline at end of file -- GitLab