SerenityOS 如何在 QEMU 目标环境中运行 target 测试run-tests-and-shutdown.sh 与 self-test 模式【免费下载链接】serenityThe Serenity Operating System 项目地址: https://gitcode.com/GitHub_Trending/se/serenitySerenityOS 的测试分为两类host tests 在构建机上运行target tests 则运行在 SerenityOS 系统内部QEMU 模拟或裸机。如果你在开发 SerenityOS 用户空间或内核代码需要在改动后跑一遍系统内的测试来验证行为目标就是把构建产物装进 QEMU然后在目标系统里执行 target 测试。Documentation/RunningTests.md 给出了两条完整路径——在 QEMU 控制台里手动运行run-tests-and-shutdown.sh以及 CI 使用的 self-test 模式开机自动跑测试。本文只覆盖 x86_64 构建 QEMU 模拟这一场景。target 测试的产物位置target 测试在完整构建时一并编译安装后位于/usr/Tests少数系统测试出于历史原因安装在/bin。也就是说只要你执行了完整构建和ninja install测试程序就已经进入镜像剩下的问题只是在系统里怎么把它们跑起来。测试执行入口是安装到/home/anon/Tests的run-tests-and-shutdown.sh仓库中的源文件见 run-tests-and-shutdown.sh。准备构建镜像并启动 QEMU在仓库根目录执行以下命令来自 RunningTests.md 的 Running Target Tests 一节cmake -GNinja -S Meta/CMake/Superbuild -B Build/superbuild-x86_64 cmake --build Build/superbuild-x86_64 cd Build/x86_64 ninja install ninja qemu-image ninja run各步作用前两条命令初始化并执行完整构建ninja install将测试等产物安装进系统镜像ninja qemu-image生成 QEMU 磁盘镜像ninja run启动 QEMU 并等待系统引导完成。ninja run会启动一个 QEMU 虚拟机进程并占用当前终端属于正常开发调试用途不影响宿主机系统。方式一在 QEMU 控制台手动运行测试脚本系统引导完成后在初始终端中直接执行测试脚本cd ~ ./Tests/run-tests-and-shutdown.shRunningTests.md 给出的文档示例输出为courage ~ $ ./Tests/run-tests-and-shutdown.sh Running Tests on SerenityOS ...以上为文档示例实际输出以你的运行环境为准。结合仓库内 run-tests-and-shutdown.sh 的源码可以确认以下行为脚本会把失败数量写入./test-results.log内容为Failed: 数量并以失败数量作为退出码——这是判断结果的最直接依据只有当环境变量$DO_SHUTDOWN_AFTER_TESTS被设置时脚本才会在全部测试跑完后执行sync和shutdown -n关机。手动运行时不设置该变量系统会保留现场方便你继续排查失败项在aarch64或riscv64架构上除非向脚本显式传入--force测试会被跳过此时失败数记为 0。x86_64 目标不受此分支影响。方式二self-test 模式CI 的自动运行方式CI 不使用手动输入而是让 SystemServer 在开机时自动执行测试条件是系统以 self-test 模式引导。RunningTests.md 展示了/etc/SystemServer.ini中的 TestRunner 条目[TestRunnerttyS0] Executable/home/anon/Tests/run-tests-and-shutdown.sh StdIO/dev/ttyS0 EnvironmentDO_SHUTDOWN_AFTER_TESTS1 TERMxterm PATH/usr/local/bin:/usr/bin:/bin Useranon WorkingDirectory/home/anon SystemModesself-test几个要点SystemModesself-test表示该服务只在 self-test 模式下激活SystemServer 从内核接口/sys/kernel/system_mode读取当前模式来决定激活哪些服务见 SystemServer/main.cpp 中determine_system_mode()的实现条目里EnvironmentDO_SHUTDOWN_AFTER_TESTS1意味着走这条路径时测试跑完会自动shutdown -n虚拟机随之关闭——这是有意的闭环设计StdIO 使用/dev/ttyS0因为当 QEMU 以-display none和-serial stdio运行时该串口接到 QEMU 窗口的 stdoutCI 的 run 脚本另将串口调试输出重定向到./debug.log使测试的 stdout 与内核/测试中的 dbgln 输出都能被捕获。要在本地复现 CI 的 self-test 启动使用cirun options按文档执行export SERENITY_RUNci export SERENITY_KERNEL_CMDLINEgraphics_subsystem_modeoff system_modeself-test ninja run文档同时说明CI 会额外设置panicshutdown以便测试结束后 QEMU 直接退出默认值halt会让 QEMU 进程保留便于在系统停机后检查现场。上面的示例命令没有包含panicshutdown因此跑完后 QEMU 窗口会保留符合先验证结果再清理的顺序。结果判断与限制两条路径的结果判断方式一致看test-results.log中的Failed: 数量与脚本退出码为 0 说明没有失败项self-test 模式下若复现 CI 的日志捕获可在debug.log中同时查看测试 stdout 与 dbgln 调试输出。需要注意的边界self-test 条目固定了DO_SHUTDOWN_AFTER_TESTS1测试结束后目标系统会自行关机想保留现场排查时改用方式一手动运行脚本即可aarch64/riscv64上脚本默认不跑测试需传--force本文的主路径为 x86_64 QEMU不涉及这两个架构所有命令均在宿主机上对构建目录和 QEMU 虚拟机操作不修改仓库内容QEMU 进程可随时终止ninja run之外没有涉及宿主机的进程清理或文件删除。完成一次 target 测试运行后如需继续核对构建方式可参考 RunningTests.md 中 host tests 与 sanitizer 的说明它们与本文的 QEMU target 路径相互独立。【免费下载链接】serenityThe Serenity Operating System 项目地址: https://gitcode.com/GitHub_Trending/se/serenity创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
SerenityOS 如何在 QEMU 目标环境中运行 target 测试run-tests-and-shutdown.sh 与 self-test 模式【免费下载链接】serenityThe Serenity Operating System 项目地址: https://gitcode.com/GitHub_Trending/se/serenitySerenityOS 的测试分为两类host tests 在构建机上运行target tests 则运行在 SerenityOS 系统内部QEMU 模拟或裸机。如果你在开发 SerenityOS 用户空间或内核代码需要在改动后跑一遍系统内的测试来验证行为目标就是把构建产物装进 QEMU然后在目标系统里执行 target 测试。Documentation/RunningTests.md 给出了两条完整路径——在 QEMU 控制台里手动运行run-tests-and-shutdown.sh以及 CI 使用的 self-test 模式开机自动跑测试。本文只覆盖 x86_64 构建 QEMU 模拟这一场景。target 测试的产物位置target 测试在完整构建时一并编译安装后位于/usr/Tests少数系统测试出于历史原因安装在/bin。也就是说只要你执行了完整构建和ninja install测试程序就已经进入镜像剩下的问题只是在系统里怎么把它们跑起来。测试执行入口是安装到/home/anon/Tests的run-tests-and-shutdown.sh仓库中的源文件见 run-tests-and-shutdown.sh。准备构建镜像并启动 QEMU在仓库根目录执行以下命令来自 RunningTests.md 的 Running Target Tests 一节cmake -GNinja -S Meta/CMake/Superbuild -B Build/superbuild-x86_64 cmake --build Build/superbuild-x86_64 cd Build/x86_64 ninja install ninja qemu-image ninja run各步作用前两条命令初始化并执行完整构建ninja install将测试等产物安装进系统镜像ninja qemu-image生成 QEMU 磁盘镜像ninja run启动 QEMU 并等待系统引导完成。ninja run会启动一个 QEMU 虚拟机进程并占用当前终端属于正常开发调试用途不影响宿主机系统。方式一在 QEMU 控制台手动运行测试脚本系统引导完成后在初始终端中直接执行测试脚本cd ~ ./Tests/run-tests-and-shutdown.shRunningTests.md 给出的文档示例输出为courage ~ $ ./Tests/run-tests-and-shutdown.sh Running Tests on SerenityOS ...以上为文档示例实际输出以你的运行环境为准。结合仓库内 run-tests-and-shutdown.sh 的源码可以确认以下行为脚本会把失败数量写入./test-results.log内容为Failed: 数量并以失败数量作为退出码——这是判断结果的最直接依据只有当环境变量$DO_SHUTDOWN_AFTER_TESTS被设置时脚本才会在全部测试跑完后执行sync和shutdown -n关机。手动运行时不设置该变量系统会保留现场方便你继续排查失败项在aarch64或riscv64架构上除非向脚本显式传入--force测试会被跳过此时失败数记为 0。x86_64 目标不受此分支影响。方式二self-test 模式CI 的自动运行方式CI 不使用手动输入而是让 SystemServer 在开机时自动执行测试条件是系统以 self-test 模式引导。RunningTests.md 展示了/etc/SystemServer.ini中的 TestRunner 条目[TestRunnerttyS0] Executable/home/anon/Tests/run-tests-and-shutdown.sh StdIO/dev/ttyS0 EnvironmentDO_SHUTDOWN_AFTER_TESTS1 TERMxterm PATH/usr/local/bin:/usr/bin:/bin Useranon WorkingDirectory/home/anon SystemModesself-test几个要点SystemModesself-test表示该服务只在 self-test 模式下激活SystemServer 从内核接口/sys/kernel/system_mode读取当前模式来决定激活哪些服务见 SystemServer/main.cpp 中determine_system_mode()的实现条目里EnvironmentDO_SHUTDOWN_AFTER_TESTS1意味着走这条路径时测试跑完会自动shutdown -n虚拟机随之关闭——这是有意的闭环设计StdIO 使用/dev/ttyS0因为当 QEMU 以-display none和-serial stdio运行时该串口接到 QEMU 窗口的 stdoutCI 的 run 脚本另将串口调试输出重定向到./debug.log使测试的 stdout 与内核/测试中的 dbgln 输出都能被捕获。要在本地复现 CI 的 self-test 启动使用cirun options按文档执行export SERENITY_RUNci export SERENITY_KERNEL_CMDLINEgraphics_subsystem_modeoff system_modeself-test ninja run文档同时说明CI 会额外设置panicshutdown以便测试结束后 QEMU 直接退出默认值halt会让 QEMU 进程保留便于在系统停机后检查现场。上面的示例命令没有包含panicshutdown因此跑完后 QEMU 窗口会保留符合先验证结果再清理的顺序。结果判断与限制两条路径的结果判断方式一致看test-results.log中的Failed: 数量与脚本退出码为 0 说明没有失败项self-test 模式下若复现 CI 的日志捕获可在debug.log中同时查看测试 stdout 与 dbgln 调试输出。需要注意的边界self-test 条目固定了DO_SHUTDOWN_AFTER_TESTS1测试结束后目标系统会自行关机想保留现场排查时改用方式一手动运行脚本即可aarch64/riscv64上脚本默认不跑测试需传--force本文的主路径为 x86_64 QEMU不涉及这两个架构所有命令均在宿主机上对构建目录和 QEMU 虚拟机操作不修改仓库内容QEMU 进程可随时终止ninja run之外没有涉及宿主机的进程清理或文件删除。完成一次 target 测试运行后如需继续核对构建方式可参考 RunningTests.md 中 host tests 与 sanitizer 的说明它们与本文的 QEMU target 路径相互独立。【免费下载链接】serenityThe Serenity Operating System 项目地址: https://gitcode.com/GitHub_Trending/se/serenity创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
