昇腾社区首页
中文
注册

HcclCommInitClusterInfoConfig

产品支持情况

产品

是否支持

Atlas A2 训练系列产品

Atlas 800I A2 推理产品

x

Atlas 200I/500 A2 推理产品

x

Atlas 推理系列产品

Atlas 训练系列产品

Atlas 200/300/500 推理产品

x

针对 Atlas 推理系列产品 ,仅支持此系列产品中的Atlas 300I Duo 推理卡

功能说明

基于ranktable,初始化具有特定配置的HCCL通信域。

函数原型

1
HcclResult HcclCommInitClusterInfoConfig(const char *clusterInfo, uint32_t rank, HcclCommConfig *config, HcclComm *comm)

参数说明

参数名

输入/输出

描述

clusterInfo

输入

Ranktable文件路径(含文件名),作为字符串最大长度为4096字节,含结束符。

rank

输入

本rank的rank id。

需要注意,此参数取值需要与ranktable中对应的“rank_id”字段取值一致。

config

输入

通信域配置项,包括buffer大小、确定性计算开关、通信域名称、通信算法编排展开位置等信息,配置参数需确保在合法值域内,关于HcclCommConfig中的详细参数含义及优先级可参见HcclCommConfig的定义。

需要注意:传入的config必须先调用HcclCommConfigInit对其进行初始化。

comm

输出

将初始化后的通信域以指针的信息回传给调用者。

HcclComm类型的定义可参见HcclComm

返回值

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

约束说明

同一通信域不支持重复初始化。