Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
OpenHarmony
Docs
提交
1733bf33
D
Docs
项目概览
OpenHarmony
/
Docs
大约 2 年 前同步成功
通知
161
Star
293
Fork
28
代码
文件
提交
分支
Tags
贡献者
分支图
Diff
Issue
0
列表
看板
标记
里程碑
合并请求
0
Wiki
0
Wiki
分析
仓库
DevOps
项目成员
Pages
D
Docs
项目概览
项目概览
详情
发布
仓库
仓库
文件
提交
分支
标签
贡献者
分支图
比较
Issue
0
Issue
0
列表
看板
标记
里程碑
合并请求
0
合并请求
0
Pages
分析
分析
仓库分析
DevOps
Wiki
0
Wiki
成员
成员
收起侧边栏
关闭侧边栏
动态
分支图
创建新Issue
提交
Issue看板
未验证
提交
1733bf33
编写于
3月 15, 2022
作者:
O
openharmony_ci
提交者:
Gitee
3月 15, 2022
浏览文件
操作
浏览文件
下载
差异文件
!1977 update Signed-off-by: xionglei <xionglei6@huawei.com>
Merge pull request !1977 from 熊磊/doc_0311
上级
1ee0096b
089e18f4
变更
1
显示空白变更内容
内联
并排
Showing
1 changed file
with
251 addition
and
78 deletion
+251
-78
zh-cn/device-dev/subsystems/subsys-boot-init.md
zh-cn/device-dev/subsystems/subsys-boot-init.md
+251
-78
未找到文件。
zh-cn/device-dev/subsystems/subsys-boot-init.md
浏览文件 @
1733bf33
# init启动引导组件<a name="ZH-CN_TOPIC_0000001062722441"></a>
# init启动引导组件<a name="ZH-CN_TOPIC_0000001062722441"></a>
-
[
init启动引导的配置文件
](
#section56901555917
)
## 功能说明<a name="section56901555916">
-
[
开发指导
](
#section15371931131117
)
-
[
开发实例
](
#section173413113565
)
init启动引导组件负责在系统启动阶段启动关键服务进程。 若用户需要新增随开机自启动的系统服务,可将新增服务加入配置文件init.cfg中
。
init启动引导组件负责在系统启动阶段启动关键服务进程。 若用户需要新增随开机自启动的系统服务,可添加新的配置文件xxx.cfg,系统会自动分析对应的cfg文件,并按照cfg文件启动对应的服务
。
##
init启动引导的配置文件<a name="section56901555917"></a>
-
init启动引导的配置文件
<a
name=
"section56901555917"
></a>
init启动引导组件配置文件包含了所有需要由init进程启动的系统关键服务的服务名、可执行文件路径、权限和其他信息,该文件位于代码仓库“vendor/huawei/camera/init
\_
configs/“目录
,烧写单板后可在“/etc/“目录下找到,文件名称为init.cfg,采用json格式,文件大小目前限制在100KB以内。
init启动引导组件配置文件包含了所有需要由init进程启动的系统关键服务的服务名、可执行文件路径、权限和其他信息
,烧写单板后可在“/etc/“目录下找到,文件名称为init.cfg,采用json格式,文件大小目前限制在100KB以内。
init进程启动后读取/etc/init.cfg,然后解析其json格式内容,并根据解析结果依次加载系统服务。
init进程启动后读取/etc/init.cfg,然后解析其json格式内容,并根据解析结果依次加载系统服务。
## 开发指导<a name="section15371931131117"></a>
各模块需要添加关键服务时,也可以添加模块对应的cfg文件,编译时拷贝文件到/system/etc/init目录下,init进程会解析改cfg文件,并启动对应的服务。
1.
配置jobs数组。
-
init服务启动控制(仅标准系统以上提供)
<a
name=
"section56901555918"
></a>
init会根据用户的服务配置,把服务分成三类,在不同的阶段进行启动。
-
“boot”类型:对应系统中需要优先启动的服务,这类服务在init完成init阶段后启动。
-
“normal”类型:默认配置,对应系统中的普通服务,这类服务在init命令执行完成后启动。
-
"condition"类型:对应有特殊要求的服务,可以直接通过start xxx 命令执行启动,一般在条件job或者在init的某个阶段使用命令启动。
服务间或服务与命令之间存在依赖关系,需要通过"condition"描述服务,例如:
```
"services" : [{
"name" : "service1",
"path" : ["/bin/process1", "param1", "param2"],
"uid" : 1,
"gid" : 1,
"once" : 0,
"importance" : 1,
"caps" : [0, 1, 2, 5],
"start-mode" : "condition",
"cpucore" : [0],
"critical" : [0, 5, 10],
"apl" : "normal",
"d-caps" : ["OHOS_DMS"]
"jobs" : {
"on-boot" : "boot",
"on-start" : "services:service1_start",
"on-stop" : "services:service1_stop",
"on-restart" : "services:service1_restart"
}
},
```
-
init服务并行控制(仅标准系统以上提供)
<a
name=
"section56901555919"
></a>
init提供服务并行处理能力,启动服务在不同的阶段执行job的能力。
-
“on-start”:在服务进程被fock后执行,不同服务的on-start job可以并行执行(在服务的子进程中执行,只对改进程产生影响)。
-
“on-stop”:在服务停止时执行。
-
"on-restart":在服务重启时执行。
-
init 按需启动(仅标准系统以上提供)
<a
name=
"section56901555920"
></a>
由init管理的服务支持按需启动,按需启动的服务不会在系统启动过程中主动被拉起,而是当某些事件发生时才会被init按需拉起,触发服务启动的事件可能是被init监听的相关socket有消息上报、samgr收到客户端的请求需要拉起SA服务等情况。
"ondemand" 属性是按需启动的服务的标志,一个服务配置了该属性值为true的时候,服务不再需要配置start命令来拉起,而是被监听的相应事件发生时才会被拉起。
-
SA进程按需启动
1.
应用请求SA句柄时samgr需识别SA所属进程是否可动态拉起。
2.
如需拉起,则需阻塞请求,等init拉起SA进程并注册SA后再返回所请求的SA句柄。
-
socket进程按需启动
1.
init在pre-fork阶段为socket类进程创建好socket,init中监听创建好的socket上的网络事件。
2.
socket上有报文事件后,init拉起socket进程进行报文处理,init进程取消socket数据的监听,由socket进程处理。
3.
socket进程无报文处理后,可以自动退出,退出后init回收该子进程并重新监听socket网络数据。
-
热插拔服务进程按需启动
<br>
 
