Table of Contents

Namespace KernLab.Cell

Classes

CellChannel

宿主侧通道(C2/C304——握手宿主半程+Invoke 关联域+回调服务分发+遥测消费)。

CellChannel.CellChannelOptions

通道配置。

CellContainerExitInfo

容器退出信息(退出码+stderr 尾部取证——容器是黑盒,stderr 是它的窗口,§8)。

CellCorrelationRegistry

关联域(总体设计 §3.3——callId/requestId → TaskCompletionSource 映射):

★ 有界:容量满=背压信号——TryRegister(ulong, TimeSpan, out CellPendingCall) false 拒绝新调用, 不静默挤掉在途关联(诚实边界)。

★ 注册即超时兜底:每条在途注册即挂超时——对端失联/回执丢失不会让调用方永久悬挂。

CellFaultInjector

故障注入器缺省实现。

CellFaultOptions

注入配置(帧号从 1 计——只对第 FrameNumber 帧生效;0=全部帧)。

CellFaultSignal

结构化故障信号(慢/水位类信号不改变状态——降档决策归使用方,§5.2)。

CellFrameDecoder

帧体硬解析门(总体设计 §3.4/§3.6/D5——畸形必报告,绝不静默丢弃): 解码失败给出分类(畸形/未知 tag),报告(事件/计数/断连决策)由调用方承责—— 本类型只保证:解析结果与分类一一对应,没有第三种"悄悄成功/悄悄失败"。

★ 未知 tag 在版本协商后仍出现=UnknownTag;其余一切 解析失败(截断/变长超防御上限/跨成员配对不齐)=MalformedFrame。

CellLoadPipeline

宿主侧装载管线(C206——spec→spawn→握手→ready→池化;drain 窗口与世代轮换)。

CellPool

spec 池(§5.1):按 spec 全值分键;同规格替补;并发租借。 异规格替补被拒=结构断言(宁可红不可凑数)。

CellPoolEntry

池项:spec → 容器实例(并发租借由 AcquireAsync(CancellationToken) 的信号量把守)。

CellProcess

容器进程托管(C203):spawn+stdout 端点自报解析+stderr 尾部 60 行取证+kill 树+ 资源翻译(cgroup v2/JobObject——执法者是 OS,Cell 只翻译与回收)+零孤儿(--parent-pid)。

CellProcessStartOptions

进程启动选项(C203——dotnet KernLab.Cell.Runtime.dll --pack … --startup … --parent-pid …)。

CellResourceEnforcer

资源翻译(C203——§5.2:执法者是 OS,Cell 只翻译;Linux=cgroup v2,Windows=JobObject)。 执法断言=OS 侧实证(超限被杀/限流——见 CellResourceEnforcer.ReadOomKills)。

CellSpec

容器规格(charter 冻结的一租户一容器,§5.1):租户+包集+世代。 池键=spec 全值——任一分量不同即不同池项;世代语义:包集变更=新世代新容器(热升级不做,D3)。

CellStateChange

状态迁移事件(§5.3 结构化监督事件)。

CellSupervisor

容器监督器(§5.2——单写者泵域:一个监督泵串行处理全部状态迁移与池决策输入, 无锁竞态面归零)。快慢分离:崩溃/挂死=状态迁移(Faulted);慢/水位=结构化信号(决策归使用方,D6)。

CellSupervisorOptions

监督器配置(心跳判定与水位阈值——§8/§9)。

ChunkedInvocation

流式调用句柄(宿主侧——InvokeStreamAsync(string, ushort, PipeReader, TimeSpan?, CancellationToken) 产物): Body 读到流结束=响应体尽;Completion 收场尾单——必须读到体尽并等尾单 (错误码非 0 时已读体是部分产物,使用方自决取舍)。Dispose 只做本地清理(放弃 Body——在途关联由 deadline/ChunkEnd 诚实收场,不伪造)。

ChunkedTrailer

分块流收场尾单(Completion——错误码非 0=调用失败,已读部分体是部分产物)。

ContainerNotification

容器通知(宿主侧接收形态——拷贝脱离池化帧,事件 handler 收独立副本;双向通知设计稿 §4)。

FrameReader

帧读器——分帧(总体设计 §3.1:Cell 拥有;[长度 4B 大端][帧体],上限校验在此一次做完)。

★ 读路径硬解析纪律(§3.6/D5):字节级协议错误(超限前缀/帧中途流断)=结构化协议错误事件+计数+终止, 绝不静默跳过——静默丢帧把协议错误伪装成"对端没反应",排查成本最高。

