---
title: CreateHcclCommByRankTableFile
description: "backend为HCCL时，使用ranktable的方式创建单机多卡通信域功能。"
url: https://www.hiascend.com/document/detail/zh/canncommercial/latest/API/ascendtb/ascendtb_01_0308.html
sourcePath: /source/zh/canncommercial/900/API/ascendtb/ascendtb_01_0308.html
indexId: 282870dbd0b893e682847b92b68fd1cae63190c4ea668d3174aecf98088aeee764
---
# CreateHcclCommByRankTableFile

#### 功能说明

backend为HCCL时，使用ranktable的方式创建单机多卡通信域功能。


#### 定义

```
namespace atb {
using void *HcclComm;
namespace Comm {
HcclComm CreateHcclCommByRankTableFile(int32_t rank, int32_t rankSize, const char *rankTableFile, char *commName);
}; // namespace Comm
} // namespace atb
```


#### 参数列表

| 成员名称 | 输入/输出 | 类型 | 默认值 | 描述 |
| --- | --- | --- | --- | --- |
| rank | 输入 | int32\_t | \- | 当前卡所属通信编号。 |
| rankSize | 输入 | int32\_t | \- | 通信的卡的数量。 |
| rankTableFile | 输入 | char \* | \- | 集群信息的配置文件路径。 |
| commName | 输出 | char \* | \- | 通信域名称。 |


#### 约束说明

rank、rankSize、rankRoot需满足0 ≤ rank < rankSize。

只支持 Atlas A2 训练系列产品 / Atlas A2 推理系列产品 和 Atlas A3 推理系列产品 / Atlas A3 训练系列产品 。