diff --git a/en/device-dev/subsystems/subsys-boot-init-jobs.md b/en/device-dev/subsystems/subsys-boot-init-jobs.md index 6f2ac0146fa39c64a2103da985977c2616bffc23..e725ce382f10b45e96c609d43f51efe8b37c982f 100644 --- a/en/device-dev/subsystems/subsys-boot-init-jobs.md +++ b/en/device-dev/subsystems/subsys-boot-init-jobs.md @@ -1,6 +1,6 @@ # Job Management ## Overview -### Kconfig Visual Configuration +### Overview A job is a set of commands in the **.cfg** file of the init module. A maximum of 4096 jobs can be added. Jobs can be configured in the [.cfg file](subsys-boot-init-cfg.md). Generally, jobs are executed during initialization to serve the normal startup of services or the initialization of specific basic functions. ### Basic Concepts @@ -99,7 +99,7 @@ Job management is a part of the init startup process. It is a process-based func |static void SendTriggerEvent(int type, const char *content, uint32_t contentLen)|Performs functions such as system control and starting or stopping of services based on system parameters.| Standard system| |static void DoTriggerCmd(const struct CmdArgs *ctx)|Executes the trigger command.| Standard system| |void DoTriggerExec(const char *triggerName)| Finds a command group based on the job name and pushes the commands in the command group to the execution queue.| Standard system| -|void DoJob(const char *jobName)|Matches a job based on the job name and invokes DoCmdByIndex
to execute the commands in the job.| Small system| +|void DoJob(const char *jobName)|Matches a job based on the job name and invokes DoCmdByIndex to execute the commands in the job.| Small system| |void DoCmdByIndex(int index, const char *cmdContent)|Combines parameters and commands.| Small and standard systems| ### Development Example diff --git a/en/device-dev/subsystems/subsys-boot-init-plugin.md b/en/device-dev/subsystems/subsys-boot-init-plugin.md index 2cb75ad293274718c856e37a8b254cbb83b66ae3..eb1a87af1c08fed7f0ee84f681c988bf19b37586 100644 --- a/en/device-dev/subsystems/subsys-boot-init-plugin.md +++ b/en/device-dev/subsystems/subsys-boot-init-plugin.md @@ -59,7 +59,7 @@ bootchart is available only for the standard system, and begetctl is available f ### Available APIs - **Table 1** Description of APIs + **Table 1** Description of plug-in management APIs | API| Description| | ---------- | ---------- | | void PluginExecCmdByName(const char *name, const char *cmdContent) | Starts a plug-in by name.| @@ -87,7 +87,7 @@ bootchart is available only for the standard system, and begetctl is available f MODULE_CONSTRUCTOR(void) { - // Depends on parameter service + // Depending on parameter service InitAddPostPersistParamLoadHook(0, bootchartEarlyHook); } ``` diff --git a/en/device-dev/subsystems/subsys-boot-init-service.md b/en/device-dev/subsystems/subsys-boot-init-service.md index 8a3a9ed0f67129f8acf1bbc8f66f9b84832ece98..e4b553c941198faea09e1b48bdffb1adba1d43de 100644 --- a/en/device-dev/subsystems/subsys-boot-init-service.md +++ b/en/device-dev/subsystems/subsys-boot-init-service.md @@ -115,23 +115,23 @@ By parsing the *.cfg file, you can obtain **service** fields, a ### Parameters **Table 1** Description of service fields - | Name| Supported System Type| Description| Remarks| + | Name| Meaning| Description| Supported System Type| | ---------- |-------- | --------| --------| - | name | Small and standard systems | Name of the current service. (Mandatory)| Type: string. The value cannot be empty and can contain a maximum of 32 bytes.| - | path | Small and standard systems| Full path (including parameters) of the executable file for the current service. This is an array. (Mandatory)| The first element is the path of the executable file, and the maximum number of elements is 20.
Each element is a string that contains a maximum of 64 bytes.| - | uid | Small and standard systems| User ID (UID) of the current service process.| Type: int or string.| - | gid | Small and standard systems| Group ID (GID) of the current service process.| Type: int, int[], string, or string array.| - | once | Small and standard systems| Whether the current service process is a one-off process.| 1: The current service process is a one-off process. If the process exits, the init process does not restart it.
0: The current service process is not a one-off process. If the process exits, the init process restarts it upon receiving the SIGCHLD signal.| - | importance | Small and standard systems|
Standard system: service priority
Small system: service importance|
Standard system: The service priority ranges from -20 to 19. A value beyond the range is invalid.
Small system: The value 0 indicates an unimportant process and a value greater than 0 indicates an important process.| - | caps | Small and standard systems| Capabilities required by the current service. They are evaluated based on the capabilities supported by the security subsystem and configured in accordance with the principle of least permission.| Type: number or string array. If you set the value to a number, use the standard Linux capability. If you set the value to a string array, use the standard macro name.| - | critical | Standard system| Suppression mechanism for services. If the number of times a service is restarted exceeds the value N within the specified period T, the system will be restarted.|
Standard system:
Type: int array, for example, "critical": [M, N, T].
- M: enable flag (0: disable; 1: enable).
- N: number of times the service is started.
- T: period of time, in seconds.
Both M and N are greater than 0.
Small and standard systems:
Type: int, for example, "critical": M.
M: enable flag (0: disable; 1: enable).
By default, N is 4 and T is 20.| - | cpucore | Standard system| Number of CPU cores bound to the service.| Type: int array, for example, "cpucore": [N1, N2, ...]. N1 and N2 indicate the indices of the CPU cores to be bound. For a single-core device, cpucore is 0.| - | d-caps | Standard system| Distributed service capability.| Type: string array, for example, "d-caps": ["OHOS_DMS"].| - | apl | Standard system| Ability privilege level.| Type: string, for example, "apl": "system_core".
The value can be system_core (default), normal, or system_basic.| - | start-mode | Standard system| Service startup mode.| Type: string, for example, **"start-mode": "condition"**.
The value can be boot, normal, or condition. For details, see [init service startup control](#section56901555918).| - | ondemand | Small and standard systems| Whether on-demand startup is enabled.| Type: bool, for example, **"ondemand": true**. For small systems, this feature is available only on the Linux kernel.
For details, see [init Service On-Demand Startup](#section56901555920).| - | disable | Small and standard systems| Reserved.| None.| - | sandbox | Standard system| Whether the sandbox function is enabled.| 1 (default): Enable the sandbox function.
0: Disable the sandbox function.| + | name | Name of the current service. (Mandatory)| Type: string. The value cannot be empty and can contain a maximum of 32 bytes.| Small and standard systems | + | path | Full path (including parameters) of the executable file for the current service. This is an array. (Mandatory)| The first element is the path of the executable file, and the maximum number of elements is 20.
Each element is a string that contains a maximum of 64 bytes.| Small and standard systems| + | uid | User ID (UID) of the current service process.| Type: int or string.| Small and standard systems| + | gid | Group ID (GID) of the current service process.| Type: int, int[], string, or string array.| Small and standard systems| + | once | Whether the current service process is a one-off process.| 1: The current service process is a one-off process. If the process exits, the init process does not restart it.
0: The current service process is not a one-off process. If the process exits, the init process restarts it upon receiving the SIGCHLD signal.| Small and standard systems| + | importance | Standard system: service priority
Small system: service importance|
Standard system: The service priority ranges from -20 to 19. A value beyond the range is invalid.
Small system: The value 0 indicates an unimportant process and a value greater than 0 indicates an important process.| Small and standard systems| + | caps | Capabilities required by the current service. They are evaluated based on the capabilities supported by the security subsystem and configured in accordance with the principle of least permission.| Type: number or string array. If you set the value to a number, use the standard Linux capability. If you set the value to a string array, use the standard macro name.| Small and standard systems| + | critical | Suppression mechanism for services. If the number of times a service is restarted exceeds the value N within the specified period T, the system will be restarted.|
Standard system:
Type: int array, for example, "critical": [M, N, T].
- M: enable flag (0: disable; 1: enable).
- N: number of times the service is started.
- T: period of time, in seconds.
Both M and N are greater than 0.
Small and standard systems:
Type: int, for example, "critical": M.
M: enable flag (0: disable; 1: enable).
By default, N is 4 and T is 20.| Standard system| + | cpucore | Number of CPU cores bound to the service.| Type: int array, for example, "cpucore": [N1, N2, ...]. N1 and N2 indicate the indices of the CPU cores to be bound. For a single-core device, cpucore is 0.| Standard system| + | d-caps | Distributed service capability.| Type: string array, for example, "d-caps": ["OHOS_DMS"].| Standard system| + | apl | Ability privilege level.| Type: string, for example, "apl": "system_core".
The value can be system_core (default), normal, or system_basic.| Standard system| + | start-mode | Service startup mode.| Type: string, for example, **"start-mode": "condition"**.
The value can be boot, normal, or condition. For details, see [init service startup control](#section56901555918).| Standard system| + | ondemand | Whether on-demand startup is enabled.| Type: bool, for example, **"ondemand": true**. For small systems, this feature is available only on the Linux kernel.
For details, see [init Service On-Demand Startup](#section56901555920).| Small and standard systems| + | disable | Reserved.| None.| Small and standard systems| + | sandbox | Whether the sandbox function is enabled.| 1 (default): Enable the sandbox function.
0: Disable the sandbox function.| Standard system| **Table 2** Description of socket fields | Name| Description|