CANN/HCOMM拓扑层级查询API

HcclRankGraphGetRanksByLayer【免费下载链接】hcommHCOMMHuawei Communication是HCCL的通信基础库提供通信域以及通信资源的管理能力。项目地址: https://gitcode.com/cann/hcomm产品支持情况Ascend 950PR/Ascend 950DT支持Atlas A3 训练系列产品/Atlas A3 推理系列产品支持Atlas A2 训练系列产品/Atlas A2 推理系列产品支持[!NOTE]说明 针对Atlas A2 训练系列产品/Atlas A2 推理系列产品仅支持Atlas 800T A2 训练服务器、Atlas 900 A2 PoD 集群基础单元、Atlas 200T A2 Box16 异构子框。功能说明给定通信域和拓扑层级编号返回该层级下本rank所在拓扑实例的所有rank编号列表以及rank数量。以上述拓扑模型为例Layer 0中包含两个拓扑实例为方便理解定义拓扑实例ID分别为0和1。Layer1中包含1个拓扑实例。假设在rank 0上调用此接口如果指定layer层级为0则此接口返回的rank编号列表为[0,1,2]rank数量为3如果指定layer层级为1则此接口返回的rank编号列表为[0,1,2,3,4,5]rank数量为6。函数原型HcclResult HcclRankGraphGetRanksByLayer(HcclComm comm, uint32_t netLayer, uint32_t **ranks, uint32_t *rankNum)参数说明参数名输入/输出描述comm输入通信域。HcclComm类型的定义如下typedef void *HcclComm;netLayer输入拓扑层级编号。ranks输出rank编号列表。rankNum输出rank数量。返回值HcclResult接口成功返回HCCL_SUCCESS其他失败。约束说明无调用示例以功能说明的拓扑模型为例。对于rank0HcclComm commTp; vectoruint32_t ranks; uint32_t rankNum; HcclRankGraphGetRanksByLayer(commTp, netLayer0, ranks, rankNum); // 对于0级拓扑ranks[0,1,2], rankNum3 HcclRankGraphGetRanksByLayer(commTp, netLayer1, ranks, rankNum); // 对于1级拓扑ranks[0,1,2,3,4,5], rankNum6对于rank3HcclComm commTp; vectoruint32_t ranks; uint32_t rankNum; HcclRankGraphGetRanksByLayer(commTp, netLayer0, ranks, rankNum); // 对于0级拓扑ranks[3,4,5], rankNum3 HcclRankGraphGetRanksByLayer(commTp, netLayer1, ranks, rankNum); // 对于1级拓扑ranks[0,1,2,3,4,5], rankNum6【免费下载链接】hcommHCOMMHuawei Communication是HCCL的通信基础库提供通信域以及通信资源的管理能力。项目地址: https://gitcode.com/cann/hcomm创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考