init启动引导组件

• init启动引导的配置文件
• 开发指导
• 开发实例

init启动引导组件负责在系统启动阶段启动关键服务进程，若用户需要新增随开机自启动的系统服务，可将新增服务加入配置文件init.cfg中。

init启动引导的配置文件

init启动引导组件配置文件包含了所有需要由init进程启动的系统关键服务的服务名、可执行文件路径、权限和其他信息，该文件位于代码仓库“vendor/huawei/camera/init_configs/“目录，烧写单板后可在“/etc/“目录下找到，文件名称为init.cfg，采用json格式，文件大小目前限制在100KB以内。

init进程启动后读取/etc/init.cfg，然后解析其json格式内容，并根据解析结果依次加载系统服务。

开发指导

1. 配置jobs数组。

   init启动引导组件将系统启动分为三个阶段：

   • “pre-init”阶段：启动系统服务之前需要先执行的操作，例如挂载文件系统、创建文件夹、修改权限等。
   • “init”阶段：系统服务启动阶段。
   • “post-init”阶段：系统服务启动完后还需要执行的操作。

   上述每个阶段用一个job表示，一个job对应一个命令集合，init通过依次执行每个job中的命令来完成系统初始化。job执行顺序：先执行“pre-init”，再执行“init”，最后执行“post-init”。

       "jobs" : [{
               "name" : "pre-init",      
               "cmds" : [                               
                   "mkdir /testdir",      
                   "chmod 0700 /testdir", 
                   "chown 99 99 /testdir",
                   "mkdir /testdir2",
                   "mount vfat /dev/mmcblk0p0 /testdir2 noexec nosuid" // mount命令，格式为：mount 文件系统类型 source target flags data
                ]
           }, {
               "name" : "init",          
               "cmds" : [
                   "start service1",     
                   "start service2"      
                ]
           }, {
                "name" : "post-init",  
                "cmds" : []
           }
       ],
   

   表 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进程需要启动的所有系统服务（最多支持100个）。

       "services" : [{                         
               "name" : "service1",            
               "path" : ["/bin/process1", "param1", "param2"],  
               "uid" : 1,                      
               "gid" : 1,                      
               "once" : 0,                     
               "importance" : 1,                                                                    
               "caps" : [0, 1, 2, 5]           
       }, {
               "name" : "service2",            
               "path" : "/bin/process2",
               "uid" : 2,
               "gid" : 2,
               "once" : 1,
               "importance" : 0,
               "caps" : [ ]
           }
       ]
   

   表 3 service字段说明

   字段名	说明
   name	当前服务的服务名，须确保非空且长度<=32字节。
   path	当前服务的可执行文件全路径和参数，数组形式。须确保第一个数组元素为可执行文件路径、数组元素个数<=20、每个元素为字符串形式以及每个字符串长度<=64字节。
   uid	当前服务进程的uid值。
   gid	当前服务进程的gid值。
   once	当前服务进程是否为一次性进程： 1：一次性进程，当该进程退出时，init不会重新启动该服务进程 0 : 常驻进程，当该进程退出时，init收到SIGCHLD信号并重新启动该服务进程； 注意，对于常驻进程，若在4分钟之内连续退出5次，第5次退出时init将不会再重新拉起该服务进程。
   importance	当前服务进程是否为关键系统进程： 0：非关键系统进程，当该进程退出时，init不会将系统复位重启； 1：关键系统进程，当该进程退出时，init将系统复位重启。
   caps	当前服务所需的capability值，根据安全子系统已支持的capability，评估所需的capability，遵循最小权限原则配置（当前最多可配置100个值）。

开发实例

init启动引导程序，此处以要新增一个名为MySystemApp的系统服务为例进行说明，使用如下配置：

{
    "jobs" : [{
    "name" : "pre-init",
    "cmds" : [
        "mkdir /storage/MyDir",      // MySystemApp服务启动之前需要先创建文件夹，因此放在 “pre-init”中进行
       "chmod 0600 /storage/MyDir",          // MySystemApp服务要求该文件加只有本用户和属组才可读写，因此需要修改权限
       "chown 10 10 /storage/MyDir"
      ]
}, {
       "name" : "init",
       "cmds" : [
           "start MySystemApp"         // 在“init”中启动该系统服务
        ]
}, {
     "name" : "post-init",
     "cmds" : []                     // MySystemApp系统服务启动后无需进行其他操作，因此不用配置“post-init”
   }
],
    "services" : [{
        "name" : "MySystemApp",       //  系统服务名称
        "path" : ["/bin/MySystemAppExe", "param1", "param2", "param3"],    // MySystemApp系统服务的可执行文件路径为"/bin/MySystemAppExe"，其启动需要传入三个参数，分别是"param1"、"param2"和"param3
        "uid" : 20,         //  MySystemApp系统服务的uid是20
        "gid" : 20,         //  MySystemApp系统服务的gid是20
        "once" : 0,         //  MySystemApp系统服务的非一次性进程，即如果MySystemApp系统服务因任何原因退出，init进程需要将其重新拉起
        "importance" : 0,    //  MySystemApp系统服务不是关键系统进程，即如果MySystemApp系统服务因任何原因退出，init进程无需重启单板
        "caps" : []           //  MySystemApp系统服务不需要任何capability权限（即MySystemApp系统服务不涉及与capability相关的操作）
     }
     ]
}

完成配置后，编译出包烧写单板：

1. 启动后使用task -a（liteos-a版本）或ps命令（linux版本）查看是否MySystemApp系统服务进程已启动。
2. 使用kill命令将上述新增的MySystemApp进程杀死，观察该进程是否会被重新拉起（此处应该为重新拉起）。
3. 使用kill命令将上述新增的MySystemApp进程杀死，观察是否会导致单板重启（此处应该为不重启）。