进程可根据系统参数的变化进行热插拔事件按需启动处理。
-
init 进程启动&回收能力增强
<a
name=
"section56901555921"
></a>
进程启动时,支持在配置文件中配置服务进程的绑核、优先级、MAC信息以及AccessToken信息。
-
init提供修改
*
.cfg配置文件, 为服务进程提供cpu绑核功能。
-
init提供修改
*
.cfg配置文件, 为服务进程提供优先级设置。
-
init提供修改
*
.cfg配置文件, 为服务提供设置AccessToken, 为系统服务进程设置其分布式Capability能力(仅标准系统以上提供)。
-
init提供修改
*
.cfg配置文件, 为服务提供抑制机制。
-
init FD代持(仅标准系统以上提供)
<a
name=
"section56901555922"
></a>
FD代持是按需启动的一个辅助扩展机制,按需启动进程可以保持退出前的fd状态句柄不丢失。按需启动进程退出前可将fd发送给init代持,再次启动后再从init获取fd。
init提供了相关接口供服务调用,服务进程退出前调用接口将fd通过支持IPC通信的socket发送给init代持,待该服务重新启动时,init将持有的该服务相关的fd句柄通过同样的方式返回给服务。
-
init job
<a
name=
"section56901555923"
></a>
init提供job能力,一个job就是一组命令的集合。job可以在init.cfg中配置,也可以在模块的自定义cfg中配置。init解析程序会把相同名字job的命令合并到一个job中。同一名字的job只能保证init.cfg中的命令优先执行,其他cfg间的命令执行顺序不保证。
-
普通job:一般是init启动的固定阶段,如“pre-init“,”init“,”post-init“等,这类job在init启动的固定阶段执行。
-
自定义job:用户自定义的job,这类job按照一定的规则进行触发。
-
job:用户任意定义,可以通过trigger命令执行。
-
控制job(仅标准系统以上提供):按条件触发处理的能力。在job中可以设置触发条件,当对应的属性值满足设置的条件时,就会触发job执行。触发条件支持&&和||操作,可以根据不同的属性就行组合。
## 开发指导<a name="section56901555924"></a>
1.
配置jobs数组。
init启动引导组件将系统启动分为三个阶段:
init启动引导组件将系统启动分为三个阶段:
...
@@ -22,8 +105,6 @@ init进程启动后读取/etc/init.cfg,然后解析其json格式内容,并
...
@@ -22,8 +105,6 @@ init进程启动后读取/etc/init.cfg,然后解析其json格式内容,并
- “init”阶段:系统服务启动阶段。
- “init”阶段:系统服务启动阶段。
- “post-init”阶段:系统服务启动完后还需要执行的操作。
- “post-init”阶段:系统服务启动完后还需要执行的操作。
上述每个阶段用一个job表示,一个job对应一个命令集合,init通过依次执行每个job中的命令来完成系统初始化。job执行顺序:先执行“pre-init”,再执行“init”,最后执行“post-init”。
```
```
"jobs" : [{
"jobs" : [{
"name" : "pre-init",
"name" : "pre-init",
...
@@ -31,28 +112,24 @@ init进程启动后读取/etc/init.cfg,然后解析其json格式内容,并
...
@@ -31,28 +112,24 @@ init进程启动后读取/etc/init.cfg,然后解析其json格式内容,并
"mkdir /testdir",
"mkdir /testdir",
"chmod 0700 /testdir",
"chmod 0700 /testdir",
"chown 99 99 /testdir",
"chown 99 99 /testdir",
"mkdir /testdir2",
"mount vfat /dev/mmcblk0p0 /testdir2 noexec nosuid" // mount命令,格式为:mount 文件系统类型 source target flags data
"mount vfat /dev/mmcblk0p0 /testdir2 noexec nosuid" // mount命令,格式为:mount 文件系统类型 source target flags data
]
]
}, {
}, {
"name" : "init",
"name" : "init",
"cmds" : [
"cmds" : [
"start service1",
"start service1",
"start service2"
]
]
}, {
}, {
"name" : "post-init",
"name" : "post-init",
"cmds" : []
"cmds" : []
}
}
],
]
```
```
**表 1** 执行job介绍
**表 1**
执行job介绍
<a
name=
"table1801509284"
></a>
<table><thead
align=
"left"
><tr
id=
"row680703289"
><th
class=
"cellrowborder"
valign=
"top"
width=
"13.4%"
id=
"mcps1.2.3.1.1"
><p
id=
"p11805012282"
><a
name=
"p11805012282"
></a><a
name=
"p11805012282"
></a>
job名
</p>
<a name="table1801509284"></a>
<table><thead align="left"><tr id="row680703289"><th class="cellrowborder" valign="top" width="13.4%" id="mcps1.2.3.1.1"><p id="p11805012282"><a name="p11805012282"></a><a name="p11805012282"></a>job名</p>
</th>
</th>
<th class="cellrowborder" valign="top" width="86.6%" id="mcps1.2.3.1.2"><p id="p2811605289"><a name="p2811605289"></a><a name="p2811605289"></a>说明</p>
<th
class=
"cellrowborder"
valign=
"top"
width=
"86.6%"
id=
"mcps1.2.3.1.2"
><p
id=
"p2811605289"
><a
name=
"p2811605289"
></a><a
name=
"p2811605289"
></a>
说明
</p>
</th>
</th>
</tr>
</tr>
</thead>
</thead>
...
@@ -68,20 +145,16 @@ init进程启动后读取/etc/init.cfg,然后解析其json格式内容,并
...
@@ -68,20 +145,16 @@ init进程启动后读取/etc/init.cfg,然后解析其json格式内容,并
</tr>
</tr>
<tr
id=
"row181100162813"
><td
class=
"cellrowborder"
valign=
"top"
width=
"13.4%"
headers=
"mcps1.2.3.1.1 "
><p
id=
"p3811804281"
><a
name=
"p3811804281"
></a><a
name=
"p3811804281"
></a>
post-init
</p>
<tr
id=
"row181100162813"
><td
class=
"cellrowborder"
valign=
"top"
width=
"13.4%"
headers=
"mcps1.2.3.1.1 "
><p
id=
"p3811804281"
><a
name=
"p3811804281"
></a><a
name=
"p3811804281"
></a>
post-init
</p>
</td>
</td>
<td class="cellrowborder" valign="top" width="86.6%" headers="mcps1.2.3.1.2 "><p id="p18116016285"><a name="p18116016285"></a><a name="p18116016285"></a>最后被执行的job,如果开发者的进程在启动完成之后需要有一些处理(如驱动初始化后再挂载设备),可以把这类操作放到该job执行。</p>
<td
class=
"cellrowborder"
valign=
"top"
width=
"86.6%"
headers=
"mcps1.2.3.1.2 "
><p
id=
"p18116016285"
><a
name=
"p18116016285"
></a><a
name=
"p18116016285"
></a>
最后被执行的job,如果开发者的进程在启动完成之后需要有一些处理(如驱动初始化后再挂载设备),可以把这类操作放到该job执行。
单个job最多支持30条命令(当前仅支持start/mkdir/chmod/chown/mount/loadcfg),命令名称和后面的参数(参数长度≤128字节)之间有且只能有一个空格。
</p>
</td>
</td>
</tr>
</tr>
</tbody>
</tbody>
</table>
</table>
单个job最多支持30条命令(当前仅支持start/mkdir/chmod/chown/mount/loadcfg),命令名称和后面的参数(参数长度≤128字节)之间有且只能有一个空格。
**表 2**
命令集说明
<a
name=
"table122681439144112"
></a>
<table><thead
align=
"left"
><tr
id=
"row826873984116"
><th
class=
"cellrowborder"
valign=
"top"
width=
"10.15%"
id=
"mcps1.2.4.1.1"
><p
id=
"p826833919412"
><a
name=
"p826833919412"
></a><a
name=
"p826833919412"
></a>
命令
</p>
**表 2** 命令集说明
<a name="table122681439144112"></a>
<table><thead align="left"><tr id="row826873984116"><th class="cellrowborder" valign="top" width="10.15%" id="mcps1.2.4.1.1"><p id="p826833919412"><a name="p826833919412"></a><a name="p826833919412"></a>命令</p>
</th>
</th>
<th class="cellrowborder" valign="top" width="51.83%" id="mcps1.2.4.1.2"><p id="p3381142134118"><a name="p3381142134118"></a><a name="p3381142134118"></a>命令格式和示例</p>
<th
class=
"cellrowborder"
valign=
"top"
width=
"51.83%"
id=
"mcps1.2.4.1.2"
><p
id=
"p3381142134118"
><a
name=
"p3381142134118"
></a><a
name=
"p3381142134118"
></a>
命令格式和示例
</p>
</th>
</th>
<th
class=
"cellrowborder"
valign=
"top"
width=
"38.019999999999996%"
id=
"mcps1.2.4.1.3"
><p
id=
"p1268539154110"
><a
name=
"p1268539154110"
></a><a
name=
"p1268539154110"
></a>
说明
</p>
<th
class=
"cellrowborder"
valign=
"top"
width=
"38.019999999999996%"
id=
"mcps1.2.4.1.3"
><p
id=
"p1268539154110"
><a
name=
"p1268539154110"
></a><a
name=
"p1268539154110"
></a>
说明
</p>
</th>
</th>
...
@@ -142,9 +215,9 @@ init进程启动后读取/etc/init.cfg,然后解析其json格式内容,并
...
@@ -142,9 +215,9 @@ init进程启动后读取/etc/init.cfg,然后解析其json格式内容,并
</tbody>
</tbody>
</table>
</table>
2.
配置services数组,service集合(数组形式),包含了init进程需要启动的所有系统服务(最多支持100个)。
2.
配置services数组,service集合(数组形式),包含了init进程需要启动的所有系统服务(最多支持100个)。
```
```
"services" : [{
"services" : [{
"name" : "service1",
"name" : "service1",
"path" : ["/bin/process1", "param1", "param2"],
"path" : ["/bin/process1", "param1", "param2"],
...
@@ -152,7 +225,18 @@ init进程启动后读取/etc/init.cfg,然后解析其json格式内容,并
...
@@ -152,7 +225,18 @@ init进程启动后读取/etc/init.cfg,然后解析其json格式内容,并
"gid" : 1,
"gid" : 1,
"once" : 0,
"once" : 0,
"importance" : 1,
"importance" : 1,
"caps" : [0, 1, 2, 5]
"caps" : [0, 1, 2, 5],
"start-mode" : "condition",
"cpucore" : [0],
"critical" : [0, 5, 10],
"apl" : "normal",
"d-caps" : ["OHOS_DMS"]
"jobs" : {
"on-boot" : "boot",
"on-start" : "services:service1_start",
"on-stop" : "services:service1_stop",
"on-restart" : "services:service1_restart"
}
}, {
}, {
"name" : "service2",
"name" : "service2",
"path" : "/bin/process2",
"path" : "/bin/process2",
...
@@ -160,15 +244,17 @@ init进程启动后读取/etc/init.cfg,然后解析其json格式内容,并
...
@@ -160,15 +244,17 @@ init进程启动后读取/etc/init.cfg,然后解析其json格式内容,并
"gid" : 2,
"gid" : 2,
"once" : 1,
"once" : 1,
"importance" : 0,
"importance" : 0,
"caps" : [ ]
"caps" : [ ],
}
"cpucore" : 0,
]
"critical" : [ ],
```
"apl" : "normal",
"d-caps" : [ ]
}]
```
**表 3** service字段说明
**表 3**
service字段说明
<a
name=
"table14737791471"
></a>
<a name="table14737791471"></a>
<table><thead
align=
"left"
><tr
id=
"row273839577"
><th
class=
"cellrowborder"
valign=
"top"
width=
"16.64%"
id=
"mcps1.2.3.1.1"
><p
id=
"p107382095711"
><a
name=
"p107382095711"
></a><a
name=
"p107382095711"
></a>
字段名
</p>
<table><thead align="left"><tr id="row273839577"><th class="cellrowborder" valign="top" width="16.64%" id="mcps1.2.3.1.1"><p id="p107382095711"><a name="p107382095711"></a><a name="p107382095711"></a>字段名</p>
</th>
</th>
<th
class=
"cellrowborder"
valign=
"top"
width=
"83.36%"
id=
"mcps1.2.3.1.2"
><p
id=
"p17738189277"
><a
name=
"p17738189277"
></a><a
name=
"p17738189277"
></a>
说明
</p>
<th
class=
"cellrowborder"
valign=
"top"
width=
"83.36%"
id=
"mcps1.2.3.1.2"
><p
id=
"p17738189277"
><a
name=
"p17738189277"
></a><a
name=
"p17738189277"
></a>
说明
</p>
</th>
</th>
...
@@ -204,9 +290,7 @@ init进程启动后读取/etc/init.cfg,然后解析其json格式内容,并
...
@@ -204,9 +290,7 @@ init进程启动后读取/etc/init.cfg,然后解析其json格式内容,并
</tr>
</tr>
<tr
id=
"row386110321155"
><td
class=
"cellrowborder"
valign=
"top"
width=
"16.64%"
headers=
"mcps1.2.3.1.1 "
><p
id=
"p14861113212156"
><a
name=
"p14861113212156"
></a><a
name=
"p14861113212156"
></a>
importance
</p>
<tr
id=
"row386110321155"
><td
class=
"cellrowborder"
valign=
"top"
width=
"16.64%"
headers=
"mcps1.2.3.1.1 "
><p
id=
"p14861113212156"
><a
name=
"p14861113212156"
></a><a
name=
"p14861113212156"
></a>
importance
</p>
</td>
</td>
<td class="cellrowborder" valign="top" width="83.36%" headers="mcps1.2.3.1.2 "><p id="p166448210816"><a name="p166448210816"></a><a name="p166448210816"></a>当前服务进程是否为关键系统进程:</p>
<td
class=
"cellrowborder"
valign=
"top"
width=
"83.36%"
headers=
"mcps1.2.3.1.2 "
><p
id=
"p166448210816"
><a
name=
"p166448210816"
></a><a
name=
"p166448210816"
></a>
标准系统中:
<br>
服务进程优先级, 取值范围[-20, 19];
<br>
小型系统中:
<br>
0 : 非重要进程
<br>
1 : 重要进程
</p>
<p id="p8572182712811"><a name="p8572182712811"></a><a name="p8572182712811"></a>0:非关键系统进程,当该进程退出时,init不会将系统复位重启;</p>
<p id="p11861032111516"><a name="p11861032111516"></a><a name="p11861032111516"></a>1:关键系统进程,当该进程退出时,init将系统复位重启。</p>
</td>
</td>
</tr>
</tr>
<tr
id=
"row1689310618179"
><td
class=
"cellrowborder"
valign=
"top"
width=
"16.64%"
headers=
"mcps1.2.3.1.1 "
><p
id=
"p108931367177"
><a
name=
"p108931367177"
></a><a
name=
"p108931367177"
></a>
caps
</p>
<tr
id=
"row1689310618179"
><td
class=
"cellrowborder"
valign=
"top"
width=
"16.64%"
headers=
"mcps1.2.3.1.1 "
><p
id=
"p108931367177"
><a
name=
"p108931367177"
></a><a
name=
"p108931367177"
></a>
caps
</p>
...
@@ -214,13 +298,57 @@ init进程启动后读取/etc/init.cfg,然后解析其json格式内容,并
...
@@ -214,13 +298,57 @@ init进程启动后读取/etc/init.cfg,然后解析其json格式内容,并
<td
class=
"cellrowborder"
valign=
"top"
width=
"83.36%"
headers=
"mcps1.2.3.1.2 "
><p
id=
"p489313618173"
><a
name=
"p489313618173"
></a><a
name=
"p489313618173"
></a>
当前服务所需的capability值,根据安全子系统已支持的capability,评估所需的capability,遵循最小权限原则配置(当前最多可配置100个值)。
</p>
<td
class=
"cellrowborder"
valign=
"top"
width=
"83.36%"
headers=
"mcps1.2.3.1.2 "
><p
id=
"p489313618173"
><a
name=
"p489313618173"
></a><a
name=
"p489313618173"
></a>
当前服务所需的capability值,根据安全子系统已支持的capability,评估所需的capability,遵循最小权限原则配置(当前最多可配置100个值)。
</p>
</td>
</td>
</tr>
</tr>
</tr>
<tr
id=
"row1689310618179"
><td
class=
"cellrowborder"
valign=
"top"
width=
"16.64%"
headers=
"mcps1.2.3.1.1 "
><p
id=
"p108931367177"
><a
name=
"p108931367177"
></a><a
name=
"p108931367177"
></a>
critical
</p>
</td>
<td
class=
"cellrowborder"
valign=
"top"
width=
"83.36%"
headers=
"mcps1.2.3.1.2 "
><p
id=
"p489313618173"
><a
name=
"p489313618173"
></a><a
name=
"p489313618173"
></a>
critical服务启动失败后, 需要M秒内重新拉起, 拉起失败N次后, 直接重启系统, N默认为4, M默认20。(仅标准系统以上提供 "critical" : [0, 2, 10]; 类型为int型数组)。
<a
name=
"section56901555917"
></a><a
name=
"section56901555917"
></a></p>
<p
id=
"p8572182712811"
><a
name=
"p8572182712811"
></a><a
name=
"p8572182712811"
></a>
0:不使能;
</p>
<p
id=
"p11861032111517"
><a
name=
"p11861032111517"
></a><a
name=
"p11861032111517"
></a>
1:使能。
</p>
</td>
</tr>
</tr>
<tr
id=
"row1689310618179"
><td
class=
"cellrowborder"
valign=
"top"
width=
"16.64%"
headers=
"mcps1.2.3.1.1 "
><p
id=
"p108931367177"
><a
name=
"p108931367177"
></a><a
name=
"p108931367177"
></a>
cpucore
</p>
</td>
<td
class=
"cellrowborder"
valign=
"top"
width=
"83.36%"
headers=
"mcps1.2.3.1.2 "
><p
id=
"p489313618173"
><a
name=
"p489313618173"
></a><a
name=
"p489313618173"
></a>
服务需要的绑定的cpu核心数, 类型为int型数组。
<a
name=
"section56901555917"
></a><a
name=
"section56901555917"
></a></p>
</td>
</tr>
</tr>
<tr
id=
"row1689310618179"
><td
class=
"cellrowborder"
valign=
"top"
width=
"16.64%"
headers=
"mcps1.2.3.1.1 "
><p
id=
"p108931367177"
><a
name=
"p108931367177"
></a><a
name=
"p108931367177"
></a>
d-caps
</p>
</td>
<td
class=
"cellrowborder"
valign=
"top"
width=
"83.36%"
headers=
"mcps1.2.3.1.2 "
><p
id=
"p489313618173"
><a
name=
"p489313618173"
></a><a
name=
"p489313618173"
></a>
分布式能力 (仅标准系统以上提供)。
<a
name=
"section56901555917"
></a><a
name=
"section56901555917"
></a></p>
</td>
</tr>
</tr>
<tr
id=
"row1689310618179"
><td
class=
"cellrowborder"
valign=
"top"
width=
"16.64%"
headers=
"mcps1.2.3.1.1 "
><p
id=
"p108931367177"
><a
name=
"p108931367177"
></a><a
name=
"p108931367177"
></a>
apl
</p>
</td>
<td
class=
"cellrowborder"
valign=
"top"
width=
"83.36%"
headers=
"mcps1.2.3.1.2 "
><p
id=
"p489313618173"
><a
name=
"p489313618173"
></a><a
name=
"p489313618173"
></a>
能力特权级别:system_core, normal, system_basic。 默认system_core (仅标准系统以上提供)。
<a
name=
"section56901555917"
></a><a
name=
"section56901555917"
></a></p>
</td>
</tr>
<tr
id=
"row1689310618179"
><td
class=
"cellrowborder"
valign=
"top"
width=
"16.64%"
headers=
"mcps1.2.3.1.1 "
><p
id=
"p108931367177"
><a
name=
"p108931367177"
></a><a
name=
"p108931367177"
></a>
start-mode
</p>
</td>
<td
class=
"cellrowborder"
valign=
"top"
width=
"83.36%"
headers=
"mcps1.2.3.1.2 "
><p
id=
"p489313618173"
><a
name=
"p489313618173"
></a><a
name=
"p489313618173"
></a>
服务的启动模式,具体描述:init服务启动控制(仅标准系统以上提供)。
<a
name=
"section56901555917"
></a><a
name=
"section56901555917"
></a></p>
</td>
</tr>
<tr
id=
"row1689310618179"
><td
class=
"cellrowborder"
valign=
"top"
width=
"16.64%"
headers=
"mcps1.2.3.1.1 "
><p
id=
"p108931367177"
><a
name=
"p108931367177"
></a><a
name=
"p108931367177"
></a>
jobs
</p>
</td>
<td
class=
"cellrowborder"
valign=
"top"
width=
"83.36%"
headers=
"mcps1.2.3.1.2 "
><p
id=
"p489313618173"
><a
name=
"p489313618173"
></a><a
name=
"p489313618173"
></a>
当前服务在不同阶段可以执行的job。具体说明可以看:init服务并行控制(仅标准系统以上提供)。
<a
name=
"section56901555917"
></a></p>
</td>
</tr>
</tbody>
</tbody>
</table>
</table>
**表 4**
接口介绍
## 开发实例<a name="section173413113565"></a>
| 函数名 | 函数解释 |参数解释 |
| :---------- | :---------- |:--------|
| int
*ServiceGetFd(const char *
serviceName, size_t
*
outfdCount) | 获取init代持的fd | 返回值:成功返回fd数组指针,失败返回NULL。备注:需手动释放
<br>
参数:
<br>
serviceName: 服务名
<br>
outfdCount: 返回的fd数组长度 |
| int ServiceSaveFd(const char
*serviceName, int *
fds, int fdCount) | 请求init代持fd | 返回值:成功返回0,失败返回-1
<br>
参数:
<br>
serviceName: 服务名
<br>
fds: 需要init代持的fd数组指针
<br>
fdCount: fd数组长度
| int ServiceControlWithExtra(const char
*serviceName, int action, const char *
extArgv[], int extArgc) | 配置服务参数 | 返回值:成功返回0,失败返回-1
<br>
参数:
<br>
serviceName: 服务名
<br>
action: 服务行为("start", "stop", "restart")
<br>
extArgv: 参数数组
<br>
extArgc: 参数个数
| int ServiceControl(const char
*
serviceName, int action) | 控制服务行为 | 返回值:成功返回0,失败返回-1
<br>
参数:
<br>
serviceName: 服务名
<br>
action: 服务行为("start", "stop", "restart")
init启动引导程序,此处以要新增一个名为MySystemApp的系统服务为例进行说明,使用如下配置:
## 开发实例<a name="section56901555925"></a>
init启动引导程序,此处以要新增一个名为MySystemApp的系统服务为例进行说明,使用如下配置:
```
```
{
{
...
@@ -248,7 +376,15 @@ init启动引导程序,此处以要新增一个名为MySystemApp的系统服
...
@@ -248,7 +376,15 @@ init启动引导程序,此处以要新增一个名为MySystemApp的系统服
"gid" : 20, // MySystemApp系统服务的gid是20
"gid" : 20, // MySystemApp系统服务的gid是20
"once" : 0, // MySystemApp系统服务的非一次性进程,即如果MySystemApp系统服务因任何原因退出,init进程需要将其重新拉起
"once" : 0, // MySystemApp系统服务的非一次性进程,即如果MySystemApp系统服务因任何原因退出,init进程需要将其重新拉起
"importance" : 0, // MySystemApp系统服务不是关键系统进程,即如果MySystemApp系统服务因任何原因退出,init进程无需重启单板
"importance" : 0, // MySystemApp系统服务不是关键系统进程,即如果MySystemApp系统服务因任何原因退出,init进程无需重启单板
"caps" : [] // MySystemApp系统服务不需要任何capability权限(即MySystemApp系统服务不涉及与capability相关的操作)
"caps" : [], // MySystemApp系统服务不需要任何capability权限(即MySystemApp系统服务不涉及与capability相关的操作)
"start-mode" : "condition",
"critical": [1, 2, 10], //MySystemApp系统服务的critical配置,需传入三个参数, 分别为使能:1, 执行次数:2, 执行时间:10
"jobs" : {
"on-boot" : "boot",
"on-start" : "services:MySystemApp_start",
"on-stop" : "services:MySystemApp_stop",
"on-restart" : "services:MySystemApp_restart"
}
}
}
]
]
}
}
...
@@ -260,3 +396,40 @@ init启动引导程序,此处以要新增一个名为MySystemApp的系统服
...
@@ -260,3 +396,40 @@ init启动引导程序,此处以要新增一个名为MySystemApp的系统服
2.
使用kill命令将上述新增的MySystemApp进程杀死,观察该进程是否会被重新拉起(此处应该为重新拉起)。
2.
使用kill命令将上述新增的MySystemApp进程杀死,观察该进程是否会被重新拉起(此处应该为重新拉起)。
3.
使用kill命令将上述新增的MySystemApp进程杀死,观察是否会导致单板重启(此处应该为不重启)。
3.
使用kill命令将上述新增的MySystemApp进程杀死,观察是否会导致单板重启(此处应该为不重启)。
## 常见问题<a name="section56901555926"></a>
### 服务不存在<a name="section56901555927"></a>
 
