此接口需要在HCCL初始化接口HcclCommInitRootInfo或HcclCommInitRootInfoConfig前调用，仅需在root节点调用，用于生成root节点的rank的标识信息（HcclRootInfo）。

HcclResult HcclGetRootInfo(HcclRootInfo *rootInfo)

参数名	输入/输出	描述
rootInfo	输出	本rank的标识信息，主要包含device ip、device id等信息。此信息需广播至集群内所有rank用来进行HCCL初始化。 HcclRootInfo类型的定义可参见HcclRootInfo。

参数名

输入/输出

描述

rootInfo

输出

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

HcclRootInfo类型的定义可参见HcclRootInfo。

HcclResult：接口成功返回HCCL_SUCCESS，其他失败。

多机集合通信场景，调用HcclGetRootInfo前，可以进行如下操作（非必选）：
- 配置环境变量HCCL_IF_IP或HCCL_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 训练系列产品