/* * Copyright (C) 2017-2020 Intel Corporation * * SPDX-License-Identifier: MIT * */ #include "shared/source/device/device.h" #include "shared/test/unit_test/helpers/debug_manager_state_restore.h" #include "shared/test/unit_test/helpers/variable_backup.h" #include "shared/test/unit_test/mocks/mock_device.h" #include "opencl/source/command_queue/command_queue.h" #include "opencl/source/context/context.inl" #include "opencl/source/device_queue/device_queue.h" #include "opencl/source/sharings/sharing.h" #include "opencl/test/unit_test/fixtures/platform_fixture.h" #include "opencl/test/unit_test/mocks/mock_cl_device.h" #include "opencl/test/unit_test/mocks/mock_command_queue.h" #include "opencl/test/unit_test/mocks/mock_context.h" #include "opencl/test/unit_test/mocks/mock_deferred_deleter.h" #include "opencl/test/unit_test/mocks/mock_memory_manager.h" #include "opencl/test/unit_test/mocks/mock_platform.h" #include "opencl/test/unit_test/test_macros/test_checks_ocl.h" #include "gtest/gtest.h" using namespace NEO; class WhiteBoxContext : public Context { public: MemoryManager *getMM() { return this->memoryManager; } const cl_context_properties *getProperties() const { return properties; } size_t getNumProperties() const { return numProperties; } WhiteBoxContext(void(CL_CALLBACK *pfnNotify)(const char *, const void *, size_t, void *), void *userData) : Context(pfnNotify, userData){}; }; struct ContextTest : public PlatformFixture, public ::testing::Test { using PlatformFixture::SetUp; void SetUp() override { PlatformFixture::SetUp(); cl_platform_id platform = pPlatform; properties = new cl_context_properties[3]; properties[0] = CL_CONTEXT_PLATFORM; properties[1] = (cl_context_properties)platform; properties[2] = 0; context = Context::create(properties, ClDeviceVector(devices, num_devices), nullptr, nullptr, retVal); ASSERT_NE(nullptr, context); } void TearDown() override { delete[] properties; delete context; PlatformFixture::TearDown(); } cl_int retVal = CL_SUCCESS; WhiteBoxContext *context = nullptr; cl_context_properties *properties = nullptr; }; TEST_F(ContextTest, WhenCreatingContextThenDevicesAllDevicesExist) { for (size_t deviceOrdinal = 0; deviceOrdinal < context->getNumDevices(); ++deviceOrdinal) { EXPECT_NE(nullptr, context->getDevice(deviceOrdinal)); } } TEST_F(ContextTest, WhenCreatingContextThenMemoryManagerForContextIsSet) { EXPECT_NE(nullptr, context->getMM()); } TEST_F(ContextTest, WhenCreatingContextThenPropertiesAreCopied) { auto contextProperties = context->getProperties(); EXPECT_NE(properties, contextProperties); } TEST_F(ContextTest, WhenCreatingContextThenPropertiesAreValid) { auto contextProperties = context->getProperties(); ASSERT_NE(nullptr, contextProperties); EXPECT_EQ(3u, context->getNumProperties()); while (*contextProperties) { switch (*contextProperties) { case CL_CONTEXT_PLATFORM: ++contextProperties; break; default: ASSERT_FALSE(!"Unknown context property"); break; } ++contextProperties; } } TEST_F(ContextTest, WhenCreatingContextThenSpecialQueueIsAvailable) { auto specialQ = context->getSpecialQueue(); EXPECT_NE(specialQ, nullptr); } TEST_F(ContextTest, WhenSettingSpecialQueueThenQueueIsAvailable) { MockContext context((ClDevice *)devices[0], true); auto specialQ = context.getSpecialQueue(); EXPECT_EQ(specialQ, nullptr); auto cmdQ = new MockCommandQueue(&context, (ClDevice *)devices[0], 0); context.setSpecialQueue(cmdQ); specialQ = context.getSpecialQueue(); EXPECT_NE(specialQ, nullptr); } TEST_F(ContextTest, WhenSettingDefaultQueueThenQueueIsAvailable) { REQUIRE_DEVICE_ENQUEUE_OR_SKIP(context); EXPECT_EQ(nullptr, context->getDefaultDeviceQueue()); auto dq = new DeviceQueue(); context->setDefaultDeviceQueue(dq); EXPECT_EQ(dq, context->getDefaultDeviceQueue()); delete dq; } TEST_F(ContextTest, givenCmdQueueWithoutContextWhenBeingCreatedNextDeletedThenContextRefCountShouldNeitherBeIncrementedNorNextDecremented) { MockContext context((ClDevice *)devices[0]); EXPECT_EQ(1, context.getRefInternalCount()); auto cmdQ1 = new MockCommandQueue(); EXPECT_EQ(1, context.getRefInternalCount()); delete cmdQ1; EXPECT_EQ(1, context.getRefInternalCount()); auto cmdQ2 = new MockCommandQueue(nullptr, (ClDevice *)devices[0], 0); EXPECT_EQ(1, context.getRefInternalCount()); delete cmdQ2; EXPECT_EQ(1, context.getRefInternalCount()); } TEST_F(ContextTest, givenDeviceQueueWithoutContextWhenBeingCreatedNextDeletedThenContextRefCountShouldNeitherBeIncrementedNorNextDecremented) { REQUIRE_DEVICE_ENQUEUE_OR_SKIP(context); MockContext context((ClDevice *)devices[0]); EXPECT_EQ(1, context.getRefInternalCount()); auto cmdQ1 = new DeviceQueue(); EXPECT_EQ(1, context.getRefInternalCount()); delete cmdQ1; EXPECT_EQ(1, context.getRefInternalCount()); cl_queue_properties properties = 0; auto cmdQ2 = new DeviceQueue(nullptr, (ClDevice *)devices[0], properties); EXPECT_EQ(1, context.getRefInternalCount()); delete cmdQ2; EXPECT_EQ(1, context.getRefInternalCount()); } TEST_F(ContextTest, givenCmdQueueWithContextWhenBeingCreatedNextDeletedThenContextRefCountShouldBeIncrementedNextDecremented) { MockContext context((ClDevice *)devices[0]); EXPECT_EQ(1, context.getRefInternalCount()); auto cmdQ = new MockCommandQueue(&context, (ClDevice *)devices[0], 0); EXPECT_EQ(2, context.getRefInternalCount()); delete cmdQ; EXPECT_EQ(1, context.getRefInternalCount()); } TEST_F(ContextTest, givenDeviceCmdQueueWithContextWhenBeingCreatedNextDeletedThenContextRefCountShouldBeIncrementedNextDecremented) { REQUIRE_DEVICE_ENQUEUE_OR_SKIP(context); MockContext context((ClDevice *)devices[0]); EXPECT_EQ(1, context.getRefInternalCount()); cl_queue_properties properties = 0; auto cmdQ = new DeviceQueue(&context, (ClDevice *)devices[0], properties); EXPECT_EQ(2, context.getRefInternalCount()); delete cmdQ; EXPECT_EQ(1, context.getRefInternalCount()); } TEST_F(ContextTest, givenDefaultDeviceCmdQueueWithContextWhenBeingCreatedNextDeletedThenContextRefCountShouldBeIncrementedNextDecremented) { REQUIRE_DEVICE_ENQUEUE_OR_SKIP(context); MockContext context((ClDevice *)devices[0]); EXPECT_EQ(1, context.getRefInternalCount()); cl_queue_properties properties = 0; auto cmdQ = new DeviceQueue(&context, (ClDevice *)devices[0], properties); context.setDefaultDeviceQueue(cmdQ); EXPECT_EQ(2, context.getRefInternalCount()); delete cmdQ; EXPECT_EQ(1, context.getRefInternalCount()); } TEST_F(ContextTest, givenContextWhenItIsCreatedFromDeviceThenItAddsRefCountToThisDevice) { auto device = castToObject(devices[0]); EXPECT_EQ(2, device->getRefInternalCount()); cl_device_id deviceID = devices[0]; std::unique_ptr context(Context::create(0, ClDeviceVector(&deviceID, 1), nullptr, nullptr, retVal)); EXPECT_EQ(3, device->getRefInternalCount()); context.reset(nullptr); EXPECT_EQ(2, device->getRefInternalCount()); } TEST_F(ContextTest, givenContextWhenItIsCreatedFromMultipleDevicesThenItAddsRefCountToThoseDevices) { auto device = castToObject(devices[0]); EXPECT_EQ(2, device->getRefInternalCount()); ClDeviceVector devicesVector; devicesVector.push_back(device); devicesVector.push_back(device); std::unique_ptr context(Context::create(0, devicesVector, nullptr, nullptr, retVal)); EXPECT_EQ(4, device->getRefInternalCount()); context.reset(nullptr); EXPECT_EQ(2, device->getRefInternalCount()); } TEST_F(ContextTest, givenSpecialCmdQueueWithContextWhenBeingCreatedNextAutoDeletedThenContextRefCountShouldNeitherBeIncrementedNorNextDecremented) { MockContext context((ClDevice *)devices[0], true); EXPECT_EQ(1, context.getRefInternalCount()); auto cmdQ = new MockCommandQueue(&context, (ClDevice *)devices[0], 0); context.overrideSpecialQueueAndDecrementRefCount(cmdQ); EXPECT_EQ(1, context.getRefInternalCount()); //special queue is to be deleted implicitly by context } TEST_F(ContextTest, givenSpecialCmdQueueWithContextWhenBeingCreatedNextDeletedThenContextRefCountShouldNeitherBeIncrementedNorNextDecremented) { MockContext context((ClDevice *)devices[0], true); EXPECT_EQ(1, context.getRefInternalCount()); auto cmdQ = new MockCommandQueue(&context, (ClDevice *)devices[0], 0); context.overrideSpecialQueueAndDecrementRefCount(cmdQ); EXPECT_EQ(1, context.getRefInternalCount()); delete cmdQ; EXPECT_EQ(1, context.getRefInternalCount()); context.setSpecialQueue(nullptr); } TEST_F(ContextTest, GivenInteropSyncParamWhenCreateContextThenSetContextParam) { cl_device_id deviceID = devices[0]; auto pPlatform = NEO::platform(); cl_platform_id pid[1]; pid[0] = pPlatform; cl_context_properties validProperties[5] = {CL_CONTEXT_PLATFORM, (cl_context_properties)pid[0], CL_CONTEXT_INTEROP_USER_SYNC, 1, 0}; cl_int retVal = CL_SUCCESS; auto context = Context::create(validProperties, ClDeviceVector(&deviceID, 1), nullptr, nullptr, retVal); EXPECT_EQ(CL_SUCCESS, retVal); EXPECT_NE(nullptr, context); EXPECT_TRUE(context->getInteropUserSyncEnabled()); delete context; validProperties[3] = 0; // false context = Context::create(validProperties, ClDeviceVector(&deviceID, 1), nullptr, nullptr, retVal); EXPECT_EQ(CL_SUCCESS, retVal); EXPECT_NE(nullptr, context); EXPECT_FALSE(context->getInteropUserSyncEnabled()); delete context; } class MockSharingFunctions : public SharingFunctions { public: uint32_t getId() const override { return sharingId; } static const uint32_t sharingId = 0; }; TEST_F(ContextTest, givenContextWhenSharingTableEmptyThenReturnsNullptr) { MockContext context; context.clearSharingFunctions(); auto *sharingF = context.getSharing(); EXPECT_EQ(sharingF, nullptr); } TEST_F(ContextTest, givenNullptrWhenRegisteringSharingToContextThenAbortExecution) { MockContext context; context.clearSharingFunctions(); EXPECT_THROW(context.registerSharing(nullptr), std::exception); } TEST_F(ContextTest, givenContextWhenSharingTableIsNotEmptyThenReturnsSharingFunctionPointer) { MockContext context; MockSharingFunctions *sharingFunctions = new MockSharingFunctions; context.registerSharing(sharingFunctions); auto *sharingF = context.getSharing(); EXPECT_EQ(sharingF, sharingFunctions); } TEST(Context, givenFtrSvmFalseWhenContextIsCreatedThenSVMAllocsManagerIsNotCreated) { ExecutionEnvironment *executionEnvironment = platform()->peekExecutionEnvironment(); executionEnvironment->prepareRootDeviceEnvironments(1u); auto hwInfo = executionEnvironment->rootDeviceEnvironments[0]->getMutableHardwareInfo(); hwInfo->capabilityTable.ftrSvm = false; auto device = std::make_unique(MockDevice::createWithExecutionEnvironment(hwInfo, executionEnvironment, 0)); cl_device_id clDevice = device.get(); cl_int retVal = CL_SUCCESS; auto context = std::unique_ptr(Context::create(nullptr, ClDeviceVector(&clDevice, 1), nullptr, nullptr, retVal)); ASSERT_NE(nullptr, context); auto svmManager = context->getSVMAllocsManager(); EXPECT_EQ(nullptr, svmManager); } TEST(Context, whenCreateContextThenSpecialQueueUsesInternalEngine) { auto device = std::make_unique(MockDevice::createWithNewExecutionEnvironment(defaultHwInfo.get())); cl_device_id clDevice = device.get(); cl_int retVal = CL_SUCCESS; auto context = std::unique_ptr(Context::create(nullptr, ClDeviceVector(&clDevice, 1), nullptr, nullptr, retVal)); ASSERT_NE(nullptr, context); EXPECT_EQ(CL_SUCCESS, retVal); auto specialQueueEngine = context->getSpecialQueue()->getGpgpuEngine(); auto internalEngine = device->getInternalEngine(); EXPECT_EQ(internalEngine.commandStreamReceiver, specialQueueEngine.commandStreamReceiver); } TEST(MultiDeviceContextTest, givenContextWithMultipleDevicesWhenGettingTotalNumberOfDevicesThenNumberOfAllAvailableDevicesIsReturned) { DebugManagerStateRestore restorer; const uint32_t numRootDevices = 1u; const uint32_t numSubDevices = 3u; DebugManager.flags.CreateMultipleSubDevices.set(numSubDevices); initPlatform(); auto device = platform()->getClDevice(0); cl_device_id clDevice = device; ClDeviceVector deviceVector(&clDevice, numRootDevices); cl_int retVal = CL_OUT_OF_HOST_MEMORY; auto context = std::unique_ptr(Context::create(nullptr, deviceVector, nullptr, nullptr, retVal)); EXPECT_EQ(CL_SUCCESS, retVal); EXPECT_EQ(numSubDevices, device->getNumAvailableDevices()); EXPECT_EQ(numRootDevices, context->getNumDevices()); EXPECT_EQ(numRootDevices * numSubDevices, context->getTotalNumDevices()); } class ContextWithAsyncDeleterTest : public ::testing::WithParamInterface, public ::testing::Test { public: void SetUp() override { memoryManager = new MockMemoryManager(); device = new MockClDevice{MockDevice::createWithNewExecutionEnvironment(defaultHwInfo.get())}; deleter = new MockDeferredDeleter(); device->injectMemoryManager(memoryManager); memoryManager->setDeferredDeleter(deleter); } void TearDown() override { delete device; } Context *context; MockMemoryManager *memoryManager; MockDeferredDeleter *deleter; MockClDevice *device; }; TEST_P(ContextWithAsyncDeleterTest, givenContextWithMemoryManagerWhenAsyncDeleterIsEnabledThenUsesDeletersMethods) { cl_device_id clDevice = device; cl_int retVal; ClDeviceVector deviceVector(&clDevice, 1); bool asyncDeleterEnabled = GetParam(); memoryManager->overrideAsyncDeleterFlag(asyncDeleterEnabled); EXPECT_EQ(0, deleter->getClientsNum()); context = Context::create(0, deviceVector, nullptr, nullptr, retVal); if (asyncDeleterEnabled) { EXPECT_EQ(1, deleter->getClientsNum()); } else { EXPECT_EQ(0, deleter->getClientsNum()); } delete context; EXPECT_EQ(0, deleter->getClientsNum()); } INSTANTIATE_TEST_CASE_P(ContextTests, ContextWithAsyncDeleterTest, ::testing::Bool()); TEST(DefaultContext, givenDefaultContextWhenItIsQueriedForTypeThenDefaultTypeIsReturned) { MockContext context; EXPECT_EQ(ContextType::CONTEXT_TYPE_DEFAULT, context.peekContextType()); } TEST(Context, givenContextWhenCheckIfAllocationsAreMultiStorageThenReturnProperValueAccordingToContextType) { MockContext context; EXPECT_TRUE(context.areMultiStorageAllocationsPreferred()); context.contextType = ContextType::CONTEXT_TYPE_SPECIALIZED; EXPECT_FALSE(context.areMultiStorageAllocationsPreferred()); context.contextType = ContextType::CONTEXT_TYPE_UNRESTRICTIVE; EXPECT_TRUE(context.areMultiStorageAllocationsPreferred()); } TEST(Context, givenContextWhenIsDeviceAssociatedIsCalledWithItsDeviceThenTrueIsReturned) { MockContext context; EXPECT_TRUE(context.isDeviceAssociated(*context.getDevice(0))); } TEST(Context, givenContextWhenIsDeviceAssociatedIsCalledWithNotAssociatedDeviceThenFalseIsReturned) { MockContext context0; MockContext context1; EXPECT_FALSE(context0.isDeviceAssociated(*context1.getDevice(0))); EXPECT_FALSE(context1.isDeviceAssociated(*context0.getDevice(0))); } TEST(Context, givenContextWithSingleDevicesWhenGettingDeviceBitfieldForAllocationThenDeviceBitfieldForDeviceIsReturned) { UltClDeviceFactory deviceFactory{1, 3}; auto device = deviceFactory.subDevices[1]; auto expectedDeviceBitfield = device->getDeviceBitfield(); MockContext context(device); EXPECT_EQ(expectedDeviceBitfield.to_ulong(), context.getDeviceBitfieldForAllocation().to_ulong()); } TEST(Context, givenContextWithMultipleSubDevicesWhenGettingDeviceBitfieldForAllocationThenMergedDeviceBitfieldIsReturned) { UltClDeviceFactory deviceFactory{1, 3}; cl_int retVal; cl_device_id devices[]{deviceFactory.subDevices[0], deviceFactory.subDevices[2]}; ClDeviceVector deviceVector(devices, 2); auto expectedDeviceBitfield = deviceFactory.subDevices[0]->getDeviceBitfield() | deviceFactory.subDevices[2]->getDeviceBitfield(); auto context = Context::create(0, deviceVector, nullptr, nullptr, retVal); EXPECT_NE(nullptr, context); EXPECT_EQ(CL_SUCCESS, retVal); EXPECT_EQ(expectedDeviceBitfield.to_ulong(), context->getDeviceBitfieldForAllocation().to_ulong()); context->release(); }