★ 帧体以池化连续缓冲交付(管道段→池一次拷贝);帧体解码零拷贝契约由 CellFrameCodec.TryDecode(ReadOnlySpan<byte>, out CellFrame)(ReadOnlySpan 原位可解)承责—— shm 档以槽直读满足同契约,通道 API 不变。

FrameWriter

帧写器——写路径单点串行(总体设计 §3.6/D5):所有写入进 FIFO 任务链,链上永远只有一环在写, 多写者并发调用一条流在结构上不可能——撕裂长度前缀与载荷的缺陷没有存在的位置。

★ 帧原子性:取消(CancellationToken)只在作业未上链执行时生效;一旦开始写, 该帧写完为止(半帧即分帧已破——宁慢勿撕)。

★ 两形态:消息直写(WriteAsync(CellFrame, CancellationToken)——链内 ComputeLength/EncodeInto 直写管道,零中间拷贝) 与已编码帧体(WriteRawAsync(ReadOnlyMemory<byte>, CancellationToken)——入队时拷入池,调用方缓冲即刻可复用)。

InProcessTransport

InProcess 载体(§4 载体阶梯 0 级——内存对拷,测试同构): Bind/Connect 以端点描述符配对,对拷经内存管道(无 socket、无内核通路——往返损耗 ≈0)。

★ 单元秒级纪律(§10)的载体底座:协议通道测试在真 ICellTransport 面上跑, 与环回 TCP/UDS 载体等价复跑(C204 对抗纪律)。

★ 只接受 inproc: 端点(载体限定——用错 scheme 即错连面,fail-fast)。

InjectProbe

注入探针(测试面——慢消费放行等运行时干预口)。

LoopbackTcpTransport

环回 TCP 载体(§4 载体阶梯 1 级——现役缺省:BCL 现成、跨平台同码,自制成本最低; 它是载体不是协议身份)。绑定恒为 127.0.0.1——本阶梯全部是同机载体(D9)。

NamedPipeCellTransport

Windows 命名管道载体(§4 载体阶梯——UDS 的 Windows 对位物:内核介质+ACL 面,非 TCP 栈)。 判例正确形态铁律(2026-09-26 挂死判例经 tests/KernLab.Cell.NpProbe 净室七形态复验后收敛): PipeDirection.InOut+PipeTransmissionMode.Byte+PipeOptions.Asynchronous+显式 64KB 缓冲。 仅 Windows——非 Windows 构造即抛(与 uds 在 Windows 侧对称互斥,fail-fast 不静默)。

ShmCellTransport

shm 载体(§4 阶梯级 2——环回段+门铃,内核移出数据通路):宿主侧创建段(一段双环, 严格 SPSC——A 环宿主→容器调用域,B 环容器→宿主回执/回调/遥测域),两环均 BlockWriter (调用域不许丢;遥测的丢最旧在容器侧遥测出口内建,不落在环上)。

★ 接入形态:Windows 按名 Open;Unix 匿名段经 bootstrap UDS 传递描述符 (1 段 + 4 门铃,槽位序 = 段, Bell0..Bell3——Tier ShmRing §7 契约)。

★ 通道桥:写侧每帧一次暂存→入环(Tier Write 为拷贝入口,快路径 TryWrite+Signal); 读侧专用泵线程阻塞 Read(门铃高效等待、对端死亡自醒)→管道——异步面由管道原生提供, 同步阻塞线程不占调用方线程池。泵线程为后台线程:收场依赖对端死亡自醒或进程退出。

UdsCellTransport

UDS 载体(§4 阶梯 1'——Linux;去 IP 栈。Windows 命名管道挂死实证未复验前不启用,§4/R1)。

Structs

CellPendingCall

在途关联句柄(callId/requestId → 结果任务——注册即超时兜底,§3.3 关联域原语)。

Interfaces

ICellContainerInstance

容器实例抽象(C203/C206 的进程容器实现此口——池对实例零感知)。

ICellFaultInjector

故障注入器(常设对抗面——C205:断连/半帧/畸形帧/延迟/慢消费;对任一载体等价复跑)。

ICellSupervisorEvents

监督事件出口(§5.3——使用方注入;Cell 不自带日志后端,零第三方纪律)。

Enums

CellContainerState

容器实例状态(§5.2 监督状态机)。

CellFaultFamily

故障谱系族(§5.2 表四行+资源超限——每行必有对应事件可断言)。

CellFaultKind

注入形态(C205——对抗面全谱系;§4/§10:任一载体等价复跑)。

CellRuntimeLoadMode

装载模式(宿主侧转发口径——与容器内 CellLoadMode 对齐)。

CellTransitionReason

状态迁移原因(诊断语义——事件取证面)。