CANN/hcomm通信域销毁API

HcclCommDestroy【免费下载链接】hcommHCOMMHuawei Communication是HCCL的通信基础库提供通信域以及通信资源的管理能力。项目地址: https://gitcode.com/cann/hcomm产品支持情况Ascend 950PR/Ascend 950DT支持Atlas A3 训练系列产品/Atlas A3 推理系列产品支持Atlas A2 训练系列产品/Atlas A2 推理系列产品支持Atlas 推理系列产品支持Atlas 训练系列产品支持[!NOTE]说明 针对Atlas A2 训练系列产品/Atlas A2 推理系列产品仅支持Atlas 800T A2 训练服务器、Atlas 900 A2 PoD 集群基础单元、Atlas 200T A2 Box16 异构子框。 针对Atlas 推理系列产品仅支持Atlas 300I Duo 推理卡。功能说明销毁指定的HCCL通信域。函数原型HcclResult HcclCommDestroy(HcclComm comm)参数说明参数名输入/输出描述comm输入指向需要销毁的通信域的指针。HcclComm类型的定义可参见HcclComm。返回值HcclResult接口成功返回HCCL_SUCCESS其他失败。约束说明此接口支持跨线程调用当通信域状态处于建链卡住或者未被占用状态时支持跨线程调用此接口销毁通信域并返回HCCL_SUCCESS。通信域销毁成功后正在执行的通信算子无需等待超时时间会直接报错退出并打印ERROR级别日志日志关键字为“Terminating operation due to external request”。当通信域处于非建链卡住状态或者其他被占用状态例如通信域建链过程中、通信算子执行过程中等跨线程调用此接口时会返回HCCL_E_AGAIN错误并打印WARNING级别日志日志关键字为“[HcclCommDestroy] comm is in use, please try again later”。多线程场景下需要确保HCCL接口的调用时序调用此接口销毁通信域后不再支持调用其他集合通信相关接口。调用示例uint32_t rankSize 2; int32_t devices[rankSize] {0, 1}; HcclComm comms[rankSize]; // 初始化通信域 HcclCommInitAll(rankSize, devices, comms); // 销毁通信域 for (uint32_t i 0; i lt; rankSize; i) { HcclCommDestroy(comms[i]); }【免费下载链接】hcommHCOMMHuawei Communication是HCCL的通信基础库提供通信域以及通信资源的管理能力。项目地址: https://gitcode.com/cann/hcomm创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考