HcclRankGraphGetTopoInstsByLayer

Applicability

Product	Supported
Atlas 350 Accelerator Card	√
Atlas A3 training product/Atlas A3 inference product	x
Atlas A2 training product/Atlas A2 inference product	x
Atlas 200I/500 A2 inference product	x
Atlas inference product	x
Atlas training product	x

Function

Queries the topology instance set of the current rank based on the given communicator and topology layer ID.

Prototype

HcclResult HcclRankGraphGetTopoInstsByLayer(HcclComm comm, uint32_t netLayer, uint32_t **topoInsts, uint32_t *topoInstNum)

Parameters

Parameter

Input/Output

Description

comm

Input

Communicator.

The HcclComm type is defined as follows:

typedef void *HcclComm;

netLayer

Input

Topology layer ID.

topoInsts

Output

Topology instance list.

topoInstNum

Output

Number of topology instances.

Returns

HcclResult: HCCL_SUCCESS on success, or else failure.

Restrictions

None

Example

HcclComm comm;
uint32_t netLayer = 0;
uint32_t *topoInsts = nullptr;
uint32_t topoInstNum = 0;
// If topoInstanceId is not configured in the topology file, the default value 0 is used.
HcclRankGraphGetTopoInstsByLayer(comm, netLayer, &topoInsts, &topoInstNum); 
// topoInsts = [0], topoInstNum = 1

Parent topic: Topology Information Query