**现象描述**
<br>
  
内核Log打印 "Failed get servName"。
 
**原因分析**
<br>
 
 
kernel log 的输出,都是由init 打印。在init 中查找对应的代码位置。发现是服务不存在。
 
**解决方法**
<br>
 
 
1. 确认服务是否在cfg中正确配置。
<br>
 
 
2. 服务的cfg文件是否正常加载。
<br>
 
 
3. cfg文件格式是否正确。
### 请求其他服务代持fd,init有报错<a name="section56901555928"></a>
 
**现象描述**
 
 
内核Log打印 "Service
\'
xxx
\'
(pid = xxx) is not valid or request with unexpected process(pid = xxx)"。
 
**原因分析**
<br>
 
 
kernel log 的输出,都是由init 打印。在init 中查找对应的代码位置。发现是其他服务代持fd。
 
**解决方法**
<br>
 
 
只支持代持本服务的fd, 不允许让其他服务代持fd。
### 服务没有配置ondemand 选项<a name="section56901555929"></a>
 
**现象描述**
<br>
 
 
内核Log打印 "service : %s had started already"。
 
**原因分析**
<br>
 
 
kernel log 的输出,都是由init 打印。在init 中查找对应的代码位置。发现是服务没有配置ondemand。
 
**解决方法**
<br>
 
 
服务对应的.cfg文件正确配置如: "ondemand" : true。
\ No newline at end of file
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录