Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
30 changes: 30 additions & 0 deletions doc/lowlevel-guide.md
Original file line number Diff line number Diff line change
Expand Up @@ -27,6 +27,7 @@
9. [典型坑](#9-典型坑)
10. [没做的(如实列出)](#10-没做的如实列出)
11. [定时任务(cron)](#11-定时任务cron)
12. [进程监管(process supervisor)](#12-进程监管process-supervisor)

---

Expand Down Expand Up @@ -399,6 +400,35 @@ cron.start(); // 在 loop.run() 之前

---

## 12. 进程监管(process supervisor)

`uvcpp_process_supervisor`(`#include <handle/uvcpp_process_supervisor.h>`)在
`uvcpp_process` 之上补"长期跑外部程序"需要的那几件事:

```cpp
// doc-snippet: fragment — 装配摘录,不是完整翻译单元。
uvcpp::uvcpp_process_supervisor sup(&loop);
uvcpp::uvcpp_process_spec spec;
spec.file = "/usr/bin/ffmpeg";
spec.args = {"-i", in, "-o", out};
spec.timeout_ms = 10 * 60 * 1000;
spec.kill_tree = true;
sup.spawn(spec, on_output, on_exit);
```

- **有界输出**:`capture_stdout/stderr` 打开管道,数据同时给回调和尾缓冲
(`max_output_bytes`,默认 64 KiB/流);超限丢最旧字节并计入
`stdout_truncated`,不会无限吃内存。
- **超时 / 取消**:先 `SIGTERM`,等 `stop_grace_ms` 再强杀;退出回调**恰好一次**,
结果里 `timed_out/cancelled` 说明是谁先动手。
- **POSIX 进程组终止**:`kill_tree=true`(默认)用 `UV_PROCESS_DETACHED` 让子进程
自成进程组,信号发给整组,父进程退出后不留子进程;Windows 上这一版返回
`UV_ENOTSUP`(Job Object 是 issue #69 的后续)。
- 不绑定具体程序、不维护业务状态机;重启策略/任务队列留给上层(#67)。
- 用例:`process_supervisor_func.cpp`(POSIX)。

---

相关文档:[net 网络层指南](./net-guide.md)、[TLS 与证书指南](./ssl-guide.md)、
[项目 README](../README.zh.md)。

Expand Down
Loading
Loading