Files
SPHLite/docs/cclite_worker_ipc_adapter.md
T
2026-07-05 17:00:13 +08:00

1.8 KiB

CCLite Worker IPC Adapter

文档状态:0.8.x mock 设计稿

本文记录 SPHLite 侧 worker IPC adapter 的边界。当前实现是 mockable adapter,不打开真实 Windows shared memory 或 named event;真实 IPC 后续实现时应复用这里的句柄、状态和错误路径。

1. 模块边界

IPC adapter 只负责:

  • 保存 command block、data block、command event 和 done 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

调用方也可以通过 CLI 的 --command-block 和 --data-prefix 覆盖默认名称。

3. 状态流程

worker IPC 流程:

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 尚未实现 UNSUPPORTED
非 Windows 真实 IPC IPC

mock 模式用于 CTest,不代表真实 IPC 能力完成。