70 lines
2.3 KiB
Markdown
70 lines
2.3 KiB
Markdown
# CCLite Worker IPC Adapter
|
|
|
|
文档状态:0.8.x IPC 骨架说明
|
|
|
|
本文记录 SPHLite 侧 worker IPC adapter 的边界。当前实现保留 mockable adapter,并新增 Windows shared memory/named event attach、wait、signal 和 close 路径;Windows 构建的能力查询报告 `supports_real_ipc=yes`,非 Windows 构建仍报告 `supports_real_ipc=no`。真实外部 CCLite 进程联调仍未验收。
|
|
|
|
## 1. 模块边界
|
|
|
|
IPC adapter 只负责:
|
|
|
|
- 保存 command block、data block、command event 和 done event 名称。
|
|
- 打开 CCLite 预创建的 command/data shared memory 和 named event。
|
|
- 写入 `READY` 和 `DONE` 状态。
|
|
- 等待 command event。
|
|
- signal done event。
|
|
- 把 shared memory 或 event 打开失败、wait 超时等问题转换为 worker error code。
|
|
|
|
IPC adapter 不负责:
|
|
|
|
- 创建、reset 或销毁 CCLite 持有的 shared memory。
|
|
- 创建、reset 或销毁 CCLite 持有的 named event。
|
|
- 解析 FEMLite 数据。
|
|
- 计算 SPH-FEM 接触或 FSI 载荷。
|
|
|
|
## 2. 句柄抽象
|
|
|
|
当前 `sphlite_worker_ipc_t` 保存以下名称和平台句柄:
|
|
|
|
| 字段 | 默认命名 |
|
|
|---|---|
|
|
| `ipc_name` | CCLite 传入的基础名 |
|
|
| `command_block` | `<ipc_name>.command` |
|
|
| `data_prefix` | `<ipc_name>.data` |
|
|
| `command_event` | `<ipc_name>.command_event` |
|
|
| `done_event` | `<ipc_name>.done_event` |
|
|
|
|
真实 Windows IPC 路径只打开 CCLite 持有的资源,不创建、不 reset、不销毁 CCLite 的资源。SPHLite 仅在自身退出时关闭本进程句柄和 view。
|
|
|
|
调用方也可以通过 CLI 的 `--command-block` 和 `--data-prefix` 覆盖默认名称。
|
|
|
|
## 3. 状态流程
|
|
|
|
worker IPC 流程:
|
|
|
|
```text
|
|
init names
|
|
open handles
|
|
write READY
|
|
|
|
loop:
|
|
wait command event
|
|
execute command
|
|
write DONE with ack/state/error
|
|
signal done event
|
|
```
|
|
|
|
`sphlite_worker_ipc_reset_event` 固定返回 `CONFLICT`,用于锁定 SPHLite 不 reset CCLite event 的约束。
|
|
|
|
## 4. 错误路径
|
|
|
|
| 场景 | 错误码 |
|
|
|---|---|
|
|
| shared memory 或 event 尚未打开 | `IPC` |
|
|
| wait 超时 | `TIMEOUT` |
|
|
| event reset 尝试 | `CONFLICT` |
|
|
| Windows IPC 资源不存在或 attach 失败 | `IPC` |
|
|
| 非 Windows 真实 IPC | `UNSUPPORTED` |
|
|
|
|
mock 模式用于 CTest,不代表真实 CCLite 进程联调完成;Windows IPC self-test 只证明 SPHLite 侧可打开、等待、响应和关闭标准 IPC 资源。
|