aboutsummaryrefslogtreecommitdiff
path: root/loader/LoaderAndLayerInterface.md
AgeCommit message (Collapse)Author
2018-01-09docs: Update loader doc for pre-instance layersLenny Komow
Change-Id: I4780d36714a6a15c4c57cd0f6324f640249a9427
2017-10-23loader: Fix function name in interface docTobin Ehlis
There is no "vk_icdGetLoaderICDInterfaceVersion" function. The correct name is "vk_icdNegotiateLoaderICDInterfaceVersion."
2017-10-20loader:Updates to LL Interface DocTobin Ehlis
Fixing some formatting issues and typos as I read through doc.
2017-09-06docs: Update loader doc for pnp registry changesLenny Komow
Change-Id: I3d41b7b01140243457ac35cfa2c22235f35e4e83
2017-08-10loader: Add new ICD search paths to loaderSlawomir Cygan
This change extends the functionality of searching for ICD JSONs by adding registry locations specific to given display adapter and software components associated with this display adapter. The exact locations in registry are queried using Windows public PnP Configuration Manager API[1]. This change is required, as previous ICD locations (constant path in "HKLM/Software") may be unreachable for drivers and their installers on Windows RS3[2]. Similar change is being made for OpenCL[2] [1]https://msdn.microsoft.com/en-us/library/windows/hardware/ff549713.aspx [2]https://github.com/KhronosGroup/OpenCL-ICD-Loader/pull/21
2017-06-29loader: Add validation for apiVersionMark Young
Add a check to determine if the API version being requested can be handled by the loader. If it can't, then we return incompatible driver. If we can, we continue along our merry way. An addendum is that we also bumped the Loader/ICD interface version. This was requested by Nvidia so that the ICDs know that we pay attention to the version in the loader. If they don't see the new Loader/ICD interface version, they will handle the failing on all non-1.0 API requests. Change-Id: Icb7dd45e754c9f6a6c8186198333bacc68077b93
2017-06-12docs: Remove swapchain refs from docs/text filesMark Lobodzinski
Change-Id: I88d9c5ae82159ad6b1976b0b498fbe4ee7f5e2d5
2017-05-19docs: Update docs with env varsMark Young
Added table of all environmental variables. Also added note about using LD_BIND_NOW usage for discovering problematic ICDs. Change-Id: Iba4234b2226ab145491fc913f4361b098b21fd0b
2017-05-09loader: Update meta-layersMark Young
Use the meta-layer Manifest API version to check against each of its component layer API versions. This will force us to make sure each JSON file is properly updated in sync. Add a section to the LoaderAndLayerInterface markdown doc about the usage of meta-layers, and an example of how they look in a Manifest JSON file. Change-Id: I667cfd3013cbcf201c83935dc6f1c2bb937c7742
2017-05-04docs: Update loader doc for linking and formatLenny Komow
Change-Id: Id51ce907ca167a44f9f2db6db48b4ade679b129b
2017-03-20docs: LX666 - Typos in DocsMark Young
Fix issue brought up by Masaki Takano in LunarXchange. Change-Id: Ib6caa931decf5976e96bcd4629602b7f25b88001
2017-03-02docs: Add new layer registries to loader docLenny Komow
Change-Id: I185d37096db07585d8b4015201656937fbf5714d
2017-02-13docs: Update LoaderAndLayerInterfaceMark Young
Added section detailing the loader's instance extension name filtering behavior and the environment varaible that can be used to disable the behavior. Change-Id: Iadbde47e2933a163906a7cfa1c4b340da0d73789
2017-02-01loader: Minor language clarification, fix markupJeff Juliano
2017-01-24loader: Update the loader to 1.0.39Mark Young
Add new extensions for 1.0.39. Also, updated layers to include minimal set of functionality for 1.0.39 extensions. Extensions include: - VK_KHR_get_physical_device_properties2 - VK_KHR_shader_draw_parameters - VK_EXT_direct_mode_display - VK_EXT_display_surface_counter - VK_EXT_display_control Also, redo the LoaderAndLayerIf document. Change-Id: I10412086da7a798afe832a3892e18f606259b5af
2016-11-22docs: Fix loader doc mention of linux dirsMark Young
The Linux "Properly-Installed ICDs" section wasn't coming across into HTML properly. Change-Id: I2538b3c027c88ad5923d23f554bba1734c60ec06
2016-11-02docs: Remove references to "this repo"Karl Schultz
Remove references to "this repository" in the loader and layers design doc since this file can appear on web sites, etc.
2016-10-31docs: Updates for Linux loader /usr/local search paths.Karl Schultz
Change-Id: I899c55815ef51efd141c22a5ce37b0800c2a8430
2016-10-31docs: LX617: Fix Android layer path infoKarl Schultz
2016-10-25docs: Fix .md syntax typo in headerRene Lindsay
2016-09-20loader: More changes for gh181Mark Young
With Piers' fix, another path was broke because we still needed to intercept the call before it went to the ICD. Now, with his change and this change, all paths work. Also, clean up some code based on comments from Ian and Courtney reviews. Finally, update docs to indicate behavior of new loader 3 interface with ICDs. Change-Id: I2d3f962baffb21c1edeb93b132ffad40f298c8e7
2016-09-01docs: Fix "Cautions" titleMark Young
GitHub Markdown doesn't support the sub-section we tried to use. Instead, make this plain text, underlined and bolded. Change-Id: Id20275c79f06b59c39ab9a9d118ddcbea6110ffa
2016-09-01loader: gh888 Add KHR/EXT extensions in vulkan.hMark Young
Add the KHR_display_swapchain device extension to the loader and the core_validation layers. This fulfills the work required in JIRA LOAD-7 and gh 90. Add debug_marker to the extension list. Change-Id: I1fb70e5d44bc8c1f70fd6d1cfbd106a155081b25
2016-08-31Add new text to discuss wrapping of objects, including cautions.Ian Elliott
This describes the process of wrapping and unwrapping objects, and provides some cautions about the dangers of layers wrapping objects (e.g. incompatibilities with unsupported extensions).
2016-08-31doc: Update loaderandlayerinterfaceMark Young
Added more information about layer wrapping, specifically requiring support for extensions. Change-Id: Ie60952f41c976b8e0245810c550b133dc5843097
2016-07-29docs: Clean up LoaderAndLayerInterface markdownMark Young
Perform some wordsmithing and general clean-up of the LoaderAndLayerInterface markdown file. Change-Id: I286d0f1d01241b376ba2f4dfa97d2329b04d515d
2016-07-21docs: Remove extra line in doc headersMark Young
GitHub markdown adds a line after H1 and H2 entries. Normal markdown doesn't do this. So my WSYIWYG editor incorrectly showed the results of my previous edits. Change-Id: I3c197c1fb1f364bf4b1050d1eaa1141affefe9d1
2016-07-20loader: Clean up some things in the MD fileMark Young
Clean up some documentation in the LoaderAndLayerInterface markdown. Over the next few weeks, I'll be working on cleaning up the format and language of this doc. Change-Id: I7858981293de9befb34701c31542d88c664cd6d8
2016-07-19loader: Clarify in docs about WSI and inst ext.Mark Young
Clarify in the LoaderAndLayerInterface markdown file what WSI extensions are available by default in the desktop loader. Additionally, clarify that instance extensions are not supported by the Loader unless they have been specifically added to the Loader. Change-Id: I21bd2a63ed1e4a7e50d27e7a6b136eeeaea4d68c
2016-06-23docs: Fix broken link in LoaderAndLayerInterfaceMark Young
The Manifest file example link was broken. Change-Id: I454392f14f526ef6fdf5b30d971bd06739acb994
2016-06-20docs: Fix weird characters in Loader.md fileMark Young
2016-06-14loader: Fix GH607 by adding proper array supportMark Young
JSON spec does not allow objects of the same name at the same level. But, that's what we used to allow with "layer" definitions. Update new file version to 1.0.1, add "layers" array object, and add multiple "layer" definition warning. Change-Id: I040f07897c689800364d243daf3c247f1b3cace7
2016-06-06loader: doc update for merge android and desktop layer interfaceJon Ashburn
Change-Id: Ibbffc0bf05bcbd1aa3b9272caa0b2c1c3a54037d
2016-05-19docs: update v0 languages for device layer deprecationChia-I Wu
Clarify that a layer's vkEnumerateInstanceLayerProperties vkEnumerateInstanceExtensionProperties - should enumerate the layer itself vkEnumerateDeviceLayerProperties - is deprecated vkEnumerateDeviceExtensionProperties - must handle all layers by chaining vkCreateInstance - `pNext` handling is covered by the spec vkCreateDevice - allow validation layers to validate layer and extension names Clarify that the layer library's vkEnumerateInstanceLayerProperties vkEnumerateInstanceExtensionProperties - are not used by the desktop loader - can be aliases to the layer's versions when the layer library contains only one layer vkEnumerateDeviceLayerProperties vkEnumerateDeviceExtensionProperties - are not used by the desktop loader vkGetInstanceProcAddr - mention that the special cases for vkCreateDevice and device commands are for compatibility
2016-05-18doc: update layer and loader doc for device lyaer deprecationJon Ashburn
Change-Id: I53ff750a25fd5ea390c22f5ded2247dfbedce2aa
2016-05-10loader: Update interface docJon Ashburn
The version 0 layer did not properly address the desktop loader requirements. Split the layer interface into an Android section and a desktop section. Change-Id: I782bdddd13da318274ad604ee0e48208bd1dc947
2016-05-06doc: allow layers to ignore pAllocatorChia-I Wu
2016-04-26loader: update doc to remove sentence allowing layers to skipJon Ashburn
using app provided allocation callbacks Change-Id: Ib293934b4574864a78f975aba52c9aa5c0a24779
2016-04-25loader: update spec doc for ICD interface versioningJon Ashburn
Change-Id: I7c149a4542623e537b44720766006652abe33948
2016-04-22doc: remove rules on vkEnumerate*Properties for layersChia-I Wu
2016-04-22doc: formalize the current loader-layer interfaceChia-I Wu
Expand the section "Discovery of layer entry points" into "Layer Library Interface". In general, the new section defines an interface that allows a loader to discover and insert layers while staying compliant. Other sections have additional guidelines for layers to follow.
2016-04-19Update typo in docttyio
2016-04-18doc: fix typos in docDavid Pinedo
2016-04-06loader: Update specification doc for dispatchable object initializationJon Ashburn
Change-Id: I80770b7ab14795316400279dc4e7c954fa5ad374
2016-04-02loader: fix spelling mistakesEric Engestrom
2016-03-21layers: Rename param_checker to parameter_validationMark Lobodzinski
Also, param_check.h -> parameter_validation.h and .json files changed. Change-Id: I9db10563bcc2640fe6b90588d3c80c4fe50a8a83
2016-03-08Bump api_version to 1.0.5 in json filesTony Barbour
Change-Id: I71a03cd8043906074f6c3be98af0006e1aeaf5ee
2016-03-03misc: Remove lunarg_debug_marker extensionJon Ashburn
This device extensions was not completely supported in any layer. It had partial support (intercept) in draw_state and device_limits. This extension is being changed and has a formal proposal in Khronos as debug_marker_ext. Removing the existing extension since it is deprecated; once the debug_marker_ext gets registered by Khronos, layers might want to start using the ObjectTag/ObjectName commands to supplement error report messages in debug_report_ext. Since debug_report_ext might get changed as part of Khronos review, don't add it yet.
2016-03-02loader: Update documentation to remove editing comments.Jon Ashburn
Also better describe layer requirements for layers which creat new dispatchable objects.
2016-02-24loader: Update doc to add the Linux search pathJon Ashburn
$HOME/.local/share/vulkan/icd.d or explicit_layer.d or implicit_layer.d