compute-runtime/unit_tests/os_interface/debug_settings_manager_test...

903 lines
34 KiB
C++

/*
* Copyright (c) 2017-2018, Intel Corporation
*
* Permission is hereby granted, free of charge, to any person obtaining a
* copy of this software and associated documentation files (the "Software"),
* to deal in the Software without restriction, including without limitation
* the rights to use, copy, modify, merge, publish, distribute, sublicense,
* and/or sell copies of the Software, and to permit persons to whom the
* Software is furnished to do so, subject to the following conditions:
*
* The above copyright notice and this permission notice shall be included
* in all copies or substantial portions of the Software.
*
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
* OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
* FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
* THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR
* OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
* ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
* OTHER DEALINGS IN THE SOFTWARE.
*/
#include "test.h"
#include "gtest/gtest.h"
#include "runtime/helpers/file_io.h"
#include "runtime/helpers/string_helpers.h"
#include "runtime/os_interface/debug_settings_manager.h"
#include "runtime/utilities/directory.h"
#include "unit_tests/mocks/mock_kernel.h"
#include "unit_tests/mocks/mock_program.h"
#include "unit_tests/mocks/mock_buffer.h"
#include "unit_tests/mocks/mock_context.h"
#include "unit_tests/mocks/mock_mdi.h"
#include "unit_tests/fixtures/buffer_fixture.h"
#include "unit_tests/fixtures/image_fixture.h"
#include "unit_tests/helpers/memory_management.h"
#include <memory>
#include <string>
#include <sstream>
#include <cstdio>
using namespace OCLRT;
using namespace std;
#undef DECLARE_DEBUG_VARIABLE
class SettingsFileCreator {
public:
SettingsFileCreator(string &content) {
bool settingsFileExists = fileExists(fileName);
if (settingsFileExists) {
remove(fileName.c_str());
}
writeDataToFile(fileName.c_str(), content.c_str(), content.size());
};
~SettingsFileCreator() {
remove(fileName.c_str());
};
private:
string fileName = "igdrcl.config";
};
class TestDebugFlagsChecker {
public:
static bool isEqual(int32_t returnedValue, bool defaultValue) {
if (returnedValue == 0) {
return !defaultValue;
} else {
return defaultValue;
}
}
static bool isEqual(int32_t returnedValue, int32_t defaultValue) {
return returnedValue == defaultValue;
}
static bool isEqual(string returnedValue, string defaultValue) {
return returnedValue == defaultValue;
}
};
template <DebugFunctionalityLevel DebugLevel>
class TestDebugSettingsManager : public DebugSettingsManager<DebugLevel> {
public:
~TestDebugSettingsManager() {
remove(DebugSettingsManager<DebugLevel>::logFileName.c_str());
}
SettingsReader *getSettingsReader() {
return DebugSettingsManager<DebugLevel>::readerImpl;
}
void useRealFiles(bool value) {
mockFileSystem = !value;
}
void writeToFile(std::string filename,
const char *str,
size_t length,
std::ios_base::openmode mode) override {
savedFiles[filename] << std::string(str, str + length);
if (mockFileSystem == false) {
DebugSettingsManager<DebugLevel>::writeToFile(filename, str, length, mode);
}
};
int32_t createdFilesCount() {
return static_cast<int32_t>(savedFiles.size());
}
bool wasFileCreated(std::string filename) {
return savedFiles.find(filename) != savedFiles.end();
}
std::string getFileString(std::string filename) {
return savedFiles[filename].str();
}
protected:
bool mockFileSystem = true;
std::map<std::string, std::stringstream> savedFiles;
};
template <bool DebugFunctionality>
class TestDebugSettingsApiEnterWrapper : public DebugSettingsApiEnterWrapper<DebugFunctionality> {
public:
TestDebugSettingsApiEnterWrapper(const char *functionName, int *errCode) : DebugSettingsApiEnterWrapper<DebugFunctionality>(functionName, errCode), loggedEnter(false) {
if (DebugFunctionality) {
loggedEnter = true;
}
}
bool loggedEnter;
};
using FullyEnabledTestDebugManager = TestDebugSettingsManager<DebugFunctionalityLevel::Full>;
using FullyDisabledTestDebugManager = TestDebugSettingsManager<DebugFunctionalityLevel::None>;
TEST(DebugSettingsManager, WithDebugFunctionality) {
FullyEnabledTestDebugManager debugManager;
EXPECT_FALSE(debugManager.disabled());
EXPECT_EQ(nullptr, debugManager.injectFcn);
}
TEST(DebugSettingsManager, WithDebugFunctionalityHasSettingsReader) {
FullyEnabledTestDebugManager debugManager;
// SettingsReader created
EXPECT_NE(nullptr, debugManager.getSettingsReader());
}
TEST(DebugSettingsManager, WithDebugFunctionalityCreatesAndDumpsToLogFile) {
string settings = "LogApiCalls = 1";
SettingsFileCreator settingsFile(settings);
FullyEnabledTestDebugManager debugManager;
debugManager.logApiCall("searchString", true, 0);
debugManager.logApiCall("searchString2", false, 0);
debugManager.logInputs("searchString3", "any");
debugManager.logInputs("searchString3", "any", "and more");
debugManager.log(false, "searchString4");
// Log file not created
EXPECT_TRUE(debugManager.wasFileCreated(debugManager.getLogFileName()));
if (debugManager.wasFileCreated(debugManager.getLogFileName())) {
auto str = debugManager.getFileString(debugManager.getLogFileName());
EXPECT_TRUE(str.find("searchString") != std::string::npos);
EXPECT_TRUE(str.find("searchString2") != std::string::npos);
EXPECT_TRUE(str.find("searchString3") != std::string::npos);
EXPECT_FALSE(str.find("searchString4") != std::string::npos);
}
debugManager.log(true, "searchString4");
if (debugManager.wasFileCreated(debugManager.getLogFileName())) {
auto str = debugManager.getFileString(debugManager.getLogFileName());
EXPECT_TRUE(str.find("searchString4") != std::string::npos);
}
}
TEST(DebugSettingsManager, WithoutDebugFunctionalityDoesNotCreateLogFile) {
string settings = "LogApiCalls = 1";
SettingsFileCreator settingsFile(settings);
FullyDisabledTestDebugManager debugManager;
debugManager.setLogFileName(" ");
// Log file not created
bool logFileCreated = fileExists(debugManager.getLogFileName());
EXPECT_FALSE(logFileCreated);
debugManager.logApiCall("searchString", true, 0);
debugManager.logApiCall("searchString2", false, 0);
debugManager.logInputs("searchString3", "any");
debugManager.logInputs("searchString3", "any", "and more");
debugManager.log(false, "searchString4");
EXPECT_FALSE(debugManager.wasFileCreated(debugManager.getLogFileName()));
}
TEST(DebugSettingsManager, WithIncorrectFilenameFileNotCreated) {
FullyEnabledTestDebugManager debugManager;
debugManager.useRealFiles(true);
debugManager.writeToFile("", "", 0, std::ios_base::in | std::ios_base::out);
}
TEST(DebugSettingsManager, WithCorrectFilenameFileCreated) {
std::string testFile = "testfile";
FullyEnabledTestDebugManager debugManager;
debugManager.useRealFiles(true);
debugManager.writeToFile(testFile, "test", 4, std::fstream::out);
EXPECT_TRUE(fileExists(testFile));
if (fileExists(testFile)) {
std::remove(testFile.c_str());
}
}
TEST(DebugSettingsManager, CreatingNewInstanceRemovesOldFile) {
FullyEnabledTestDebugManager debugManager;
debugManager.useRealFiles(true);
debugManager.writeToFile(debugManager.getLogFileName(), "test", 4, std::fstream::out);
EXPECT_TRUE(fileExists(debugManager.getLogFileName()));
FullyEnabledTestDebugManager debugManager2;
EXPECT_FALSE(fileExists(debugManager.getLogFileName()));
}
TEST(DebugSettingsManager, WithDebugFunctionalityDoesNotDumpApiCallLogWhenFlagIsFalseButDumpsCustomLogs) {
FullyEnabledTestDebugManager debugManager;
// Log file not created
bool logFileCreated = fileExists(debugManager.getLogFileName());
EXPECT_FALSE(logFileCreated);
debugManager.flags.LogApiCalls.set(false);
debugManager.logApiCall("searchString", true, 0);
debugManager.logApiCall("searchString2", false, 0);
debugManager.logInputs("searchString3", "any");
debugManager.logInputs("searchString3", "any", "and more");
debugManager.log(false, "searchString4");
if (debugManager.wasFileCreated(debugManager.getLogFileName())) {
auto str = debugManager.getFileString(debugManager.getLogFileName());
EXPECT_FALSE(str.find("searchString") != std::string::npos);
EXPECT_FALSE(str.find("searchString2") != std::string::npos);
EXPECT_FALSE(str.find("searchString3") != std::string::npos);
EXPECT_FALSE(str.find("searchString4") != std::string::npos);
}
// Log still works
debugManager.log(true, "searchString4");
if (debugManager.wasFileCreated(debugManager.getLogFileName())) {
auto str = debugManager.getFileString(debugManager.getLogFileName());
EXPECT_TRUE(str.find("searchString4") != std::string::npos);
}
}
TEST(DebugSettingsManager, WithDebugFunctionalityGetInputReturnsCorectValue) {
FullyEnabledTestDebugManager debugManager;
// getInput returns 0
size_t input = 5;
size_t output = debugManager.getInput(&input, 0);
EXPECT_EQ(input, output);
}
TEST(DebugSettingsManager, WithDebugFunctionalityGetInputNegative) {
FullyEnabledTestDebugManager debugManager;
// getInput returns 0
size_t output = debugManager.getInput(nullptr, 2);
EXPECT_EQ(0u, output);
}
TEST(DebugSettingsManager, WithDebugFunctionalityGetSizesReturnsCorectString) {
FullyEnabledTestDebugManager debugManager;
debugManager.flags.LogApiCalls.set(true);
// getSizes returns string
uintptr_t input[3] = {1, 2, 3};
string lwsSizes = debugManager.getSizes(input, 3, true);
string gwsSizes = debugManager.getSizes(input, 3, false);
string lwsExpected = "localWorkSize[0]: \t1\nlocalWorkSize[1]: \t2\nlocalWorkSize[2]: \t3\n";
string gwsExpected = "globalWorkSize[0]: \t1\nglobalWorkSize[1]: \t2\nglobalWorkSize[2]: \t3\n";
EXPECT_EQ(lwsExpected, lwsSizes);
EXPECT_EQ(gwsExpected, gwsSizes);
}
TEST(DebugSettingsManager, WithDebugFunctionalityGetSizesNegative) {
FullyEnabledTestDebugManager debugManager;
debugManager.flags.LogApiCalls.set(true);
// getSizes returns string
string lwsSizes = debugManager.getSizes(nullptr, 3, true);
string gwsSizes = debugManager.getSizes(nullptr, 3, false);
EXPECT_EQ(0u, lwsSizes.size());
EXPECT_EQ(0u, gwsSizes.size());
}
TEST(DebugSettingsManager, WithoutDebugFunctionalityGetSizesDoesNotReturnString) {
FullyDisabledTestDebugManager debugManager;
debugManager.flags.LogApiCalls.set(true);
uintptr_t input[3] = {1, 2, 3};
string lwsSizes = debugManager.getSizes(input, 3, true);
string gwsSizes = debugManager.getSizes(input, 3, false);
EXPECT_EQ(0u, lwsSizes.size());
EXPECT_EQ(0u, gwsSizes.size());
}
TEST(DebugSettingsManager, WithDebugFunctionalityGetEventsReturnsCorectString) {
FullyEnabledTestDebugManager debugManager;
debugManager.flags.LogApiCalls.set(true);
// getEvents returns string
uintptr_t event = 8;
uintptr_t *input[3] = {&event, &event, &event};
string eventsString = debugManager.getEvents((uintptr_t *)input, 2);
EXPECT_NE(0u, eventsString.size());
}
TEST(DebugSettingsManager, WithDebugFunctionalityGetEventsNegative) {
FullyEnabledTestDebugManager debugManager;
// getEvents returns 0 sized string
string event = debugManager.getEvents(nullptr, 2);
EXPECT_EQ(0u, event.size());
}
TEST(DebugSettingsManager, WithDebugFunctionalityDumpKernel) {
FullyEnabledTestDebugManager debugManager;
string kernelDumpFile = "testDumpKernel";
// test kernel dumping
debugManager.flags.DumpKernels.set(true);
debugManager.dumpKernel(kernelDumpFile, "kernel source here");
debugManager.flags.DumpKernels.set(false);
EXPECT_TRUE(debugManager.wasFileCreated(kernelDumpFile.append(".txt")));
}
TEST(DebugSettingsManager, WithoutDebugFunctionalityDumpKernel) {
FullyEnabledTestDebugManager debugManager;
string kernelDumpFile = "testDumpKernel";
// test kernel dumping
debugManager.flags.DumpKernels.set(false);
debugManager.dumpKernel(kernelDumpFile, "kernel source here");
debugManager.flags.DumpKernels.set(false);
EXPECT_FALSE(debugManager.wasFileCreated(kernelDumpFile.append(".txt")));
}
TEST(DebugSettingsManager, WithDebugFunctionalityDumpBinary) {
FullyEnabledTestDebugManager debugManager;
debugManager.flags.DumpKernels.set(true);
string programDumpFile = "programBinary.bin";
size_t length = 4;
unsigned char binary[4];
const unsigned char *ptrBinary = binary;
debugManager.dumpBinaryProgram(1, &length, &ptrBinary);
debugManager.flags.DumpKernels.set(false);
EXPECT_TRUE(debugManager.wasFileCreated(programDumpFile));
}
TEST(DebugSettingsManager, WithDebugFunctionalityDumpNullBinary) {
FullyEnabledTestDebugManager debugManager;
debugManager.flags.DumpKernels.set(true);
string programDumpFile = "programBinary.bin";
size_t length = 4;
debugManager.dumpBinaryProgram(1, &length, nullptr);
debugManager.flags.DumpKernels.set(false);
EXPECT_FALSE(debugManager.wasFileCreated(programDumpFile));
}
TEST(DebugSettingsManager, WithDebugFunctionalityDontDumpKernelsForNullMdi) {
FullyEnabledTestDebugManager debugManager;
debugManager.flags.DumpKernels.set(true);
debugManager.dumpKernelArgs((const MultiDispatchInfo *)nullptr);
debugManager.flags.DumpKernels.set(false);
EXPECT_EQ(debugManager.createdFilesCount(), 0);
}
TEST(DebugSettingsManager, WithDebugFunctionalityDontDumpKernelArgsForNullMdi) {
FullyEnabledTestDebugManager debugManager;
debugManager.flags.DumpKernelArgs.set(true);
debugManager.dumpKernelArgs((const MultiDispatchInfo *)nullptr);
debugManager.flags.DumpKernelArgs.set(false);
EXPECT_EQ(debugManager.createdFilesCount(), 0);
}
TEST(DebugSettingsManager, WithDebugFunctionalityDumpKernelArgsForMdi) {
MockProgram program;
auto kernelInfo = unique_ptr<KernelInfo>(KernelInfo::create());
auto device = unique_ptr<Device>(Device::create<OCLRT::Device>(nullptr, false));
auto kernel = unique_ptr<MockKernel>(new MockKernel(&program, *kernelInfo, *device));
auto multiDispatchInfo = unique_ptr<MockMultiDispatchInfo>(new MockMultiDispatchInfo(kernel.get()));
KernelArgPatchInfo kernelArgPatchInfo;
kernelArgPatchInfo.size = 32;
kernelArgPatchInfo.sourceOffset = 0;
kernelArgPatchInfo.crossthreadOffset = 32;
kernelInfo->kernelArgInfo.resize(1);
kernelInfo->kernelArgInfo[0].kernelArgPatchInfoVector.push_back(kernelArgPatchInfo);
size_t crossThreadDataSize = 64;
auto crossThreadData = unique_ptr<uint8_t>(new uint8_t[crossThreadDataSize]);
kernel->setCrossThreadData(crossThreadData.get(), static_cast<uint32_t>(crossThreadDataSize));
FullyEnabledTestDebugManager debugManager;
debugManager.flags.DumpKernelArgs.set(true);
debugManager.dumpKernelArgs(multiDispatchInfo.get());
debugManager.flags.DumpKernelArgs.set(false);
// check if file was created
std::string expectedFile = "_arg_0_immediate_size_32_flags_0.bin";
EXPECT_TRUE(debugManager.wasFileCreated(expectedFile));
// no files should be created for local buffer
EXPECT_EQ(debugManager.createdFilesCount(), 1);
}
TEST(DebugSettingsManager, WithDebugFunctionalityDumpKernelNullKernel) {
FullyEnabledTestDebugManager debugManager;
debugManager.flags.DumpKernels.set(true);
debugManager.dumpKernelArgs((const Kernel *)nullptr);
debugManager.flags.DumpKernels.set(false);
EXPECT_EQ(debugManager.createdFilesCount(), 0);
}
TEST(DebugSettingsManager, WithDebugFunctionalityAndEmptyKernelDontDumpKernelArgs) {
MockProgram program;
auto kernelInfo = unique_ptr<KernelInfo>(KernelInfo::create());
auto device = unique_ptr<Device>(Device::create<OCLRT::Device>(nullptr, false));
auto kernel = unique_ptr<MockKernel>(new MockKernel(&program, *kernelInfo, *device));
FullyEnabledTestDebugManager debugManager;
debugManager.flags.DumpKernelArgs.set(true);
debugManager.dumpKernelArgs(kernel.get());
debugManager.flags.DumpKernelArgs.set(false);
EXPECT_EQ(debugManager.createdFilesCount(), 0);
}
TEST(DebugSettingsManager, WithDebugFunctionalityDumpKernelArgsImmediate) {
MockProgram program;
auto kernelInfo = unique_ptr<KernelInfo>(KernelInfo::create());
auto device = unique_ptr<Device>(Device::create<OCLRT::Device>(nullptr, false));
auto kernel = unique_ptr<MockKernel>(new MockKernel(&program, *kernelInfo, *device));
KernelArgPatchInfo kernelArgPatchInfo;
kernelArgPatchInfo.size = 32;
kernelArgPatchInfo.sourceOffset = 0;
kernelArgPatchInfo.crossthreadOffset = 32;
kernelInfo->kernelArgInfo.resize(1);
kernelInfo->kernelArgInfo[0].kernelArgPatchInfoVector.push_back(kernelArgPatchInfo);
size_t crossThreadDataSize = 64;
auto crossThreadData = unique_ptr<uint8_t>(new uint8_t[crossThreadDataSize]);
kernel->setCrossThreadData(crossThreadData.get(), static_cast<uint32_t>(crossThreadDataSize));
FullyEnabledTestDebugManager debugManager;
debugManager.flags.DumpKernelArgs.set(true);
debugManager.dumpKernelArgs(kernel.get());
debugManager.flags.DumpKernelArgs.set(false);
// check if file was created
EXPECT_TRUE(debugManager.wasFileCreated("_arg_0_immediate_size_32_flags_0.bin"));
// no files should be created for local buffer
EXPECT_EQ(debugManager.createdFilesCount(), 1);
}
TEST(DebugSettingsManager, WithDebugFunctionalityDumpKernelArgsImmediateZeroSize) {
MockProgram program;
auto kernelInfo = unique_ptr<KernelInfo>(KernelInfo::create());
auto device = unique_ptr<Device>(Device::create<OCLRT::Device>(nullptr, false));
auto kernel = unique_ptr<MockKernel>(new MockKernel(&program, *kernelInfo, *device));
KernelArgPatchInfo kernelArgPatchInfo;
kernelArgPatchInfo.size = 0;
kernelArgPatchInfo.sourceOffset = 0;
kernelArgPatchInfo.crossthreadOffset = 32;
kernelInfo->kernelArgInfo.resize(1);
kernelInfo->kernelArgInfo[0].kernelArgPatchInfoVector.push_back(kernelArgPatchInfo);
size_t crossThreadDataSize = sizeof(64);
auto crossThreadData = unique_ptr<uint8_t>(new uint8_t[crossThreadDataSize]);
kernel->setCrossThreadData(crossThreadData.get(), static_cast<uint32_t>(crossThreadDataSize));
FullyEnabledTestDebugManager debugManager;
debugManager.flags.DumpKernelArgs.set(true);
debugManager.dumpKernelArgs(kernel.get());
debugManager.flags.DumpKernelArgs.set(false);
// no files should be created for zero size
EXPECT_EQ(debugManager.createdFilesCount(), 0);
}
TEST(DebugSettingsManager, WithDebugFunctionalityDumpKernelArgsLocalBuffer) {
MockProgram program;
auto kernelInfo = unique_ptr<KernelInfo>(KernelInfo::create());
auto device = unique_ptr<Device>(Device::create<OCLRT::Device>(nullptr, false));
auto kernel = unique_ptr<MockKernel>(new MockKernel(&program, *kernelInfo, *device));
KernelArgPatchInfo kernelArgPatchInfo;
kernelInfo->kernelArgInfo.resize(1);
kernelInfo->kernelArgInfo[0].kernelArgPatchInfoVector.push_back(kernelArgPatchInfo);
kernelInfo->kernelArgInfo[0].addressQualifier = static_cast<cl_kernel_arg_address_qualifier>(CL_KERNEL_ARG_ADDRESS_LOCAL);
FullyEnabledTestDebugManager debugManager;
debugManager.flags.DumpKernelArgs.set(true);
debugManager.dumpKernelArgs(kernel.get());
debugManager.flags.DumpKernelArgs.set(false);
// no files should be created for local buffer
EXPECT_EQ(debugManager.createdFilesCount(), 0);
}
TEST(DebugSettingsManager, WithDebugFunctionalityDumpKernelArgsBufferNotSet) {
MockProgram program;
auto kernelInfo = unique_ptr<KernelInfo>(KernelInfo::create());
auto device = unique_ptr<Device>(Device::create<OCLRT::Device>(nullptr, false));
auto kernel = unique_ptr<MockKernel>(new MockKernel(&program, *kernelInfo, *device));
KernelArgPatchInfo kernelArgPatchInfo;
kernelInfo->kernelArgInfo.resize(1);
kernelInfo->kernelArgInfo[0].kernelArgPatchInfoVector.push_back(kernelArgPatchInfo);
kernelInfo->kernelArgInfo[0].typeStr = "uint8 *buffer";
kernel->initialize();
size_t crossThreadDataSize = sizeof(void *);
auto crossThreadData = unique_ptr<uint8_t>(new uint8_t[crossThreadDataSize]);
kernel->setCrossThreadData(crossThreadData.get(), static_cast<uint32_t>(crossThreadDataSize));
FullyEnabledTestDebugManager debugManager;
debugManager.flags.DumpKernelArgs.set(true);
debugManager.dumpKernelArgs(kernel.get());
debugManager.flags.DumpKernelArgs.set(false);
// no files should be created for local buffer
EXPECT_EQ(debugManager.createdFilesCount(), 0);
}
TEST(DebugSettingsManager, WithDebugFunctionalityDumpKernelArgsBuffer) {
MockContext context;
auto buffer = BufferHelper<>::create(&context);
cl_mem clObj = buffer;
MockProgram program(&context, false);
auto kernelInfo = unique_ptr<KernelInfo>(KernelInfo::create());
auto device = unique_ptr<Device>(Device::create<OCLRT::Device>(nullptr, false));
auto kernel = unique_ptr<MockKernel>(new MockKernel(&program, *kernelInfo, *device));
KernelArgPatchInfo kernelArgPatchInfo;
kernelInfo->kernelArgInfo.resize(1);
kernelInfo->kernelArgInfo[0].kernelArgPatchInfoVector.push_back(kernelArgPatchInfo);
kernelInfo->kernelArgInfo[0].typeStr = "uint8 *buffer";
kernel->initialize();
size_t crossThreadDataSize = sizeof(void *);
auto crossThreadData = unique_ptr<uint8_t>(new uint8_t[crossThreadDataSize]);
kernel->setCrossThreadData(crossThreadData.get(), static_cast<uint32_t>(crossThreadDataSize));
kernel->setArg(0, clObj);
FullyEnabledTestDebugManager debugManager;
debugManager.flags.DumpKernelArgs.set(true);
debugManager.dumpKernelArgs(kernel.get());
debugManager.flags.DumpKernelArgs.set(false);
buffer->release();
// check if file was created
EXPECT_TRUE(debugManager.wasFileCreated("_arg_0_buffer_size_16_flags_1.bin"));
// no files should be created for local buffer
EXPECT_EQ(debugManager.createdFilesCount(), 1);
}
TEST(DebugSettingsManager, WithDebugFunctionalityDumpKernelArgsSampler) {
MockProgram program;
auto kernelInfo = unique_ptr<KernelInfo>(KernelInfo::create());
auto device = unique_ptr<Device>(Device::create<OCLRT::Device>(nullptr, false));
auto kernel = unique_ptr<MockKernel>(new MockKernel(&program, *kernelInfo, *device));
KernelArgPatchInfo kernelArgPatchInfo;
kernelInfo->kernelArgInfo.resize(1);
kernelInfo->kernelArgInfo[0].kernelArgPatchInfoVector.push_back(kernelArgPatchInfo);
kernelInfo->kernelArgInfo[0].typeStr = "sampler test";
kernel->initialize();
FullyEnabledTestDebugManager debugManager;
debugManager.flags.DumpKernelArgs.set(true);
debugManager.dumpKernelArgs(kernel.get());
debugManager.flags.DumpKernelArgs.set(false);
// no files should be created for sampler arg
EXPECT_EQ(debugManager.createdFilesCount(), 0);
}
TEST(DebugSettingsManager, WithDebugFunctionalityDumpKernelArgsImageNotSet) {
MockProgram program;
auto kernelInfo = unique_ptr<KernelInfo>(KernelInfo::create());
auto device = unique_ptr<Device>(Device::create<OCLRT::Device>(nullptr, false));
auto kernel = unique_ptr<MockKernel>(new MockKernel(&program, *kernelInfo, *device));
SKernelBinaryHeaderCommon kernelHeader;
char surfaceStateHeap[0x80];
kernelHeader.SurfaceStateHeapSize = sizeof(surfaceStateHeap);
kernelInfo->heapInfo.pSsh = surfaceStateHeap;
kernelInfo->heapInfo.pKernelHeader = &kernelHeader;
kernelInfo->usesSsh = true;
KernelArgPatchInfo kernelArgPatchInfo;
kernelInfo->kernelArgInfo.resize(1);
kernelInfo->kernelArgInfo[0].kernelArgPatchInfoVector.push_back(kernelArgPatchInfo);
kernelInfo->kernelArgInfo[0].typeStr = "image2d buffer";
kernelInfo->kernelArgInfo[0].isImage = true;
kernelInfo->kernelArgInfo[0].offsetImgWidth = 0x4;
kernel->initialize();
size_t crossThreadDataSize = sizeof(void *);
auto crossThreadData = unique_ptr<uint8_t>(new uint8_t[crossThreadDataSize]);
kernel->setCrossThreadData(crossThreadData.get(), static_cast<uint32_t>(crossThreadDataSize));
FullyEnabledTestDebugManager debugManager;
debugManager.flags.DumpKernelArgs.set(true);
debugManager.dumpKernelArgs(kernel.get());
debugManager.flags.DumpKernelArgs.set(false);
// no files should be created for local buffer
EXPECT_EQ(debugManager.createdFilesCount(), 0);
}
TEST(DebugSettingsManager, WithDebugFunctionalityDumpBinaryNegativeCases) {
FullyEnabledTestDebugManager debugManager;
debugManager.flags.DumpKernels.set(true);
size_t length = 1;
unsigned char binary[4];
const unsigned char *ptrBinary = binary;
debugManager.dumpBinaryProgram(1, nullptr, nullptr);
debugManager.dumpBinaryProgram(1, nullptr, &ptrBinary);
debugManager.dumpBinaryProgram(1, &length, nullptr);
length = 0;
debugManager.dumpBinaryProgram(1, &length, &ptrBinary);
debugManager.dumpBinaryProgram(1, &length, nullptr);
debugManager.flags.DumpKernels.set(false);
EXPECT_EQ(debugManager.createdFilesCount(), 0);
}
TEST(DebugSettingsManager, WithoutDebugFunctionality) {
string path = ".";
vector<string> files = Directory::getFiles(path);
size_t initialNumberOfFiles = files.size();
FullyDisabledTestDebugManager debugManager;
// Should not be enabled without debug functionality
EXPECT_TRUE(debugManager.disabled());
// SettingsReader not created
EXPECT_EQ(nullptr, debugManager.getSettingsReader());
// Log file not created
bool logFileCreated = fileExists(debugManager.getLogFileName());
EXPECT_FALSE(logFileCreated);
// debug variables / flags set to default
#define DECLARE_DEBUG_VARIABLE(dataType, variableName, defaultValue, description) \
{ \
bool isEqual = TestDebugFlagsChecker::isEqual(debugManager.flags.variableName.get(), defaultValue); \
EXPECT_TRUE(isEqual); \
}
#include "runtime/os_interface/DebugVariables.inl"
#undef DECLARE_DEBUG_VARIABLE
// test kernel dumping
bool kernelDumpCreated = false;
string kernelDumpFile = "testDumpKernel";
debugManager.flags.DumpKernels.set(true);
debugManager.dumpKernel(kernelDumpFile, "kernel source here");
debugManager.flags.DumpKernels.set(false);
kernelDumpCreated = fileExists(kernelDumpFile.append(".txt"));
EXPECT_FALSE(kernelDumpCreated);
// test api logging
debugManager.flags.LogApiCalls.set(true);
debugManager.logApiCall(__FUNCTION__, true, 0);
debugManager.flags.LogApiCalls.set(false);
logFileCreated = fileExists(debugManager.getLogFileName());
EXPECT_FALSE(logFileCreated);
// getInput returns 0
size_t input = 5;
size_t output = debugManager.getInput(&input, 0);
EXPECT_EQ(0u, output);
// getEvents returns 0-size string
string event = debugManager.getEvents(&input, 0);
EXPECT_EQ(0u, event.size());
// getSizes returns 0-size string
string lwsSizes = debugManager.getSizes(&input, 0, true);
string gwsSizes = debugManager.getSizes(&input, 0, false);
EXPECT_EQ(0u, lwsSizes.size());
EXPECT_EQ(0u, gwsSizes.size());
// no programDump file
debugManager.flags.DumpKernels.set(true);
string programDumpFile = "programBinary.bin";
size_t length = 4;
unsigned char binary[4];
const unsigned char *ptrBinary = binary;
debugManager.dumpBinaryProgram(1, &length, &ptrBinary);
debugManager.flags.DumpKernels.set(false);
EXPECT_FALSE(debugManager.wasFileCreated(programDumpFile));
debugManager.flags.DumpKernelArgs.set(true);
debugManager.dumpKernelArgs((const Kernel *)nullptr);
debugManager.flags.DumpKernelArgs.set(false);
// test api input logging
debugManager.flags.LogApiCalls.set(true);
debugManager.logInputs("Arg name", "value");
debugManager.logInputs("int", 5);
debugManager.flags.LogApiCalls.set(false);
logFileCreated = fileExists(debugManager.getLogFileName());
EXPECT_FALSE(logFileCreated);
// check Log
debugManager.flags.LogApiCalls.set(true);
debugManager.log(true, "string to be logged");
debugManager.flags.LogApiCalls.set(false);
logFileCreated = fileExists(debugManager.getLogFileName());
EXPECT_FALSE(logFileCreated);
files = Directory::getFiles(path);
size_t finalNumberOfFiles = files.size();
EXPECT_EQ(initialNumberOfFiles, finalNumberOfFiles);
}
TEST(DebugSettingsApiEnterWrapper, WithDebugFunctionality) {
const char *name = "function";
int error = 0;
TestDebugSettingsApiEnterWrapper<true> *debugApiWrapper = new TestDebugSettingsApiEnterWrapper<true>(name, nullptr);
EXPECT_TRUE(debugApiWrapper->loggedEnter);
delete debugApiWrapper;
TestDebugSettingsApiEnterWrapper<true> *debugApiWrapper2 = new TestDebugSettingsApiEnterWrapper<true>(name, &error);
EXPECT_TRUE(debugApiWrapper2->loggedEnter);
delete debugApiWrapper2;
}
TEST(DebugSettingsApiEnterWrapper, WithoutDebugFunctionality) {
const char *name = "function";
int error = 0;
TestDebugSettingsApiEnterWrapper<false> *debugApiWrapper = new TestDebugSettingsApiEnterWrapper<false>(name, nullptr);
EXPECT_FALSE(debugApiWrapper->loggedEnter);
delete debugApiWrapper;
TestDebugSettingsApiEnterWrapper<false> *debugApiWrapper2 = new TestDebugSettingsApiEnterWrapper<false>(name, &error);
EXPECT_FALSE(debugApiWrapper2->loggedEnter);
delete debugApiWrapper2;
}
TEST(DebugSettingsManager, deviceInfoPointerToStringReturnsCorrectString) {
FullyEnabledTestDebugManager debugManager;
uint64_t value64bit = 64;
string string64bit = debugManager.deviceInfoPointerToString(&value64bit, sizeof(uint64_t));
uint32_t value32bit = 32;
string string32bit = debugManager.deviceInfoPointerToString(&value32bit, sizeof(uint32_t));
uint8_t value8bit = 0;
string string8bit = debugManager.deviceInfoPointerToString(&value8bit, sizeof(uint8_t));
EXPECT_STREQ("64", string64bit.c_str());
EXPECT_STREQ("32", string32bit.c_str());
EXPECT_STREQ("0", string8bit.c_str());
string stringNonValue = debugManager.deviceInfoPointerToString(nullptr, 56);
EXPECT_STREQ("", stringNonValue.c_str());
char valueChar = 0;
stringNonValue = debugManager.deviceInfoPointerToString(&valueChar, 56);
EXPECT_STREQ("", stringNonValue.c_str());
}
TEST(DebugSettingsManager, givenDisabledDebugFunctionalityWhenLogLazyEvaluateArgsIsCalledThenCallToLambdaIsDropped) {
FullyDisabledTestDebugManager debugManager;
bool wasCalled = false;
debugManager.logLazyEvaluateArgs(true, [&] { wasCalled = true; });
EXPECT_FALSE(wasCalled);
}
TEST(DebugSettingsManager, givenDisabledPredicateWhenLogLazyEvaluateArgsIsCalledThenCallToLambdaIsDropped) {
FullyEnabledTestDebugManager debugManager;
bool wasCalled = false;
debugManager.logLazyEvaluateArgs(false, [&] { wasCalled = true; });
EXPECT_FALSE(wasCalled);
}
TEST(DebugSettingsManager, givenEnabledPredicateWhenLogLazyEvaluateArgsIsCalledThenCallToLambdaIsExecuted) {
FullyEnabledTestDebugManager debugManager;
bool wasCalled = false;
debugManager.logLazyEvaluateArgs(true, [&] { wasCalled = true; });
EXPECT_TRUE(wasCalled);
}
struct DummyEvaluator {
DummyEvaluator(bool &wasCalled) {
wasCalled = true;
}
operator const char *() {
return "";
}
};
TEST(DebugSettingsManager, givenDisabledPredicateWhenDbgLogLazyEvaluateArgsIsCalledThenInputParametersAreNotEvaluated) {
FullyEnabledTestDebugManager debugManager;
debugManager.flags.LogApiCalls.set(false);
bool wasCalled = false;
DBG_LOG_LAZY_EVALUATE_ARGS(debugManager, LogApiCalls, log, true, DummyEvaluator(wasCalled));
EXPECT_FALSE(wasCalled);
}
TEST(DebugSettingsManager, givenEnabledPredicateWhenDbgLogLazyEvaluateArgsIsCalledThenInputParametersAreEvaluated) {
FullyEnabledTestDebugManager debugManager;
debugManager.flags.LogApiCalls.set(true);
bool wasCalled = false;
DBG_LOG_LAZY_EVALUATE_ARGS(debugManager, LogApiCalls, log, true, DummyEvaluator(wasCalled));
EXPECT_TRUE(wasCalled);
}
TEST(DebugSettingsManager, whenDebugManagerIsDisabledThenDebugFunctionalityIsNotAvailableAtCompileTime) {
TestDebugSettingsManager<DebugFunctionalityLevel::None> debugManager;
static_assert(debugManager.disabled(), "");
static_assert(false == debugManager.debugLoggingAvailable(), "");
static_assert(false == debugManager.debugKernelDumpingAvailable(), "");
static_assert(false == debugManager.kernelArgDumpingAvailable(), "");
static_assert(false == debugManager.registryReadAvailable(), "");
}
TEST(DebugSettingsManager, whenDebugManagerIsFullyEnabledThenAllDebugFunctionalityIsAvailableAtCompileTime) {
TestDebugSettingsManager<DebugFunctionalityLevel::Full> debugManager;
static_assert(false == debugManager.disabled(), "");
static_assert(debugManager.debugLoggingAvailable(), "");
static_assert(debugManager.debugKernelDumpingAvailable(), "");
static_assert(debugManager.kernelArgDumpingAvailable(), "");
static_assert(debugManager.registryReadAvailable(), "");
}
TEST(DebugSettingsManager, whenOnlyRegKeysAreEnabledThenAllOtherDebugFunctionalityIsNotAvailableAtCompileTime) {
TestDebugSettingsManager<DebugFunctionalityLevel::RegKeys> debugManager;
static_assert(false == debugManager.disabled(), "");
static_assert(false == debugManager.debugLoggingAvailable(), "");
static_assert(false == debugManager.debugKernelDumpingAvailable(), "");
static_assert(false == debugManager.kernelArgDumpingAvailable(), "");
static_assert(debugManager.registryReadAvailable(), "");
}