From 209455be86eead56b8799bfb19e121b71cfdd934 Mon Sep 17 00:00:00 2001 From: Charles Giessen Date: Mon, 31 Oct 2022 17:27:29 -0600 Subject: Add the 1.3.224 Header version to the Env-Var documentation This way users know exactly which version of the loader contains the new environment variables. --- docs/LoaderDebugging.md | 8 ++++---- docs/LoaderDriverInterface.md | 2 +- docs/LoaderInterfaceArchitecture.md | 8 ++++---- docs/LoaderLayerInterface.md | 2 +- loader/vk_loader_platform.h | 11 +++++++---- 5 files changed, 17 insertions(+), 14 deletions(-) diff --git a/docs/LoaderDebugging.md b/docs/LoaderDebugging.md index b7fce45af..8ed0dfc65 100644 --- a/docs/LoaderDebugging.md +++ b/docs/LoaderDebugging.md @@ -166,7 +166,7 @@ which indicates that it was likely enabled by the application. ### Disable Layers **NOTE:** This functionality is only available with Loaders built with version -1.3.yyyy of the Vulkan headers and later. +1.3.234 of the Vulkan headers and later. Sometimes, implicit layers can cause issues with an application. Because of this, the next step is to try to disable one or more of the listed @@ -193,7 +193,7 @@ WARNING | LAYER: Implicit layer "VK_LAYER_Twitch_Overlay" forced disabled becau ### Selectively Re-enable Layers **NOTE:** This functionality is only available with Loaders built with version -1.3.yyyy of the Vulkan headers and later. +1.3.234 of the Vulkan headers and later. When trying to diagnose problems caused by layers, it is useful to first disable all layers and re-enable each layer individually. @@ -232,7 +232,7 @@ For more info on how to use the filtering environment variables, refer to the ### Enable Driver Logging **NOTE:** This functionality is only available with Loaders built with version -1.3.yyyy of the Vulkan headers and later. +1.3.234 of the Vulkan headers and later. If you suspect a driver issue, set the loader logging to specifically output driver messages: @@ -301,7 +301,7 @@ DRIVER: Using "Intel(R) UHD Graphics 630 (CFL GT2)" with driver: "/usr/li ### Selectively Enable Specific Drivers **NOTE:** This functionality is only available with Loaders built with version -1.3.yyyy of the Vulkan headers and later. +1.3.234 of the Vulkan headers and later. You can now use the filtering environment variables (`VK_LOADER_DRIVERS_SELECT` and `VK_LOADER_DRIVERS_DISABLE`) to control what diff --git a/docs/LoaderDriverInterface.md b/docs/LoaderDriverInterface.md index 6e820e0a6..b66411060 100644 --- a/docs/LoaderDriverInterface.md +++ b/docs/LoaderDriverInterface.md @@ -141,7 +141,7 @@ ignored. ### Driver Filtering **NOTE:** This functionality is only available with Loaders built with version -1.3.yyyy of the Vulkan headers and later. +1.3.234 of the Vulkan headers and later. The loader supports filter environment variables which can forcibly select and disable known drivers. diff --git a/docs/LoaderInterfaceArchitecture.md b/docs/LoaderInterfaceArchitecture.md index 357be1b94..a2cc63580 100644 --- a/docs/LoaderInterfaceArchitecture.md +++ b/docs/LoaderInterfaceArchitecture.md @@ -772,7 +772,7 @@ discovery. This functionality is only available with Loaders built with version - 1.3.yyyy of the Vulkan headers and later.
+ 1.3.234 of the Vulkan headers and later.
If no drivers are found with a manifest filename that matches any of the provided globs, then no driver is enabled and it may result in Vulkan applications failing to run properly. @@ -803,7 +803,7 @@ discovery. This functionality is only available with Loaders built with version - 1.3.yyyy of the Vulkan headers and later.
+ 1.3.234 of the Vulkan headers and later.
If all available drivers are disabled using this environment variable, then no drivers will be found by the loader and will result in Vulkan applications failing to run properly.
@@ -839,7 +839,7 @@ discovery. This functionality is only available with Loaders built with version - 1.3.yyyy of the Vulkan headers and later. + 1.3.234 of the Vulkan headers and later. export
@@ -866,7 +866,7 @@ discovery. This functionality is only available with Loaders built with version - 1.3.yyyy of the Vulkan headers and later.
+ 1.3.234 of the Vulkan headers and later.
Disabling a layer that an application intentionally enables as an explicit layer may cause the application to not function properly.
diff --git a/docs/LoaderLayerInterface.md b/docs/LoaderLayerInterface.md index dab8846ad..797377882 100644 --- a/docs/LoaderLayerInterface.md +++ b/docs/LoaderLayerInterface.md @@ -420,7 +420,7 @@ following: ### Layer Filtering **NOTE:** This functionality is only available with Loaders built with version -1.3.yyyy of the Vulkan headers and later. +1.3.234 of the Vulkan headers and later. The loader supports filter environment variables which can forcibly enable and disable known layers. diff --git a/loader/vk_loader_platform.h b/loader/vk_loader_platform.h index 6f01c653d..44120f2c2 100644 --- a/loader/vk_loader_platform.h +++ b/loader/vk_loader_platform.h @@ -43,7 +43,8 @@ #include "dlopen_fuchsia.h" #endif // defined(__Fuchsia__) -#if defined(__linux__) || defined(__APPLE__) || defined(__Fuchsia__) || defined(__QNXNTO__) || defined(__FreeBSD__) || defined(__OpenBSD__) +#if defined(__linux__) || defined(__APPLE__) || defined(__Fuchsia__) || defined(__QNXNTO__) || defined(__FreeBSD__) || \ + defined(__OpenBSD__) #include // Note: The following file is for dynamic loading: #include @@ -92,7 +93,7 @@ // Support added in v1.3.207 loader #define VK_ADDITIONAL_DRIVER_FILES_ENV_VAR "VK_ADD_DRIVER_FILES" #define VK_ADDITIONAL_LAYER_PATH_ENV_VAR "VK_ADD_LAYER_PATH" -// Support added in v1.3.yyyy loader +// Support added in v1.3.234 loader #define VK_LAYERS_ENABLE_ENV_VAR "VK_LOADER_LAYERS_ENABLE" #define VK_LAYERS_DISABLE_ENV_VAR "VK_LOADER_LAYERS_DISABLE" #define VK_DRIVERS_SELECT_ENV_VAR "VK_LOADER_DRIVERS_SELECT" @@ -109,7 +110,8 @@ #define LAYERS_PATH_ENV "VK_LAYER_PATH" #define ENABLED_LAYERS_ENV "VK_INSTANCE_LAYERS" -#if defined(__linux__) || defined(__APPLE__) || defined(__Fuchsia__) || defined(__QNXNTO__) || defined(__FreeBSD__) || defined(__OpenBSD__) +#if defined(__linux__) || defined(__APPLE__) || defined(__Fuchsia__) || defined(__QNXNTO__) || defined(__FreeBSD__) || \ + defined(__OpenBSD__) /* Linux-specific common code: */ // VK Library Filenames, Paths, etc.: @@ -230,7 +232,8 @@ static inline void loader_platform_thread_once_fn(pthread_once_t *ctl, void (*fu #endif -#if defined(__linux__) || defined(__APPLE__) || defined(__Fuchsia__) || defined(__QNXNTO__) || defined(__FreeBSD__) || defined(__OpenBSD__) +#if defined(__linux__) || defined(__APPLE__) || defined(__Fuchsia__) || defined(__QNXNTO__) || defined(__FreeBSD__) || \ + defined(__OpenBSD__) // File IO static inline bool loader_platform_file_exists(const char *path) { -- cgit v1.2.3