This document is an overview of how to use the LunarG Vulkan Installation Analyzer (VIA). VIA is a tool that can:
This document describes where to find the source for VIA, building it, runnning it, and how to understand the resulting command line output that is generated.
Many components of the LunarG Vulkan SDK are Open Source, including VIA. VIA is currently part of the LunarG VulkanTools GitHub respository.
Windows Note: VIA is already pre-built as part of the LunarG Windows Vulkan SDK, but should you wish to build a debug version or find the source, this section should provide you with the information you need. Otherwise, simply skip down to the “Running” section below.
Because it is part of a group of tools, you build it from the top folder by following the instructions in the BuilidVT.md file at the top of the source tree.
The source for VIA can also be found in the LunarG Linux Vulkan SDK in the “source/via” directory.
You will find the VIA binary in a different location depending on which OS you are using and whether you have built it, or installed it as part of the SDK. The following information states where to find the proper executable.
Please note that if you are trying to diagnose a troublesome application, the best way to run VIA to assist in diagnosis is to change to the location of the application, and run via in that folder locally (by typing in a relative or absolute path to the via executable).
VIA is installed into your start menu as part of the Windows Vulkan SDK. Simply open your start menu, search for the “Vulkan SDK” and click “via”. This will ouptut the resulting via.html directly to your desktop.
If you need to run via from the command-line, you will find it in your SDK folder (defined by the environment variable “VULKAN_SDK”) under the “Bin” folder for 64-bit executables, and “Bin32” folder for 32-bit executables. From there, simply run:
via.exe
Once built, VIA can be found in the x86_64/bin directory. You can simply execute it from there using:
via
Go into the folder where you generated the build items from the above building step.
Linux
Simply run:
via
Windows
Windows has an additional required step to perform if you are building from VulkanTools before you can run VIA in the proper way. This is because the CMake scripts have an important folder being copied one level too low. To run, the first time you will have to copy this folder into the appropriate location.
Steps to run the first time:
via.exe
After the first time, you just need to go into the folder and re-run “via.exe”.
VIA outputs two things:
Your home folder is the following location (based on your OS):
There are additional command-line parameters which can be used. These simply augment existing behavior and do not capture any more information. The available command-line arguments are:
The --unique_output argument, if provided, will cause the output html to be generated with a date/time suffix. This will allow you to perform multiple state captures on your system without accidentally erasing previous results. The new file has the following format:
via_YYYY_MM_DD_HH_MM.html
Where each component stands for the numeric values for year (YYYY), month (MM), day (DD), hour (HH), and minute (MM).
The --output_path arument allows the user to specify a location for the output html file. For example, if the user runs via --output_path /home/me/Documents
, then the output file will be /home/me/Documents/via.html
.
LunarG's VIA could detect no problems with your setup.
Your system is likely setup properly. If you have trouble running Vulkan from another location, it could be that your environment variables aren't setup properly.
Re-run VIA from the location your Vulkan application/game is supposed to run.
This is a Windows-specific error that indicates that no Vulkan Driver JSON files were referenced in the appropriate place in the Windows Registry.
This can indicate that a Vulkan driver failed to install properly.
You should follow up with your Graphics Driver. See more details below.
The Vulkan loader on your system failed to find any Vulkan Driver JSON files in the appropriate places.
This can indicate that a Vulkan driver failed to install properly.
You should follow up with your Graphics Driver. See more details below.
The Vulkan loader on your system found at least one Vulkan Driver JSON file, but the Driver library referenced in that file appears invalid.
This can indicate that a Vulkan driver failed to install properly.
You should follow up with your Graphics Driver. See more details below.
All the components appeared to be in place to allow Vulkan to load (from an external stand-point), but the loader still failed to find a Vulkan compatible driver.
This can indicate that either a Vulkan driver failed to install properly, or the run-time is failing for some reason.
First, attempt to re-install the run-time by visiting LunarXchange, and install the latest Vulkan SDK. If that does not work, try to see if there is a newer Vulkan driver available and install that. If that still fails, file an issue on LunarXchange.
The Vulkan loader “vulkan-1.dll” couldn't be found on your system. This file is typically installed with some Vulkan driver installs, some Vulkan-capable games, or the LunarG Vulkan SDK.
The last Vulkan Runtime install that executed on your system failed to behave properly. Or, you have never installed a Vulkan loader on your system.
To rememdy this, visit LunarXchange, and install the latest Vulkan SDK. If that does not work, file an Issue to have one of their engineers assist you.
The Vulkan loader “libvulkan.so.1” couldn't be found on your system. This file is typically installed with some Vulkan driver installs, some Vulkan-capable games, or the LunarG Vulkan SDK.
The last Vulkan Runtime install that executed on your system failed to behave properly. Or, you have never installed a Vulkan loader
If the problem is possibly related to your Graphics Driver, it could be for several reasons:
Before approaching your Graphics driver vendor, it would help if you verified that your current driver for your current hardware on your current operating system does support Vulkan.