未验证 提交 4dd4783e 编写于 作者: O openharmony_ci 提交者: Gitee

!7922 Fix: 纯净化init开发指南和刷新begetctl命令

Merge pull request !7922 from Mupceet/doc_0809
...@@ -20,11 +20,11 @@ bootchart 只支持标准系统, begetctl 支持小型系统和标准系统。 ...@@ -20,11 +20,11 @@ bootchart 只支持标准系统, begetctl 支持小型系统和标准系统。
| param ls [-r] [name] | 显示系统参数,例如:<br>查看usb系统参数:begetctl param ls persist.sys.usb | 无 | | param ls [-r] [name] | 显示系统参数,例如:<br>查看usb系统参数:begetctl param ls persist.sys.usb | 无 |
| param get [name] | 获取系统参数信息,例如:<br>begetctl param get 或 param get | 无 | | param get [name] | 获取系统参数信息,例如:<br>begetctl param get 或 param get | 无 |
| param set name value| 设置系统参数,例如:<br>begetctl param set ohos.servicectrl.display 1 或 param set ohos.servicectrl.display 1| 无 | | param set name value| 设置系统参数,例如:<br>begetctl param set ohos.servicectrl.display 1 或 param set ohos.servicectrl.display 1| 无 |
| param wait name [value] [timeout] | 等待系统参数,例如:<br>begetctl param wait persist.sys.usb.config hdc 或 param wait persist.sys.usb.config hdc | timeout默认值:30 | | param wait name [value] [timeout] | 等待系统参数,例如:<br>begetctl param wait persist.sys.usb.config hdc 或 param wait persist.sys.usb.config hdc | timeout默认值:30 |
| param dump [verbose] | dump 系统参数信息,例如:<br>begetctl param dump 或 param dump| 无 | | param dump [verbose] | dump 系统参数信息,例如:<br>begetctl param dump 或 param dump| 无 |
| param shell [name] | 进入Parameter shell,例如:<br>begetctl param shell 或 param shell| 无 | | param shell [name] | 进入Parameter shell,例如:<br>begetctl param shell 或 param shell| 无 |
| timer_stop servicename | 停止服务计时器,例如:<br>begetctl timer_stop appspawn | servicename长度不超过96字符 | | timer_stop servicename | 停止服务计时器,例如:<br>begetctl timer_stop appspawn | servicename长度不超过96字符 |
| timer_start servicename timeout | 启动服务计时器,例如:<br>begetctl timer_start appspawn | servicename长度不超过96;timeout默认值:10s | | timer_start servicename timeout | 启动服务计时器,例如:<br>begetctl timer_start appspawn | servicename长度不超过96;timeout默认值:10毫秒 |
| start_service servicename | 启动服务,例如:<br>begetctl start_service appspawn 或 start_service appspawn | 无 | | start_service servicename | 启动服务,例如:<br>begetctl start_service appspawn 或 start_service appspawn | 无 |
| stop_service servicename | 停止服务,例如:<br>begetctl stop_service appspawn 或 stop_service appspawn | 无 | | stop_service servicename | 停止服务,例如:<br>begetctl stop_service appspawn 或 stop_service appspawn | 无 |
| service_control start servicename | 启动服务,例如:<br>begetctl service_control start appspawn 或 service_control start appspawn | 无 | | service_control start servicename | 启动服务,例如:<br>begetctl service_control start appspawn 或 service_control start appspawn | 无 |
...@@ -37,17 +37,23 @@ bootchart 只支持标准系统, begetctl 支持小型系统和标准系统。 ...@@ -37,17 +37,23 @@ bootchart 只支持标准系统, begetctl 支持小型系统和标准系统。
| reboot updater[:options] | 重新启动并进入updater,例如:<br>begetctl reboot updater 或 reboot updater | 无 | | reboot updater[:options] | 重新启动并进入updater,例如:<br>begetctl reboot updater 或 reboot updater | 无 |
| reboot flashd | 重新启动并进入flashd,例如:<br>begetctl reboot flashd 或 reboot flashd | 无 | | reboot flashd | 重新启动并进入flashd,例如:<br>begetctl reboot flashd 或 reboot flashd | 无 |
| reboot flashd[:options] | 重新启动并进入flashd,例如:<br>begetctl reboot flashd 或 reboot flashd | 无 | | reboot flashd[:options] | 重新启动并进入flashd,例如:<br>begetctl reboot flashd 或 reboot flashd | 无 |
| reboot charging | 重新启动并进入charging,例如:<br>begetctl reboot charging 或 reboot charging| 无 | | reboot charge | 重新启动并进入charge,例如:<br>begetctl reboot charge 或 reboot charge | 无 |
| reboot loader | 重新启动并进入烧写模式,例如:<br>begetctl reboot loader 或 reboot loader | 无 | | reboot loader | 重新启动并进入烧写模式,例如:<br>begetctl reboot loader 或 reboot loader | 无 |
| bootchart stop | 停止图形分析,例如:<br>begetctl bootchart stop | 仅支持rk3568| | bootchart stop | 停止图形分析,例如:<br>begetctl bootchart stop | 仅支持rk3568|
| bootchart start | 开始图形分析,例如:<br>begetctl bootchart start | 无 | | bootchart start | 开始图形分析,例如:<br>begetctl bootchart start | 无 |
| bootchart disable | 图形分析不使能,例如:<br>begetctl bootchart disable | 无 | | bootchart disable | 图形分析不使能,例如:<br>begetctl bootchart disable | 无 |
| bootchart enable | 图形分析使能,例如:<br>begetctl bootchart enable | 无 | | bootchart enable | 图形分析使能,例如:<br>begetctl bootchart enable | 无 |
| sandbox -s service_name | 服务进沙盒,例如 <br>sandbox -s foundation | 无 | | sandbox -s service_name | 服务进沙盒,例如<br>sandbox -s foundation | 无 |
| sandbox -p process_name | 进程进沙盒,例如 <br>sandbox -p /bin/sh | 无 | | sandbox -p process_name | 进程进沙盒,例如<br>sandbox -p /bin/sh | 无 |
| sandbox -n sandbox_name | 进入配置的system或者chipset沙盒,<br>sandbox -n system | 无 | | sandbox -n sandbox_name | 进入配置的system或者chipset沙盒,例如:<br>sandbox -n system | 无 |
| sandbox -h | sandbox command help | 无 | | sandbox -h | sandbox command help | 无 |
| partitionslot getslot | 获取当前活动slot,例如:<br>begetctl partitionslot getslot 或 partitionslot getslot | 无 |
| partitionslot getsuffix slot | 获取当前匹配slot,例如:<br>begetctl partitionslot getsuffix 1 或 partitionslot getsuffix 1 | 无 |
| partitionslot setactive slot | 设置活动slot,例如:<br>begetctl partitionslot setactive 1 或 partitionslot setactive 1 | 无 |
| partitionslot setunboot slot | 设置非活动slot,例如:<br>begetctl partitionslot setunboot 1 或 partitionslot setunboot 1 | 无 |
| modulectl uninstall moduleName | 卸载动态插件,例如:<br>modulectl uninstall bootchart | 无 |
| modulectl install moduleName | 安装动态插件,例如:<br>modulectl install bootchart | 无 |
| modulectl list | 动态插件列表,例如:<br>begetctl modulectl list | 无 |
## 开发指导 ## 开发指导
......
...@@ -115,239 +115,23 @@ ...@@ -115,239 +115,23 @@
### 参数说明 ### 参数说明
**表1** service字段说明<a name="table14737791471"></a> **表1** service字段说明<a name="table14737791471"></a>
<table border="0" cellpadding="0" cellspacing="0" width="737" style="border-collapse: collapse;table-layout:fixed;width:554pt;border-spacing: 0px;font-variant-ligatures: normal; font-variant-caps: normal;orphans: 2;widows: 2;-webkit-text-stroke-width: 0px; text-decoration-thickness: initial;text-decoration-style: initial;text-decoration-color: initial"> | 字段名 | 支持系统类型 | 字段说明 | 字段解释 |
<tbody> | ---------- |-------- | --------| --------|
<tr height="24" style="height:18.0pt"> | name | 小型系统和标准系统 | 当前服务的服务名。(必选) | 类型:字符串; 服务名非空且长度<=32字节。|
<th height="24" class="xl6521805" width="126" style="height:18.0pt;width:95pt"> | path | 小型系统和标准系统 | 当前服务的可执行文件全路径和参数,数组形式。 (必选) | 确保第一个数组元素为可执行文件路径、数组元素个数<=20。 <br> 每个元素为字符串形式以及每个字符串长度<=64字节。|
字段名 | uid | 小型系统和标准系统 | 当前服务进程的uid值。 | 类型:int、字符串。 |
</th> | gid | 小型系统和标准系统 | 当前服务进程的gid值。 | 类型:int、int[]、字符串、字符串数组。 |
<th class="xl6521805" width="196" style="border-left:none;width:147pt"> | once | 小型系统和标准系统 | 当前服务进程是否为一次性进程。 | 1:一次性进程,当该进程退出时,init不会重新启动该服务进程。 <br>0 : 常驻进程,当该进程退出时,init收到SIGCHLD信号并重新启动该服务进程。 |
字段说明 | importance | 小型系统和标准系统 | <br>标准系统:当前服务优先级<br>小型系统:标记服务重要性 | <br>标准系统中: 服务优先级取值范围 [-20, 19],超出为无效设置。<br>小型系统中:0 : 不重启系统;非0 : 重启系统 |
</th> | caps | 小型系统和标准系统 | 当前服务所需的capability值,根据安全子系统已支持的capability,评估所需的capability,遵循最小权限原则配置。| 类型:数字或者字符串数组,在配置数字时,按linux标准的capability进行配置。字符串时,使用标准定义的宏的名字进行配置。 |
<th class="xl6521805" width="242" style="border-left:none;width:182pt"> | critical | 标准系统 | 为服务提供抑制机制,服务在配置时间 T 内,频繁重启次数超过设置次数 N 重启系统。 | <br>标准系统中: 类型:int[],如:"critical" : [M, N, T],<br>其中M:使能标志位(0:不使能;1:使能), N:频繁拉起服务次数, T:时间(单位:秒)。M > 0; N > 0。 <br> 小型系统中 & 标准系统中:类型:int,如:"critical" : M,<br>其中 M:使能标志位(0:不使能;1:使能)。 默认拉起服务次数:4次, 时间:20秒 。|
字段解释 | cpucore | 标准系统 | 服务需要的绑定的cpu核心数 | 类型:int型数组, 如"cpucore" : [N1, N2, ...], N1, N2均为需要绑定的cpu核索引, 如单核设备 cpucore : [0]。 |
</th> | d-caps | 标准系统 | 服务分布式能力。| 类型:字符串数组, 如 "d-caps" : ["OHOS_DMS"]。 |
<th class="xl6521805" width="173" style="border-left:none;width:130pt"> | apl | 标准系统 | 服务能力特权级别。 | 类型:字符串, 如 "apl" : "system_core"。<br> 目前支持"system_core"(默认值), "normal", "system_basic"。 |
支持系统类型 | start-mode | 标准系统 | 服务的启动模式。 | 类型:字符串, 如 "start-mode" : "condition"。<br>目前支持"boot", "normal", "condition"。具体说明参考:[init服务启动控制](#section56901555918)。 |
</th> | ondemand | 小型系统和标准系统 | 按需启动服务的标志。 | 类型:bool,如"ondemand" : true,小型系统只在Linux内核上支持。<br>具体说明参考:[init服务按需启动](#section56901555920)。|
</tr> | disable | 小型系统和标准系统 | 预留字段,无实际意义。 | 无。 |
<tr height="111" style="mso-height-source:userset;height:83.25pt"> | sandbox | 标准系统 | 沙盒功能是否打开。 | 1:打开服务的沙盒功能 (默认值)。<br>0:关闭服务的沙盒功能。 |
<td height="111" class="xl6621805" width="126" style="height:83.25pt;border-top: none;width:95pt">
name
</td>
<td class="xl6621805" width="196" style="border-top:none;border-left:none; width:147pt">
当前服务的服务名。(必选)
</td>
<td class="xl6621805" width="242" style="border-top:none;border-left:none; width:182pt">
类型:字符串; 服务名非空且长度&lt;=32字节。
</td>
<td class="xl6621805" width="173" style="border-top:none;border-left:none; width:130pt">
小型系统和标准系统
</td>
</tr>
<tr height="185" style="mso-height-source:userset;height:138.75pt">
<td height="185" class="xl6621805" width="126" style="height:138.75pt;border-top: none;width:95pt">
path
</td>
<td class="xl6621805" width="196" style="border-top:none;border-left:none; width:147pt">
当前服务的可执行文件全路径和参数,数组形式。 (必选)
</td>
<td class="xl6621805" width="242" style="border-top:none;border-left:none; width:182pt">
确保第一个数组元素为可执行文件路径、数组元素个数&lt;=20。<br>
每个元素为字符串形式以及每个字符串长度&lt;=64字节。
</td>
<td class="xl6621805" width="173" style="border-top:none;border-left:none; width:130pt">
小型系统和标准系统
</td>
</tr>
<tr height="71" style="mso-height-source:userset;height:53.25pt">
<td height="71" class="xl6621805" width="126" style="height:53.25pt;border-top: none;width:95pt">
uid
</td>
<td class="xl6621805" width="196" style="border-top:none;border-left:none; width:147pt">
当前服务进程的uid值。
</td>
<td class="xl6621805" width="242" style="border-top:none;border-left:none; width:182pt">
类型:int、字符串。
</td>
<td class="xl6621805" width="173" style="border-top:none;border-left:none; width:130pt">
小型系统和标准系统
</td>
</tr>
<tr height="93" style="mso-height-source:userset;height:69.75pt">
<td height="93" class="xl6621805" width="126" style="height:69.75pt;border-top: none;width:95pt">
gid
</td>
<td class="xl6621805" width="196" style="border-top:none;border-left:none; width:147pt">
当前服务进程的gid值。
</td>
<td class="xl6621805" width="242" style="border-top:none;border-left:none; width:182pt">
类型:int、int[]、字符串、字符串数组。
</td>
<td class="xl6621805" width="173" style="border-top:none;border-left:none; width:130pt">
小型系统和标准系统
</td>
</tr>
<tr height="218" style="mso-height-source:userset;height:163.5pt">
<td height="218" class="xl6621805" width="126" style="height:163.5pt;border-top: none;width:95pt">
once
</td>
<td class="xl6621805" width="196" style="border-top:none;border-left:none; width:147pt">
当前服务进程是否为一次性进程。
</td>
<td class="xl6621805" width="242" style="border-top:none;border-left:none; width:182pt">
1:一次性进程,当该进程退出时,init不会重新启动该服务进程。<br>
0 : 常驻进程,当该进程退出时,init收到SIGCHLD信号并重新启动该服务进程。
</td>
<td class="xl6621805" width="173" style="border-top:none;border-left:none; width:130pt">
小型系统和标准系统
</td>
</tr>
<tr height="182" style="mso-height-source:userset;height:136.5pt">
<td height="182" class="xl6621805" width="126" style="height:136.5pt;border-top: none;width:95pt">
importance
</td>
<td class="xl6621805" width="196" style="border-top:none;border-left:none; width:147pt">
标准系统:当前服务优先级<br>小型系统:标记服务重要性
</td>
<td class="xl6621805" width="242" style="border-top:none;border-left:none; width:182pt">
标准系统中: 服务优先级取值范围 [-20, 19],超出为无效设置。<br>
小型系统中:0 :不重启系统 ;非0 : 重启系统。
</td>
<td class="xl6621805" width="173" style="border-top:none;border-left:none; width:130pt">
小型系统和标准系统
</td>
</tr>
<tr height="219" style="mso-height-source:userset;height:164.25pt">
<td height="219" class="xl6621805" width="126" style="height:164.25pt;border-top: none;width:95pt">
caps
</td>
<td class="xl6621805" width="196" style="border-top:none;border-left:none; width:147pt">
当前服务所需的capability值,根据安全子系统已支持的capability,评估所需的capability,遵循最小权限原则配置。
</td>
<td class="xl6621805" width="242" style="border-top:none;border-left:none; width:182pt">
类型:数字或者字符串数组,在配置数字时,按linux标准的capability进行配置。字符串时,使用标准定义的宏的名字进行配置。
</td>
<td class="xl6621805" width="173" style="border-top:none;border-left:none; width:130pt">
小型系统和标准系统
</td>
</tr>
<tr height="405" style="mso-height-source:userset;height:303.75pt">
<td height="405" class="xl6621805" width="126" style="height:303.75pt;border-top: none;width:95pt">
critical
</td>
<td class="xl6621805" width="196" style="border-top:none;border-left:none; width:147pt">
为服务提供抑制机制,服务在配置时间 T 内,频繁重启次数超过设置次数 N 重启系统。
</td>
<td class="xl6621805" width="242" style="border-top:none;border-left:none; width:182pt">
标准系统中: 类型:int[],如:"critical" : [M, N, T],其中M:使能标志位(0:不使能;1:使能), N:频繁拉起服务次数, T:时间(单位:秒)。M &gt; 0; N &gt; 0。<br>
小型系统中 &amp; 标准系统中:类型:int,如:"critical" : M,其中 M:使能标志位(0:不使能;1:使能)。 默认拉起服务次数:4次, 时间:20秒 。
</td>
<td class="xl6621805" width="173" style="border-top:none;border-left:none; width:130pt">
标准系统
</td>
</tr>
<tr height="173" style="mso-height-source:userset;height:129.75pt">
<td height="173" class="xl6621805" width="126" style="height:129.75pt;border-top: none;width:95pt">
cpucore
</td>
<td class="xl6621805" width="196" style="border-top:none;border-left:none; width:147pt">
服务需要的绑定的cpu核心数
</td>
<td class="xl6621805" width="242" style="border-top:none;border-left:none; width:182pt">
类型:int型数组, 如"cpucore" : [N1, N2, ...], N1, N2均为需要绑定的cpu核索引, 如单核设备 cpucore : [0]。
</td>
<td class="xl6621805" width="173" style="border-top:none;border-left:none; width:130pt">
标准系统
</td>
</tr>
<tr height="116" style="mso-height-source:userset;height:87.0pt">
<td height="116" class="xl6621805" width="126" style="height:87.0pt;border-top: none;width:95pt">
d-caps
</td>
<td class="xl6621805" width="196" style="border-top:none;border-left:none; width:147pt">
服务分布式能力(仅标准系统以上提供)。
</td>
<td class="xl6621805" width="242" style="border-top:none;border-left:none; width:182pt">
类型:字符串数组, 如 "d-caps" : ["OHOS_DMS"]。
</td>
<td class="xl6621805" width="173" style="border-top:none;border-left:none; width:130pt">
标准系统
</td>
</tr>
<tr height="182" style="mso-height-source:userset;height:136.5pt">
<td height="182" class="xl6621805" width="126" style="height:136.5pt;border-top: none;width:95pt">
apl
</td>
<td class="xl6621805" width="196" style="border-top:none;border-left:none; width:147pt">
服务能力特权级别(仅标准系统以上提供)。
</td>
<td class="xl6621805" width="242" style="border-top:none;border-left:none; width:182pt">
类型:字符串, 如 "apl" : "system_core"。 目前支持"system_core"(默认值), "normal", "system_basic"。
</td>
<td class="xl6621805" width="173" style="border-top:none;border-left:none; width:130pt">
标准系统
</td>
</tr>
<tr height="193" style="mso-height-source:userset;height:144.75pt">
<td height="193" class="xl6621805" width="126" style="height:144.75pt;border-top: none;width:95pt">
start-mode
</td>
<td class="xl6621805" width="196" style="border-top:none;border-left:none; width:147pt">
服务的启动模式(仅标准系统以上提供)。
</td>
<td class="xl6721805" width="242" style="border-top:none;border-left:none; width:182pt">
<a href="#section56901555918">类型:字符串, 如 "start-mode" : "condition"。目前支持"boot", "normal", "condition"。具体说明参考:init服务启动控制。</a>
</td>
<td class="xl6621805" width="173" style="border-top:none;border-left:none; width:130pt">
标准系统
</td>
</tr>
<tr height="147" style="mso-height-source:userset;height:110.25pt">
<td height="147" class="xl6621805" width="126" style="height:110.25pt;border-top: none;width:95pt">
ondemand
</td>
<td class="xl6621805" width="196" style="border-top:none;border-left:none; width:147pt">
按需启动服务的标志。
</td>
<td class="xl6721805" width="242" style="border-top:none;border-left:none; width:182pt">
<a href="#section56901555920">类型:bool,如"ondemand" : true,小型系统只在Linux内核上支持。具体说明参考:init服务按需启动。</a>
</td>
<td class="xl6621805" width="173" style="border-top:none;border-left:none; width:130pt">
小型系统和标准系统
</td>
</tr>
<tr height="72" style="mso-height-source:userset;height:54.0pt">
<td height="72" class="xl6621805" width="126" style="height:54.0pt;border-top:none; width:95pt">
disable
</td>
<td class="xl6621805" width="196" style="border-top:none;border-left:none; width:147pt">
预留字段,无实际意义。
</td>
<td class="xl6621805" width="242" style="border-top:none;border-left:none; width:182pt">
无。
</td>
<td class="xl6621805" width="173" style="border-top:none;border-left:none; width:130pt">
小型系统和标准系统
</td>
</tr>
<tr height="106" style="mso-height-source:userset;height:79.5pt">
<td height="106" class="xl6621805" width="126" style="height:79.5pt;border-top: none;width:95pt">
sandbox
</td>
<td class="xl6621805" width="196" style="border-top:none;border-left:none; width:147pt">
沙盒功能是否打开。
</td>
<td class="xl6621805" width="242" style="border-top:none;border-left:none; width:182pt">
1:打开服务的沙盒功能 (默认值)。<br>
0:关闭服务的沙盒功能。
</td>
<td class="xl6621805" width="173" style="border-top:none;border-left:none; width:130pt">
标准系统
</td><!--[endif]-->
</tr>
</tbody>
</table>
**表2** socket字段说明 **表2** socket字段说明
| 字段名 | 说明 | | 字段名 | 说明 |
......
Markdown is supported
0% .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑!
想要评论请 注册