Cosim Launcher 介绍

本页介绍 Cosim Launcher 的定位、组成和本章的阅读顺序。

Cosim Launcher 是仓库中的 Rust 程序 cosim，它读取 YAML 拓扑，把拓扑解析成本机执行计划，启动并监督 host QEMU 与设备进程，最后写出 verdict。拓扑解析、会话执行和命令行由 cosim-topology、cosim-runtime和 cosim-cli三个 crate 分别承担。

启动器负责什么

• 解析：读取 YAML 文档，完成导入、模板展开、校验和内存布局（见 YAML 加载与计划）。

• 计划：结合本机页大小、PATH和会话目录，生成进程、参数、就绪探测和资源路径。

• 执行：按依赖顺序启动进程，做就绪探测，以租约协调关闭，并处理信号升级。

• 收尾：写出 verdict 并清理会话资源；启动器异常退出后可以用 cosim clean回收残留资源。

本章内容

• 命令与选项
• YAML 加载与计划
• 会话生命周期
• Rust 工作区
• 会话排错
• 遗留 shell launcher

推荐阅读路径

• 第一次使用：先读 命令与选项，再按 YAML 加载与计划理解输入文档如何变成计划。

• 排查启动或关闭失败：会话生命周期与 会话排错。

• 修改启动器代码：Rust 工作区给出 crate 划分和适配器扩展点。

• 仍在用旧脚本：遗留 shell launcher说明遗留路径及其边界。

相关章节

• 会话执行流程：会话执行流程的系统视图。

• 组件与职责：各组件在整体架构中的位置。

• 设备适配器：设备适配器的字段与就绪约束。

• 首次会话：从零跑通第一个会话。