libxtos-bcixtos_bci_snapshot_release

xtos_bci_snapshot_release

先本地 unmap,再释放 token;无本家族快照时成功返回 0。

本页目录

声明

c
#include <xtos/bci.h>

int xtos_bci_snapshot_release(xtos_bci_session_t *session);

参数

参数类型说明
sessionxtos_bci_session_t *非 NULL,调用方持有且负责生命周期;必须串行使用。

返回值

成功返回 0;失败返回 -1 并保留原 errno。必须根据剩余所有权重试;释放不会消费 ring。

错误

errno条件
EINVALsession 为 NULL。
munmap errno解除映射失败;映射和 token 均保留,允许重试。
ioctl errno本地映射已解除,token 清理按本家族规则处理。

注意事项

  • 同一会话的所有 API 必须由调用方串行化;SDK 无内部锁。调用可阻塞或分配,不能据此保证实时 deadline。
  • ioctl 失败时映射已失效;除 ENODEV/ENOENT 终止本地 token 所有权外,其他错误保留 token 供重试(包括 ESTALE)。终止所有权的失败仍返回 -1 并保留 errno。
  • 断连后也允许尝试释放;成功 unmap 后所有输出指针立即失效,SDK 不会回写清空调用方旧描述符。munmap 失败时尚未发释放 ioctl。
  • destroy 即使 STOP 失败也尝试两个家族的清理,但 destroy 无返回值,不能保证或重试其失败;需要可观察清理结果时先显式 release 并处理失败。

示例

c
#include <xtos/bci.h>
int release_view(xtos_bci_session_t *s) {
    return xtos_bci_snapshot_release(s);
}

源码

本文按 OpenXTOS v1.0.2(c24e923717670c4724cdaf24c7c105caee8dc2fb)的头文件和实现编写。