Unit 配置¶

Unit描述¶

Description¶

类型：字符串

允许配置为一个字符串，说明该unit的主要功能。

Documentation¶

类型：字符串

允许配置为一个字符串，说明该unit的文档链接。

条件动作¶

sysmaster兼容systemd的SuccessAction、FailureAction、StartLimitAction等配置。这些配置允许某个unit的状态发生变更时修改操作系统的状态，例如重启、关机或退出。

SuccessAction/FailureAction¶

类型：字符串

配置当unit结束（SuccessAction）或进入失败状态（FailureAction）时采取的动作。可以配置的值包括： "none"，"reboot"，"reboot-force"，"reboot-immediate"，"poweroff"，"poweroff-force"，"poweroff-immediate"，"exit"和"exit-force"。

当配置为none时，不触发任何动作，所有unit的默认值为"none"。"reboot"，"poweroff"，"exit"会分别触发reboot.target，poweroff.target，exit.target，与正常的系统重启、关机、退出流程一致。"reboot-force"，"poweroff-force"，"exit-force"会分别触发sysmaster以相应的状态退出，强行杀死服务及相关进程。"reboot-immediate"，"poweroff-immediate"会分别触发系统立即重启、关机，直接调用reboot(2)。

StartLimitAction¶

类型：字符串

配置当unit触发启动限制时采取的动作。配置的值与采取的动作与SuccessAction、FailureAction一致。

触发启动限制指：sysmaster最多允许单个unit在StartLimitInterval时间内启动StartLimitBurst次。

StartLimitInterval¶

类型：数值

限制启动的时间区间, 单位为秒，默认值为10秒。

StartLimitBurst¶

类型：数值

单位时间内最多的启动次数，默认值为5。只要StartLimitInterval与StartLimitBurst其中一项配置为0时不启动限速。

JobTimeoutAction，JobTimeoutSec¶

类型：字符串

JobTimeoutAction配置unit的job运行超时时采取的动作，配置的值与采取的动作与SuccessAction、FailureAction一致。

JobTimeoutSec配置unit的job运行超时时间，单位是秒。systemd禁用JobTimeoutSec的配置为"infinity"，sysmaster与之不同，禁用JobTimeoutSec需要配置为"0"。

顺序和依赖¶

sysmaster支持配置单元之间的顺序及依赖关系，可以配置的值为;分隔的单元。如After="foo.service;bar.target"。需要注意：

单元之间不允许有多余的空格
仅支持通过;分隔，与systemd的空格分隔存在差异
不支持systemd同一配置项配置多次的场景，如: After="foo.service" After="bar.service"

After/Before¶

类型：字符串

After和Before能够配置同时启动的单元的先后顺序。如foo.service配置了After="bar.service" Wants="bar.service"，foo.service将在bar.service启动完成后启动。需要注意：

After和Before仅确定启动的先后顺序，不自动添加依赖。在上面的例子中如果没有配置Wants="bar.service"，foo.service也能正常启动，且不会自动拉起bar.service。
后序单元不关注前序单元的启动结果，这意味着在上面的例子中，即使bar.service启动失败，foo.service依旧能正常拉起。

After和Before的依赖相反。在关机阶段，依赖反转。

Wants/Requires/Requisite/PartOf/BindsTo/Conflicts¶

这些配置项均用于配置单元之间的依赖，以foo.service配置Wants/Requisite...="bar.service"为例详细说明。

Wants：配置一个单元对另一个单元的依赖。在启动foo.service时，将自动拉起bar.service。但是bar.service的启动结果不影响foo.service。

Requires：与Wants类似，区别在于如果bar.service启动失败，foo.service也同时进入失败状态。重启或关闭bar.service会传递到foo.service，使foo.service跟随重启或关闭。

Requisite：与Requires类似，区别在于启动foo.service时，如果bar.service还未启动成功，那么foo.service会直接失败。注意：Requisite必须与After配合使用，否则启动bar.service不检查foo.service，这与systemd行为一致。

PartOf：与Requires类似，区别在于依赖仅影响单元的重启或关闭。

BindsTo：与Requires类似，但依赖更强，当bar.service的状态突然发生变化时，foo.service会跟随立即变化。

Conflicts：foo.service与bar.service的状态相反。启动foo.service将关闭bar.service，启动bar.service会关闭foo.service。

Wants和Requires除了支持通过.service/.target/.socket等单元配置文件配置，也允许在/etc/sysmaster/或/usr/lib/sysmaster目录下创建单元名.wants/单元名.requires目录，并在里面添加指向依赖单元的软链接。例如为了给foo.service配置Wants="bar.service"，可以创建/etc/sysmaster/foo.service.wants目录，并在该目录内创建bar.service -> /etc/sysmaster/bar.service的软链接。

OnFailure/OnSuccess¶

类型：字符串

OnFailure：配置当一个unit启动失败或成功结束后，对其他服务的影响。以foo.service配置OnFailure/OnSuccess="bar.service"为例，当foo.service启动失败或成功结束后，将自动拉起bar.service。拉起bar.service会生成一个Start类型的job,该job的模式可配置为fail， replace，replace-irreversibly，isolate，flush，ignore-dependencies或ignore-requirements。

