#chensuiyi/subproc

#Install

moon add chensuiyi/subproc

#Features

• pidfd (Linux ≥ 5.3): a kernel handle pinned to one process — pid reuse never fools liveness/exit checks, adopted (non-child) processes supported
• wait_child_timeout: hard deadline; on expiry SIGKILLs the group and reaps with a bounded retry — a stuck helper can never freeze the caller
• instance_env_blob: whitelisted env plus reserved vars as a NUL blob
• procfs sampling: VmRSS and utime+stime per process
• Platform probes: uname, SO_REUSEPORT bind test, /proc/self/exe, uid
• Own process group per child (setsid), stdout/stderr redirection to log files

#Scenarios

• Process supervisors: spawn, reap, crash budgets, memory sampling
• Build tools and dev CLIs: run tests / compilers with hard timeouts
• Adopted-process tracking: exit detection that survives pid reuse

#API

// Spawn with log redirection and own process group
let pid = @subproc.spawn({
  bun_path: "bun",
  script: "app.js",
  cwd: "/srv/app",
  out_log: "/var/log/app.out.log",
  err_log: "/var/log/app.err.log",
  env_blob: @subproc.instance_env_blob("app", 0, 3000),
})

// Graceful stop with hard deadline
@subproc.kill_group(pid, @subproc.SIGTERM)
let reaped = @subproc.wait_child_timeout(pid, 5000)

// Sample
let rss = @subproc.read_rss_kb(pid)

#Author

#License

#chensuiyi/subproc

#安装

moon add chensuiyi/subproc

#功能

• pidfd(Linux ≥ 5.3):内核句柄钉住原始进程,pid 复用不干扰存活/退出判定,支持收养非子进程
• wait_child_timeout:硬超时,到期 SIGKILL 整组并有界回收——卡死的辅助进程永远不会冻结调用方
• instance_env_blob:白名单环境 + 保留变量的 NUL blob
• procfs 采样:每进程 VmRSS 与 utime+stime
• 平台探针:uname、SO_REUSEPORT 绑定测试、/proc/self/exe、uid
• 每个子进程独立进程组(setsid),stdout/stderr 重定向到日志文件

#场景

• 进程监督器:拉起、回收、崩溃预算、内存采样
• 构建工具与开发 CLI:带硬超时地运行测试 / 编译器
• 收养进程跟踪:pid 复用下仍可靠的退出判定

#API

#用法示例

// 带日志重定向与独立进程组启动
let pid = @subproc.spawn({
  bun_path: "bun",
  script: "app.js",
  cwd: "/srv/app",
  out_log: "/var/log/app.out.log",
  err_log: "/var/log/app.err.log",
  env_blob: @subproc.instance_env_blob("app", 0, 3000),
})

// 优雅停止(硬截止)
@subproc.kill_group(pid, @subproc.SIGTERM)
let reaped = @subproc.wait_child_timeout(pid, 5000)

// 采样
let rss = @subproc.read_rss_kb(pid)

#作者

#协议