 使用指南)
QNX SLM (System Launch and Monitor) 使用指南
适用版本: QNX 8.0
文档来源: QNX Neutrino RTOS 官方文档
用途: 系统启动顺序管理、多进程生命周期监控、故障恢复
目录
- SLM 概述
- 命令行语法
- XML 配置文件参考
- 启动脚本 (Boot Scripts)
- 运行模式与恢复策略
- 终止场景分类
- 配置示例
- 与 OS Builder 集成
1. SLM 概述
SLM(System Launch and Monitor) 是 QNX Neutrino 的系统启动与监视管理器，负责：
- 按依赖顺序启动多进程应用
- 监控进程运行状态
- 故障时自动恢复指定组件
- 管理系统关机顺序
SLM 从 XML 配置文件构建一个DAG（有向无环图），根据组件间的依赖关系确定启动顺序。SLM 提供启动阶段的系统引导功能，在 startup 和内核初始化完成后接管系统启动流程。
1.1 启动阶段定位
SLM 在系统启动序列中的位置：
QNX 启动顺序: IPL(ROM) → startup → 内核初始化 → procnto → slm → 其他系统组件 │ ├─ io-sock (网络) ├─ io-usb (USB) └─ 其他应用进程1.2 SLM 服务模式
SLM 通常以两种方式工作：
| 模式 | 启动方式 | 使用场景 |
|---|---|---|
| Startup Manager | boot 脚本直接启动 | 系统级启动流程管理 |
| Post-startup Manager | slmctl 触发 | 用户级/应用级进程管理 |
在 boot 脚本中，SLM 作为startup_manager运行，是系统启动阶段的默认进程管理器。
2. 命令行语法
2.1 基本语法
slm [-avV] [-b seconds] [-D debug_mode] [-n subsystem_path] [-p priority] [-P search_path] [-r recovery_mode] [-R frequency/sec|min|hour] [-s comp_name] [-t polling_interval] [-T total_wait] [-x comp_name] config_file2.2 选项说明
| 选项 | 说明 |
|---|---|
-a | 启动所有顶级组件，即使未启用或缺少依赖 |
-b seconds | 启动 seqno 启动前等待的秒数（默认 0） |
-D debug_mode | 调试模式：debug、verbose、verbose_exit |
-n subsystem_path | 用于 slmctl 通信的路径前缀 |
-p priority | SLM 进程优先级 |
-P search_path | 搜索路径，覆盖SLM_SEARCH_PATH环境变量 |
-r recovery_mode | 恢复模式：none、restart（默认restart） |
-R frequency | 每个组件每分钟/小时的恢复最大次数 |
-s comp_name | 仅启动指定组件，跳过依赖关系 |
-t polling_interval | 轮询间隔（秒），用于 waitfor 轮询 |
-T total_wait | 总的等待时间（秒），超时后仍继续 |
-v | 详细输出 |
-V | 更详细的输出 |
-x comp_name | 排除指定组件 |
config_file | XML 配置文件路径 |
2.3 辅助工具
| 工具 | 说明 |
|---|---|
slmctl | SLM 运行时控制工具，用于启动/停止组件、查询状态 |
waitfor | 等待组件/路径/条件满足的同步工具 |
slmctl支持以下操作：
slmctl start <comp>— 启动指定组件slmctl stop <comp>— 停止指定组件slmctl status [comp]— 查询组件状态
3. XML 配置文件参考
3.1 根元素
<SLM:systemxmlns:SLM="http://www.qnx.com/slm">...</SLM:system>3.2 完整元素参考
| 元素 | 父元素 | 说明 |
|---|---|---|
ability | component | 组件能力声明 |
args | component | 命令行参数 |
cd | component | 工作目录 |
command | component | 启动命令路径，支持launch属性 |
component | system,module,depend | 基本组件单元 |
debug | component | 调试选项 |
depend | component | 依赖声明，支持type属性 |
envvar | component | 环境变量设置 |
groups | component | 组件所属组 |
member | module | 模块成员引用 |
module | system | 模块定义（组件组） |
priority | component | 进程优先级 |
repair | component | 修复操作（重启/命令） |
rlimit | component | 资源限制 |
runmask | component | CPU 亲和性掩码 |
stderr | component | 标准错误重定向 |
stdin | component | 标准输入重定向 |
stdout | component | 标准输出重定向 |
stop | component | 停止命令/信号 |
tty | component | 终端设备 |
type | component | 进程类型 |
user | component | 运行用户 |
waitfor | component | 启动条件等待，支持wait属性 |
module(boot) | SLM:system(boot) | 引导模块 |
3.3 元素详解
component
基本执行单元定义：
<SLM:component default="enable|disable"<!-- 默认启用/禁用 -->launch="critical|builtin|session|pathname"<!-- 启动类型 -->host="true|false"<!-- 是否为宿主组件 -->></SLM:component>属性说明：
| 属性 | 值 | 说明 |
|---|---|---|
name | 字符串 | 组件唯一名称 |
default | enable/disable | 默认是否启用 |
launch | critical | 关键组件 |
builtin | 内建命令（见 7.4 节） | |
session | 会话启动 | |
pathname | 路径名启动 | |
host | true/false | 宿主组件 |
command
定义要执行的命令：
<SLM:commandlaunch="critical|builtin|pathname|session">/path/to/command</SLM:command>
