下载
EN
注册
我要评分
文档获取效率
文档正确性
内容完整性
文档易理解
在线提单
论坛求助
昇腾小AI

HcclGetRootInfo

功能说明

此接口需要在HCCL初始化接口HcclCommInitRootInfoHcclCommInitRootInfoConfig前调用,仅需在root节点调用,用于生成root节点的rank的标识信息(HcclRootInfo)。

函数原型

HcclResult HcclGetRootInfo(HcclRootInfo *rootInfo)

参数说明

参数名

输入/输出

描述

rootInfo

输出

本rank的标识信息,主要包含device ip、device id等信息。此信息需广播至集群内所有rank用来进行HCCL初始化。

HcclRootInfo类型的定义可参见HcclRootInfo

返回值

HcclResult:接口成功返回HCCL_SUCCESS,其他失败。

约束说明

  • 多机集合通信场景,调用HcclGetRootInfo前,可以进行如下操作(非必选):
    • 配置环境变量HCCL_IF_IPHCCL_SOCKET_IFNAME,指定HCCL的初始化root网卡IP(环境变量网HCCL_IF_IP的优先级高于HCCL_SOCKET_IFNAME,若二者都不配置,默认使用网卡名字典序升序选择root网卡)。
    • 配置环境变量HCCL_WHITELIST_DISABLE开启白名单校验,并通过HCCL_WHITELIST_FILE指定通信白名单配置文件(若不配置,默认关闭通信白名单校验)。
  • 调用此接口后,需要以此rank为root节点,将此rank标识信息广播至集群中的所有rank,然后调用HcclCommInitRootInfo接口使用接收到的rootInfo进行HCCL初始化。
  • 该接口和初始化接口HcclCommInitRootInfo配对使用,不能单独使用。

支持的型号

Atlas 训练系列产品

Atlas 300I Duo 推理卡

Atlas A2 训练系列产品

调用示例

可参见样例代码

搜索结果
找到“0”个结果

当前产品无相关内容

未找到相关内容,请尝试其他搜索词