* Copyright (c) 2025 Huawei Technologies Co., Ltd.
* This program is free software, you can redistribute it and/or modify it under the terms and conditions of
* CANN Open Software License Agreement Version 2.0 (the "License").
* Please refer to the License for details. You may not use this file except in compliance with the License.
* THIS SOFTWARE IS PROVIDED ON AN "AS IS" BASIS, WITHOUT WARRANTIES OF ANY KIND, EITHER EXPRESS OR IMPLIED,
* INCLUDING BUT NOT LIMITED TO NON-INFRINGEMENT, MERCHANTABILITY, OR FITNESS FOR A PARTICULAR PURPOSE.
* See LICENSE in the root of the software repository for the full text of the License.
*/
#include "hccl_api_base_test.h"
using namespace std;
using namespace hccl;
constexpr const char* RANKTABLE_FILE_NAME = "./ut_independent_op_test.json";
class HcclCommEngineCtxTest : public BaseInit {
public:
void SetUp() override {
BaseInit::SetUp();
UT_USE_RANK_TABLE_910_1SERVER_1RANK;
UT_COMM_CREATE_DEFAULT(comm);
}
void TearDown() override {
Ut_Comm_Destroy(comm);
BaseInit::TearDown();
GlobalMockObject::verify();
}
};
static inline HcclMem MakeMem(void* addr, uint64_t size, HcclMemType type)
{
HcclMem m{};
m.addr = addr;
m.size = size;
m.type = type;
return m;
}
static inline bool IsMemEqual(const HcclMem& lhm, const HcclMem& rhm)
{
return lhm.type == rhm.type && lhm.addr == rhm.addr && lhm.size == rhm.size;
}
TEST_F(HcclCommEngineCtxTest, Ut_CommEngineCtx_When_Error_Input_Expect_Return_ERROR)
{
uint64_t size = 16;
void *ctx = nullptr;
HcclResult ret = HcclEngineCtxCreate(nullptr, "opTag", CommEngine::COMM_ENGINE_CPU, size, &ctx);
EXPECT_EQ(ret, HCCL_E_PTR);
ret = HcclEngineCtxCreate(comm, "opTag", CommEngine::COMM_ENGINE_CPU, size, nullptr);
EXPECT_EQ(ret, HCCL_E_PTR);
ret = HcclEngineCtxCreate(comm, "opTag", CommEngine::COMM_ENGINE_RESERVED, size, &ctx);
EXPECT_EQ(ret, HCCL_E_PARA);
ret = HcclEngineCtxCreate(comm, "opTag", CommEngine::COMM_ENGINE_CPU, 0, &ctx);
EXPECT_EQ(ret, HCCL_E_PARA);
char opTag[HCCL_RES_TAG_MAX_LEN+2];
memset(opTag, 'A', HCCL_RES_TAG_MAX_LEN+1);
opTag[HCCL_RES_TAG_MAX_LEN+1] = '\0';
ret = HcclEngineCtxCreate(comm, opTag, CommEngine::COMM_ENGINE_CPU, size, &ctx);
EXPECT_EQ(ret, HCCL_E_PARA);
ret = HcclEngineCtxGet(nullptr, "opTag", CommEngine::COMM_ENGINE_CPU, &ctx, &size);
EXPECT_EQ(ret, HCCL_E_PTR);
ret = HcclEngineCtxGet(comm, opTag, CommEngine::COMM_ENGINE_CPU, &ctx, &size);
EXPECT_EQ(ret, HCCL_E_PARA);
ret = HcclEngineCtxDestroy(nullptr, "opTag", CommEngine::COMM_ENGINE_CPU);
EXPECT_EQ(ret, HCCL_E_PTR);
}
TEST_F(HcclCommEngineCtxTest, Ut_HcclEngineCtxCreate_When_Duplicate_Creation_Expect_Return_EPARA)
{
uint64_t size = 16;
void *ctx = nullptr;
HcclResult ret = HcclEngineCtxCreate(comm, "opTag", CommEngine::COMM_ENGINE_CPU, size, &ctx);
EXPECT_EQ(ret, HCCL_SUCCESS);
EXPECT_NE(ctx, nullptr);
ret = HcclEngineCtxCreate(comm, "opTag", CommEngine::COMM_ENGINE_CPU, size, &ctx);
EXPECT_EQ(ret, HCCL_E_PARA);
ret = HcclEngineCtxDestroy(comm, "opTag", CommEngine::COMM_ENGINE_CPU);
EXPECT_EQ(ret, HCCL_SUCCESS);
}
TEST_F(HcclCommEngineCtxTest, Ut_HcclEngineCtxGet_When_Uncreated_Expect_Return_SUCCESS)
{
uint64_t size = 0;
void *ctx = nullptr;
HcclResult ret = HcclEngineCtxGet(comm, "opTag", CommEngine::COMM_ENGINE_CPU, &ctx, &size);
EXPECT_EQ(ret, HCCL_E_PARA);
}
TEST_F(HcclCommEngineCtxTest, Ut_HcclEngineCtxGet_When_Error_Engine_Expect_Return_EPARA)
{
uint64_t size = 16;
void *ctx = nullptr;
HcclResult ret = HcclEngineCtxCreate(comm, "opTag", CommEngine::COMM_ENGINE_CPU, size, &ctx);
EXPECT_EQ(ret, HCCL_SUCCESS);
EXPECT_NE(ctx, nullptr);
HcclMem* engineCtxPtr;
ret = HcclEngineCtxGet(comm, "opTag", CommEngine::COMM_ENGINE_AICPU, &ctx, &size);
EXPECT_EQ(ret, HCCL_E_PARA);
ret = HcclEngineCtxGet(comm, "opTag", CommEngine::COMM_ENGINE_CCU, &ctx, &size);
EXPECT_EQ(ret, HCCL_E_PARA);
ret = HcclEngineCtxDestroy(comm, "opTag", CommEngine::COMM_ENGINE_CPU);
EXPECT_EQ(ret, HCCL_SUCCESS);
}
TEST_F(HcclCommEngineCtxTest, Ut_HcclEngineCtxDestroy_When_Uncreated_Expect_Return_EPARA)
{
HcclResult ret = HcclEngineCtxDestroy(comm, "opTag", CommEngine::COMM_ENGINE_CPU);
EXPECT_EQ(ret, HCCL_E_PARA);
}
TEST_F(HcclCommEngineCtxTest, Ut_CommEngineCtx_When_Host_Expect_Return_SUCCESS)
{
uint64_t size = 16;
void *ctx = nullptr;
HcclResult ret = HcclEngineCtxCreate(comm, "opTag", CommEngine::COMM_ENGINE_CPU, size, &ctx);
EXPECT_EQ(ret, HCCL_SUCCESS);
EXPECT_NE(ctx, nullptr);
void *ctxGet;
uint64_t sizeGet = 0;
ret = HcclEngineCtxGet(comm, "opTag", CommEngine::COMM_ENGINE_CPU, &ctxGet, &sizeGet);
EXPECT_EQ(ret, HCCL_SUCCESS);
HcclMem createCtx = MakeMem(ctx, 16, HCCL_MEM_TYPE_HOST);
HcclMem getCtx = MakeMem(ctxGet, sizeGet, HCCL_MEM_TYPE_HOST);
EXPECT_EQ(IsMemEqual(createCtx, getCtx), true);
ret = HcclEngineCtxDestroy(comm, "opTag", CommEngine::COMM_ENGINE_CPU);
EXPECT_EQ(ret, HCCL_SUCCESS);
}
TEST_F(HcclCommEngineCtxTest, Ut_CommEngineCtx_When_Device_Expect_Return_SUCCESS)
{
uint64_t size = 16;
void *ctx = nullptr;
HcclResult ret = HcclEngineCtxCreate(comm, "opTag", CommEngine::COMM_ENGINE_AICPU, size, &ctx);
EXPECT_EQ(ret, HCCL_SUCCESS);
EXPECT_NE(ctx, nullptr);
void *ctxGet;
uint64_t sizeGet = 0;
ret = HcclEngineCtxGet(comm, "opTag", CommEngine::COMM_ENGINE_AICPU, &ctxGet, &sizeGet);
EXPECT_EQ(ret, HCCL_SUCCESS);
HcclMem createCtx = MakeMem(ctx, 16, HCCL_MEM_TYPE_HOST);
HcclMem getCtx = MakeMem(ctxGet, sizeGet, HCCL_MEM_TYPE_HOST);
EXPECT_EQ(IsMemEqual(createCtx, getCtx), true);
ret = HcclEngineCtxDestroy(comm, "opTag", CommEngine::COMM_ENGINE_AICPU);
EXPECT_EQ(ret, HCCL_SUCCESS);
}