xssh/ssh_kex_session

返回：校验四段 transcript 借用视图；调用方保证其存活到本轮 KEX 完成。

sshkextranscriptinit obj;
xrtSshKexTranscriptInit(&obj, pTranscript, ClientVersion, ServerVersion, ClientKexInit, ServerKexInit);

返回：计算复制完整 transcript 所需的精确字节数。

/* 计算复制完整 transcript 所需的精确字节数。 */
result = xrtSshKexTranscriptMeasure(pTranscript, pSize);

返回：将 transcript 追加到 writer，并返回借用 writer 输出的稳定视图。

/* 将 transcript 追加到 writer，并返回借用 writer 输出的稳定视图。 */
result = xrtSshKexTranscriptWrite(pWriter, pInput, pOutput);

返回：初始化可重复执行初始 KEX 和 rekey 的确定性会话。

sshkexsessioninit obj;
xrtSshKexSessionInit(&obj, pSession, Role);

返回：安全清除临时私钥、共享秘密、派生密钥和 SessionId。

/* 安全清除临时私钥、共享秘密、派生密钥和 SessionId。 */
result = xrtSshKexSessionClear(pSession);

返回：XRT_API xsshcode xrtSshKexSessionBeginWithPrivate( xsshkexsession* pSession, xsshtransportcore* pCore, const xsshkextranscript* pTranscript, xbytesview ServerHostKey, xbytesview PrivateKey );

/* XRT_API xsshcode xrtSshKexSessionBeginWithPrivate( xsshkexsession* pSession, xsshtransportcore* pCore, const xsshkextranscript* pTranscript, xbytesview ServerHostKey, xbytesview PrivateKey ); */
result = xrtSshKexSessionBeginWithPrivate();

返回：返回当前最常见的下一动作，不推进任何状态。

/* 返回当前最常见的下一动作，不推进任何状态。 */
result = xrtSshKexSessionEvent(pSession);

返回：返回本代协商结果；视图借用 transcript。

/* 返回本代协商结果；视图借用 transcript。 */
result = xrtSshKexSessionNegotiation(pSession, pNegotiation);

返回：返回本代 exchange hash，服务端可交给本地密钥或 HSM 签名。

/* 返回本代 exchange hash，服务端可交给本地密钥或 HSM 签名。 */
result = xrtSshKexSessionExchangeHash(pSession, pHash);

返回：返回首次 exchange hash 固化的 SessionId。

/* 返回首次 exchange hash 固化的 SessionId。 */
result = xrtSshKexSessionId(pSession, pSessionId);

返回：返回已完成密码学验签、等待信任策略确认的服务端主机公钥。

/* 返回已完成密码学验签、等待信任策略确认的服务端主机公钥。 */
result = xrtSshKexSessionHostKey(pSession, pHostKey);

返回：客户端确认主机密钥信任；之后才允许发送 NEWKEYS。

/* 客户端确认主机密钥信任；之后才允许发送 NEWKEYS。 */
result = xrtSshKexSessionHostKeyAccept(pSession);

返回：将会话置为不可继续状态并安全清除本代秘密。

/* 将会话置为不可继续状态并安全清除本代秘密。 */
result = xrtSshKexSessionFail(pSession);

返回：客户端准备 SSH_MSG_KEX_ECDH_INIT；可靠提交后调用 WriteCommit。

sshkexsessionecdhinitprepare obj;
xrtSshKexSessionEcdhInitPrepare(&obj, pSession, pWriter);

返回：服务端用外部签名 blob 准备 SSH_MSG_KEX_ECDH_REPLY。

/* 服务端用外部签名 blob 准备 SSH_MSG_KEX_ECDH_REPLY。 */
result = xrtSshKexSessionEcdhReplyPrepare(pSession, pWriter, Signature);

返回：准备 SSH_MSG_NEWKEYS；方法交换和客户端主机信任必须已完成。

/* 准备 SSH_MSG_NEWKEYS；方法交换和客户端主机信任必须已完成。 */
result = xrtSshKexSessionNewKeysPrepare(pSession, pWriter);

返回：transport core 已可靠提交当前输出后提交 KEX 写事务。

/* transport core 已可靠提交当前输出后提交 KEX 写事务。 */
result = xrtSshKexSessionWriteCommit(pSession, pCore);

返回：放弃尚未交给 transport 的 KEX 输出，不消费任何会话状态。

/* 放弃尚未交给 transport 的 KEX 输出，不消费任何会话状态。 */
result = xrtSshKexSessionWriteAbort(pSession);

返回：XRT_API xsshcode xrtSshKexSessionReadPrepare( xsshkexsession* pSession, const xsshtransportcore* pCore, xbytesview Payload, void* pHostKeyStorage, size_t iHostKeyCapacity, size_t* pHostKeySize );

/* XRT_API xsshcode xrtSshKexSessionReadPrepare( xsshkexsession* pSession, const xsshtransportcore* pCore, xbytesview Payload, void* pHostKeyStorage, size_t iHostKeyCapacity, size_t* pHostKeySize ); */
result = xrtSshKexSessionReadPrepare();

返回：transport core 已提交当前输入后提交 KEX 读事务。

/* transport core 已提交当前输入后提交 KEX 读事务。 */
result = xrtSshKexSessionReadCommit(pSession, pCore);

返回：放弃已认证 KEX 输入并终止会话；对应 transport 也必须关闭。

/* 放弃已认证 KEX 输入并终止会话；对应 transport 也必须关闭。 */
result = xrtSshKexSessionReadAbort(pSession);

返回：本端 NEWKEYS 提交后，把角色对应的派生密钥装入写 codec。

/* 本端 NEWKEYS 提交后，把角色对应的派生密钥装入写 codec。 */
result = xrtSshKexSessionActivateWrite(pSession, pCore, iNowMs);

返回：对端 NEWKEYS 提交后，把角色对应的派生密钥装入读 codec。

/* 对端 NEWKEYS 提交后，把角色对应的派生密钥装入读 codec。 */
result = xrtSshKexSessionActivateRead(pSession, pCore, iNowMs);

返回：判断本代双向密钥和 transport core 均已完成切换。

/* 判断本代双向密钥和 transport core 均已完成切换。 */
result = xrtSshKexSessionComplete(pSession, pCore);