DefaultDependencies¶

类型：布尔值

DefaultDependencies配置是否为单元添加缺省依赖，默认值为true。缺省依赖如下：

所有类型的单元统一添加Conflict="shutdown.target"，Before="shutdown.target"。
针对不同类型的单元，额外添加以下依赖

对.service，添加Requires="sysinit.target"，After="sysinit.target"，After="basic.target"。

对.socket，添加Requires="sysinit.target"，After="sysinit.target"，After="socket.target"。

对.target，对target配置的Requires=、Wants=补全After=。

启动检查¶

sysmaster支持配置Condition...和Assert...进行启动检查，当条件不满足时，停止启动流程。所有配置均支持通过在值前面添加!反转检查结果。

ConditionACPower¶

类型：可选的布尔值

检查操作系统是否连接交流电源。可以配置为false，true。配置为true时，当操作系统至少一个接口连接了交流电，或者无法确定是否有连接时，检查通过。配置为false时，当成功检查到所有接口都没有连接交流电时，检查通过。如果不配置，跳过该检查。配置为其他的值，会导致解析失败。

ConditionCapability¶

类型：字符串

检测sysmaster是否支持给定的权能，允许配置引号括起来的权能名称，如"CAP_CHOWN"。该配置仅允许配置一个权能。通过读取/proc/self/status/的CapBnd检查sysmaster的权能组（Capability Set），如果包含指定的权能，那么检查通过；否则，检查失败。

ConditionDirectoryNotEmpty¶

类型：字符串

检查配置的绝对路径目录是否非空，如果为软链接，则判断软链接指向的目录。如果目录非空，检查通过；否则，检查失败。

ConditionFileIsExecutable¶

类型：字符串

检查配置的绝对路径文件是否可执行，如果为软链接，则判断软链接指向的文件。如果可执行，检查通过；否则，检查失败。

ConditionFirstBoot¶

类型：可选的布尔值

检测系统是否首次启动，可配置为false、true。用于系统出厂后(或者恢复出厂设置之后)，首次开机时执行必要的初始化操作。该选项将会检测/run/sysmaster/first-boot文件是否存在。若文件存在，则表明系统首次启动，反之，则表明系统非首次启动。如果在内核命令行上指定了sysmaster.condition-first-boot=选项（采用布尔值），它将优先于/run/sysmaster/first-boot文件是否存在的检查结果。

ConditionKernelCommandLine¶

类型：字符串

检查内核命令行是否配置给定的内容。该选项仅允许配置一个单词或者=分隔的键值对，例如："ro"，"crashkernel=512M"。配置为单词时，检查内核命令行是否包含该单词或作为键值对的键。配置为键值对时，将检查是否存在完全一致的键值对。内核命令行仅支持读取/proc/cmdline。

ConditionPathExists¶

类型：字符串

检查文件是否存在。只有ConditionPathExists=后配置的绝对路径存在时，检查通过，启动流程正常；如果配置的绝对路径不存在，则检查失败，停止单元的启动流程。

ConditionPathExistsGlob¶

类型：字符串

与ConditionPathExists类似，区别在于ConditionPathExistsGlob支持通配符。

ConditionPathIsDirectory¶

类型：字符串

检查ConditionPathIsDirectory=后配置的绝对路径是否为目录，如果是，检查通过；否则检查失败。

ConditionPathIsMountPoint¶

类型：字符串

检查ConditionPathIsMountPoint=后配置的绝对路径是否为挂载点目录，如果是软链接，则检查软链接指向的目录。该配置仅支持kernel > 4.11版本。如果是挂载点目录，检查通过；否则，检查失败。

ConditionPathIsReadWrite¶

类型：字符串

与ConditionPathExists类似，检查配置的绝对路径所属的文件系统是否为可读可写。

ConditionPathIsSymbolicLink¶

类型：字符串

检查ConditionPathIsSymbolicLink=后配置的绝对路径是否为软链接，如果是软链接，检查通过；否则检查失败。

ConditionSecurity¶

类型：字符串

ConditionSecurity可以用于检查系统是否支持给定的安全技术。当前支持的值包括："selinux"，"apparmor"，"tomoyo"，"ima"，"smack"，"audit"，"uefi-secureboot"和"tpm2"。 注意： 检查"selinux"需要在编译时通过 --features "selinux" 开启 "selinux" feature。

ConditionUser¶

类型：字符串

检测sysmaster是否以给定的用户身份运行。参数可以是数字形式的"UID"、字符串形式的UNIX用户名或者特殊值"@system"(表示属于系统用户范围内)。如果不配置，默认跳过该检查。

其他配置¶

RefuseManualStart/RefuseManualStop¶

类型：布尔值

RefuseManualStart/RefuseManualStop：配置单元是否拒绝通过sctl start/stop的形式手动启动/关闭。默认配置为false，即允许手动启动/关闭。该配置不影响通过依赖关系解析启动/关闭服务。

Last update: April 11, 2023
Created: February 8, 2023