HcclGetRootInfo

函数原型

HcclResult HcclGetRootInfo(HcclRootInfo *rootInfo)

功能说明

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

参数说明

返回值

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

约束说明

1. 多机集合通信场景，调用HcclGetRootInfo前，需要配置环境变量HCCL_IF_IP、HCCL_WHITELIST_DISABLE、HCCL_WHITELIST_FILE。
2. 调用此接口后，需要以此rank为root节点，将此rank标识信息广播至集群中的所有rank，然后调用HcclCommInitRootInfo接口使用接收到的rootInfo进行HCCL初始化。
3. 该接口和初始化接口HcclCommInitRootInfo配对使用，不能单独使用。