/************************************************************************** * * Copyright 2014-2019 Valve Software * Copyright 2015-2019 Google Inc. * Copyright 2019 LunarG, Inc. * All Rights Reserved. * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. * * Author: Jon Ashburn * Author: Courtney Goeltzenleuchter * Author: Tobin Ehlis * Author: Mark Lobodzinski **************************************************************************/ #include "vk_layer_config.h" #include "vulkan/vk_sdk_platform.h" #include #include #include #include #include #include #include #include #if defined(_WIN32) #include #endif #define MAX_CHARS_PER_LINE 4096 class ConfigFile { public: ConfigFile(); ~ConfigFile(); const char *getOption(const std::string &_option); void setOption(const std::string &_option, const std::string &_val); std::string vk_layer_disables_env_var{}; private: bool m_fileIsParsed; std::map m_valueMap; std::string FindSettings(); void parseFile(const char *filename); }; static ConfigFile g_configFileObj; std::string getEnvironment(const char *variable) { #if !defined(__ANDROID__) && !defined(_WIN32) const char *output = getenv(variable); return output == NULL ? "" : output; #elif defined(_WIN32) int size = GetEnvironmentVariable(variable, NULL, 0); if (size == 0) { return ""; } char *buffer = new char[size]; GetEnvironmentVariable(variable, buffer, size); std::string output = buffer; delete[] buffer; return output; #else return ""; #endif } VK_LAYER_EXPORT const char *getLayerOption(const char *_option) { return g_configFileObj.getOption(_option); } VK_LAYER_EXPORT const char *GetLayerEnvVar(const char *_option) { g_configFileObj.vk_layer_disables_env_var = getEnvironment(_option); return g_configFileObj.vk_layer_disables_env_var.c_str(); } // If option is NULL or stdout, return stdout, otherwise try to open option // as a filename. If successful, return file handle, otherwise stdout VK_LAYER_EXPORT FILE *getLayerLogOutput(const char *_option, const char *layerName) { FILE *log_output = NULL; if (!_option || !strcmp("stdout", _option)) log_output = stdout; else { log_output = fopen(_option, "w"); if (log_output == NULL) { if (_option) std::cout << std::endl << layerName << " ERROR: Bad output filename specified: " << _option << ". Writing to STDOUT instead" << std::endl << std::endl; log_output = stdout; } } return log_output; } // Map option strings to flag enum values VK_LAYER_EXPORT VkFlags GetLayerOptionFlags(std::string _option, std::unordered_map const &enum_data, uint32_t option_default) { VkDebugReportFlagsEXT flags = option_default; std::string option_list = g_configFileObj.getOption(_option.c_str()); while (option_list.length() != 0) { // Find length of option string std::size_t option_length = option_list.find(","); if (option_length == option_list.npos) { option_length = option_list.size(); } // Get first option in list const std::string option = option_list.substr(0, option_length); auto enum_value = enum_data.find(option); if (enum_value != enum_data.end()) { flags |= enum_value->second; } // Remove first option from option_list option_list.erase(0, option_length); // Remove possible comma separator std::size_t char_position = option_list.find(","); if (char_position == 0) { option_list.erase(char_position, 1); } // Remove possible space char_position = option_list.find(" "); if (char_position == 0) { option_list.erase(char_position, 1); } } return flags; } VK_LAYER_EXPORT void setLayerOption(const char *_option, const char *_val) { g_configFileObj.setOption(_option, _val); } // Constructor for ConfigFile. Initialize layers to log error messages to stdout by default. If a vk_layer_settings file is present, // its settings will override the defaults. ConfigFile::ConfigFile() : m_fileIsParsed(false) { m_valueMap["khronos_validation.report_flags"] = "error"; m_valueMap["lunarg_core_validation.report_flags"] = "error"; m_valueMap["lunarg_object_tracker.report_flags"] = "error"; m_valueMap["lunarg_parameter_validation.report_flags"] = "error"; m_valueMap["google_threading.report_flags"] = "error"; m_valueMap["google_unique_objects.report_flags"] = "error"; #ifdef WIN32 // For Windows, enable message logging AND OutputDebugString m_valueMap["khronos_validation.debug_action"] = "VK_DBG_LAYER_ACTION_DEFAULT,VK_DBG_LAYER_ACTION_LOG_MSG,VK_DBG_LAYER_ACTION_DEBUG_OUTPUT"; m_valueMap["lunarg_core_validation.debug_action"] = "VK_DBG_LAYER_ACTION_DEFAULT,VK_DBG_LAYER_ACTION_LOG_MSG,VK_DBG_LAYER_ACTION_DEBUG_OUTPUT"; m_valueMap["lunarg_object_tracker.debug_action"] = "VK_DBG_LAYER_ACTION_DEFAULT,VK_DBG_LAYER_ACTION_LOG_MSG,VK_DBG_LAYER_ACTION_DEBUG_OUTPUT"; m_valueMap["lunarg_parameter_validation.debug_action"] = "VK_DBG_LAYER_ACTION_DEFAULT,VK_DBG_LAYER_ACTION_LOG_MSG,VK_DBG_LAYER_ACTION_DEBUG_OUTPUT"; m_valueMap["google_threading.debug_action"] = "VK_DBG_LAYER_ACTION_DEFAULT,VK_DBG_LAYER_ACTION_LOG_MSG,VK_DBG_LAYER_ACTION_DEBUG_OUTPUT"; m_valueMap["google_unique_objects.debug_action"] = "VK_DBG_LAYER_ACTION_DEFAULT,VK_DBG_LAYER_ACTION_LOG_MSG,VK_DBG_LAYER_ACTION_DEBUG_OUTPUT"; #else // WIN32 m_valueMap["khronos_validation.debug_action"] = "VK_DBG_LAYER_ACTION_DEFAULT,VK_DBG_LAYER_ACTION_LOG_MSG"; m_valueMap["lunarg_core_validation.debug_action"] = "VK_DBG_LAYER_ACTION_DEFAULT,VK_DBG_LAYER_ACTION_LOG_MSG"; m_valueMap["lunarg_object_tracker.debug_action"] = "VK_DBG_LAYER_ACTION_DEFAULT,VK_DBG_LAYER_ACTION_LOG_MSG"; m_valueMap["lunarg_parameter_validation.debug_action"] = "VK_DBG_LAYER_ACTION_DEFAULT,VK_DBG_LAYER_ACTION_LOG_MSG"; m_valueMap["google_threading.debug_action"] = "VK_DBG_LAYER_ACTION_DEFAULT,VK_DBG_LAYER_ACTION_LOG_MSG"; m_valueMap["google_unique_objects.debug_action"] = "VK_DBG_LAYER_ACTION_DEFAULT,VK_DBG_LAYER_ACTION_LOG_MSG"; #endif // WIN32 m_valueMap["khronos_validation.log_filename"] = "stdout"; m_valueMap["lunarg_core_validation.log_filename"] = "stdout"; m_valueMap["lunarg_object_tracker.log_filename"] = "stdout"; m_valueMap["lunarg_parameter_validation.log_filename"] = "stdout"; m_valueMap["google_threading.log_filename"] = "stdout"; m_valueMap["google_unique_objects.log_filename"] = "stdout"; } ConfigFile::~ConfigFile() {} const char *ConfigFile::getOption(const std::string &_option) { std::map::const_iterator it; if (!m_fileIsParsed) { std::string settings_file = FindSettings(); parseFile(settings_file.c_str()); } if ((it = m_valueMap.find(_option)) == m_valueMap.end()) return ""; else return it->second.c_str(); } void ConfigFile::setOption(const std::string &_option, const std::string &_val) { if (!m_fileIsParsed) { std::string settings_file = FindSettings(); parseFile(settings_file.c_str()); } m_valueMap[_option] = _val; } std::string ConfigFile::FindSettings() { struct stat info; #if defined(WIN32) HKEY hive; LSTATUS err = RegOpenKeyEx(HKEY_CURRENT_USER, "Software\\Khronos\\Vulkan\\Settings", 0, KEY_READ, &hive); if (err == ERROR_SUCCESS) { char name[2048]; DWORD i = 0, name_size = sizeof(name), type, value, value_size = sizeof(value); while (ERROR_SUCCESS == RegEnumValue(hive, i++, name, &name_size, nullptr, &type, reinterpret_cast(&value), &value_size)) { // Check if the registry entry is a dword with a value of zero if (type != REG_DWORD || value != 0) { continue; } // Check if this actually points to a file if ((stat(name, &info) != 0) || !(info.st_mode & S_IFREG)) { continue; } // Use this file RegCloseKey(hive); return name; } RegCloseKey(hive); } #else std::string search_path = getEnvironment("XDG_DATA_HOME"); if (search_path == "") { search_path = getEnvironment("HOME"); if (search_path != "") { search_path += "/.local/share"; } } // Use the vk_layer_settings.txt file from here, if it is present if (search_path != "") { std::string home_file = search_path + "/vulkan/settings.d/vk_layer_settings.txt"; if (stat(home_file.c_str(), &info) == 0) { if (info.st_mode & S_IFREG) { return home_file; } } } #endif std::string env_path = getEnvironment("VK_LAYER_SETTINGS_PATH"); // If the path exists use it, else use vk_layer_settings if (stat(env_path.c_str(), &info) == 0) { // If this is a directory, look for vk_layer_settings within the directory if (info.st_mode & S_IFDIR) { return env_path + "/vk_layer_settings.txt"; } return env_path; } return "vk_layer_settings.txt"; } void ConfigFile::parseFile(const char *filename) { std::ifstream file; char buf[MAX_CHARS_PER_LINE]; m_fileIsParsed = true; file.open(filename); if (!file.good()) { return; } // read tokens from the file and form option, value pairs file.getline(buf, MAX_CHARS_PER_LINE); while (!file.eof()) { char option[512]; char value[512]; char *pComment; // discard any comments delimited by '#' in the line pComment = strchr(buf, '#'); if (pComment) *pComment = '\0'; if (sscanf(buf, " %511[^\n\t =] = %511[^\n \t]", option, value) == 2) { std::string optStr(option); std::string valStr(value); m_valueMap[optStr] = valStr; } file.getline(buf, MAX_CHARS_PER_LINE); } } VK_LAYER_EXPORT void PrintMessageFlags(VkFlags vk_flags, char *msg_flags) { bool separator = false; msg_flags[0] = 0; if (vk_flags & VK_DEBUG_REPORT_DEBUG_BIT_EXT) { strcat(msg_flags, "DEBUG"); separator = true; } if (vk_flags & VK_DEBUG_REPORT_INFORMATION_BIT_EXT) { if (separator) strcat(msg_flags, ","); strcat(msg_flags, "INFO"); separator = true; } if (vk_flags & VK_DEBUG_REPORT_WARNING_BIT_EXT) { if (separator) strcat(msg_flags, ","); strcat(msg_flags, "WARN"); separator = true; } if (vk_flags & VK_DEBUG_REPORT_PERFORMANCE_WARNING_BIT_EXT) { if (separator) strcat(msg_flags, ","); strcat(msg_flags, "PERF"); separator = true; } if (vk_flags & VK_DEBUG_REPORT_ERROR_BIT_EXT) { if (separator) strcat(msg_flags, ","); strcat(msg_flags, "ERROR"); } } VK_LAYER_EXPORT void PrintMessageSeverity(VkFlags vk_flags, char *msg_flags) { bool separator = false; msg_flags[0] = 0; if (vk_flags & VK_DEBUG_UTILS_MESSAGE_SEVERITY_VERBOSE_BIT_EXT) { strcat(msg_flags, "VERBOSE"); separator = true; } if (vk_flags & VK_DEBUG_UTILS_MESSAGE_SEVERITY_INFO_BIT_EXT) { if (separator) strcat(msg_flags, ","); strcat(msg_flags, "INFO"); separator = true; } if (vk_flags & VK_DEBUG_UTILS_MESSAGE_SEVERITY_WARNING_BIT_EXT) { if (separator) strcat(msg_flags, ","); strcat(msg_flags, "WARN"); separator = true; } if (vk_flags & VK_DEBUG_UTILS_MESSAGE_SEVERITY_ERROR_BIT_EXT) { if (separator) strcat(msg_flags, ","); strcat(msg_flags, "ERROR"); } } VK_LAYER_EXPORT void PrintMessageType(VkFlags vk_flags, char *msg_flags) { bool separator = false; msg_flags[0] = 0; if (vk_flags & VK_DEBUG_UTILS_MESSAGE_TYPE_GENERAL_BIT_EXT) { strcat(msg_flags, "GEN"); separator = true; } if (vk_flags & VK_DEBUG_UTILS_MESSAGE_TYPE_VALIDATION_BIT_EXT) { strcat(msg_flags, "SPEC"); separator = true; } if (vk_flags & VK_DEBUG_UTILS_MESSAGE_TYPE_PERFORMANCE_BIT_EXT) { if (separator) strcat(msg_flags, ","); strcat(msg_flags, "PERF"); separator = true; } }