SuperAPI AI 工具集

subsystem-summary-of-process

编程与开发

查看项目

更新于 10-16 06:14

技能介绍

用途:进程子系统为 stellar-core 提供异步子进程管理,把 POSIX 的 posix_spawnp 与 Windows 的 CreateProcess 封装在统一的 asio 接口之后,用于以异步方式运行外部命令(如 gzip、gunzip、curl 等历史归档工具),并支持并发上限、输出文件捕获、优雅关闭与进程生命周期跟踪。它不提供读写子进程 I/O 端口的能力,只负责“运行命令并等待是否成功”。

主要能力:ProcessManager 为抽象接口,每个 Application 实例通过静态工厂 ProcessManager::create(Application&) 创建一个管理器。runProcess(cmdLine, outputFile) 负责排队或立即启动子进程,若 outputFile 非空则把 stdout 捕获到临时文件并在成功时原子重命名。getNumRunningProcesses() 与 getNumRunningOrShuttingDownProcesses() 返回进程计数,tryProcessShutdown(pe) 同步取消事件并尝试终止进程,shutdown() 标记关闭、取消待处理进程并对运行中进程执行优雅关闭,isShutdown() 返回关闭状态。ProcessExitEvent 是 asio 兼容的完成通知对象,通过 async_wait(handler) 注册回调,回调中的零 error_code 表示成功。

使用方式:客户端调用 runProcess() 并拿到 weak_ptr<ProcessExitEvent>,再通过 async_wait() 注册完成处理。并发数由 Config::MAX_CONCURRENT_SUBPROCESSES 决定,达到上限时新进程进入 FIFO 待启动队列 mPending,进程退出后再由 maybeRunPendingProcesses() 补位。POSIX 下通过 SIGCHLD 信号加 waitpid(WNOHANG) 检测退出;Windows 下通过进程句柄 async_wait 检测。安静关闭先发 SIGTERM/CTRL_C_EVENT,再升级为 SIGKILL/TerminateProcess。

限制:仅运行命令与捕获 stdout,不提供 stdin/stderr 交互通道;若目标输出文件已存在,原子重命名会失败并报错;Linux 下退出码 127 会发出命令可能缺失的警告;异步等待依赖定时器配合共享错误码来绕开 asio 的 operation_aborted 语义。资料未提供安装命令、价格与性能数据。