Skip to content

feat(process): 进程监管 —— 有界输出、超时、进程组终止(#69 POSIX 批) - #82

Merged
Antruly merged 1 commit into
masterfrom
feat/process-supervisor
Nov 22, 2026
Merged

Antruly merged 1 commit into
masterfrom
feat/process-supervisor

Conversation

@Antruly

@Antruly Antruly commented Nov 22, 2026

Copy link
Copy Markdown
Owner

Part of #69(POSIX 批;Windows Job Object 留后续)。

内容

新增 uvcpp_process_supervisor:

  • spawn(spec, on_output, on_exit):file / args / env / cwd,返回取消用的 id;
  • 有界输出:stdout/stderr 管道同时喂回调和尾缓冲(max_output_bytes,默认 64 KiB/流);超限丢最旧字节并累计 stdout_truncated / stderr_truncated;
  • 超时 / 取消:SIGTERM → stop_grace_ms(默认 2s)→ 强杀;退出回调恰好一次,结果带 exit_status / term_signal / elapsed_ms / error / timed_out / cancelled / 两条尾缓冲;
  • POSIX 进程组终止:kill_tree=true(默认)用 UV_PROCESS_DETACHED 让子进程自成会话/进程组,信号发 -pid;父进程退出后不留子进程;
  • Windows:kill_tree=true 返回 UV_ENOTSUP(Job Object 是 feat(process): add process supervisor with bounded output and process-tree termination #69 的后续);基本 spawn/超时/取消仍可用;
  • stats():spawned / succeeded / failed / timed_out / cancelled / running。

生命周期上实测踩掉的两个坑(代码里有注释):

  1. 捕获子进程输出要用 UV_CREATE_PIPE | UV_WRITABLE_PIPE(标志描述子进程那端的方向),用错方向 uv_read_start 直接 ENOTCONN、一个字节都收不到;
  2. 进程句柄必须从 spawn 成功起计入 pending 句柄数,否则管道先 EOF 会把 job 删掉、进程退出回调随后踩已释放内存。

用例

process_supervisor_func(POSIX;Windows 直接 skip):

  • sh -c 'printf OUT; printf ERR >&2; exit 3':退出码 3、两条尾缓冲、回调、failed 统计;
  • 超时 200ms + 200ms 宽限:结果 timed_out,200ms 收尾,shell 里 sleep 30 & 的子进程随进程组一起被杀(kill(pid,0) 得到 ESRCH);
  • cancel():cancelled 标记、回调恰好一次、stats.cancelled;
  • 200 KB 输出 + 1024 上限:回调收满流量,尾缓冲 ≤1024,截断数正确;零退出计入 succeeded。

验证

build-all 169/169、build-h3 / build-default 编过;check_docs / check_doc_lines / check_doc_versions / check_ci_layout 全绿。文档 doc/lowlevel-guide.md §12。

新增 `uvcpp_process_supervisor`(`src/handle/uvcpp_process_supervisor.*`):

- spawn 任意程序:file / args / env / cwd;
- **有界输出**:stdout/stderr 管道,输出回调 + 尾缓冲(`max_output_bytes`,
  默认 64 KiB/流,超限丢最旧字节并计入 `*_truncated`);
- **超时 / 取消**:SIGTERM → `stop_grace_ms` → 强杀;退出回调恰好一次,
  结果带 exit/signal/elapsed/error/timed_out/cancelled;
- **POSIX 进程组终止**:`kill_tree=true` 用 `UV_PROCESS_DETACHED` 让子进程自成
  进程组,对 `-pid` 发信号(CI 实测:shell 里 `sleep 30 &` 的子进程也一起消失);
- Windows 上 `kill_tree=true` 返回 `UV_ENOTSUP`(Job Object 留后续);
- `stats()`:spawned/succeeded/failed/timed_out/cancelled/running。

生命周期上踩掉的两个真坑(都有注释):管道方向要用 `UV_WRITABLE_PIPE`(从子进程
角度可写);进程句柄必须**从 spawn 成功起**计入 pending,否则管道先 EOF 会把 job
删掉、进程退出回调再踩已释放内存。spawn 失败路径单独计句柄数与关闭。

用例 `process_supervisor_func`(POSIX;Windows skip):输出/退出码、超时并在
200ms 内收尾、sleep 子进程随进程组被杀、取消幂等且回调一次、200 KB 输出封顶
1024 字节并记截断、stats 分类。文档 `doc/lowlevel-guide.md` §12。

本地 build-all 169/169、build-h3/default 编过;五条文档门禁全绿。
@Antruly
Antruly force-pushed the feat/process-supervisor branch from 2ee63b6 to bcdb0bf Compare November 22, 2026 02:19
@Antruly
Antruly merged commit 4b77774 into master Nov 22, 2026
47 of 49 checks passed
@Antruly
Antruly deleted the feat/process-supervisor branch November 22, 2026 02:51
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant