1 /*
2 *
3 * Copyright (c) 2014-2023 The Khronos Group Inc.
4 * Copyright (c) 2014-2023 Valve Corporation
5 * Copyright (c) 2014-2023 LunarG, Inc.
6 * Copyright (C) 2015 Google Inc.
7 *
8 * Licensed under the Apache License, Version 2.0 (the "License");
9 * you may not use this file except in compliance with the License.
10 * You may obtain a copy of the License at
11 *
12 * http://www.apache.org/licenses/LICENSE-2.0
13 *
14 * Unless required by applicable law or agreed to in writing, software
15 * distributed under the License is distributed on an "AS IS" BASIS,
16 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
17 * See the License for the specific language governing permissions and
18 * limitations under the License.
19 *
20 * Author: Jon Ashburn <jon@lunarg.com>
21 * Author: Courtney Goeltzenleuchter <courtney@LunarG.com>
22 * Author: Chia-I Wu <olvaffe@gmail.com>
23 * Author: Chia-I Wu <olv@lunarg.com>
24 * Author: Mark Lobodzinski <mark@LunarG.com>
25 * Author: Lenny Komow <lenny@lunarg.com>
26 * Author: Charles Giessen <charles@lunarg.com>
27 *
28 */
29
30 #pragma once
31
32 #include "loader_common.h"
33 #include "cJSON.h"
34 #include "bundle_mgr_helper/vk_bundle_mgr_helper.h"
35
36 // Declare the once_init variable
LOADER_PLATFORM_THREAD_ONCE_EXTERN_DEFINITION(once_init)37 LOADER_PLATFORM_THREAD_ONCE_EXTERN_DEFINITION(once_init)
38
39 static inline VkPhysicalDevice loader_unwrap_physical_device(VkPhysicalDevice physicalDevice) {
40 struct loader_physical_device_tramp *phys_dev = (struct loader_physical_device_tramp *)physicalDevice;
41 if (PHYS_TRAMP_MAGIC_NUMBER != phys_dev->magic) {
42 return VK_NULL_HANDLE;
43 }
44 return phys_dev->phys_dev;
45 }
46
loader_set_dispatch(void * obj,const void * data)47 static inline void loader_set_dispatch(void *obj, const void *data) { *((const void **)obj) = data; }
48
loader_get_dispatch(const void * obj)49 static inline VkLayerDispatchTable *loader_get_dispatch(const void *obj) {
50 if (VK_NULL_HANDLE == obj) {
51 return NULL;
52 }
53 VkLayerDispatchTable *disp = *((VkLayerDispatchTable **)obj);
54 if (VK_NULL_HANDLE == disp || DEVICE_DISP_TABLE_MAGIC_NUMBER != disp->magic) {
55 return NULL;
56 }
57 return disp;
58 }
59
loader_get_dev_dispatch(const void * obj)60 static inline struct loader_dev_dispatch_table *loader_get_dev_dispatch(const void *obj) {
61 return *((struct loader_dev_dispatch_table **)obj);
62 }
63
loader_get_instance_layer_dispatch(const void * obj)64 static inline VkLayerInstanceDispatchTable *loader_get_instance_layer_dispatch(const void *obj) {
65 return *((VkLayerInstanceDispatchTable **)obj);
66 }
67
loader_get_instance_dispatch(const void * obj)68 static inline struct loader_instance_dispatch_table *loader_get_instance_dispatch(const void *obj) {
69 return *((struct loader_instance_dispatch_table **)obj);
70 }
71
loader_init_dispatch(void * obj,const void * data)72 static inline void loader_init_dispatch(void *obj, const void *data) {
73 #if defined(DEBUG)
74 assert(valid_loader_magic_value(obj) &&
75 "Incompatible ICD, first dword must be initialized to "
76 "ICD_LOADER_MAGIC. See loader/README.md for details.");
77 #endif
78
79 loader_set_dispatch(obj, data);
80 }
81
82 // Global variables used across files
83 extern struct loader_struct loader;
84 extern loader_platform_thread_mutex loader_lock;
85 extern loader_platform_thread_mutex loader_preload_icd_lock;
86 extern loader_platform_thread_mutex loader_global_instance_list_lock;
87
88 bool compare_vk_extension_properties(const VkExtensionProperties *op1, const VkExtensionProperties *op2);
89
90 VkResult loader_validate_layers(const struct loader_instance *inst, const uint32_t layer_count,
91 const char *const *ppEnabledLayerNames, const struct loader_layer_list *list);
92
93 VkResult loader_validate_instance_extensions(struct loader_instance *inst, const struct loader_extension_list *icd_exts,
94 const struct loader_layer_list *instance_layer,
95 const struct loader_envvar_all_filters *layer_filters,
96 const VkInstanceCreateInfo *pCreateInfo);
97
98 #if defined(_WIN32)
99 BOOL __stdcall loader_initialize(PINIT_ONCE InitOnce, PVOID Parameter, PVOID *Context);
100 #else
101 void loader_initialize(void);
102 #endif
103 void loader_release(void);
104 void loader_preload_icds(void);
105 void loader_unload_preloaded_icds(void);
106 VkResult loader_init_library_list(struct loader_layer_list *instance_layers, loader_platform_dl_handle **libs);
107
108 // Allocate a new string able to hold source_str and place it in dest_str
109 VkResult loader_copy_to_new_str(const struct loader_instance *inst, const char *source_str, char **dest_str);
110
111 // Allocate a loader_string_list with enough space for allocated_count strings inside of it
112 VkResult create_string_list(const struct loader_instance *inst, uint32_t allocated_count, struct loader_string_list *string_list);
113 // Resize if there isn't enough space, then add the string str to the end of the loader_string_list
114 // This function takes ownership of the str passed in - but only when it succeeds
115 VkResult append_str_to_string_list(const struct loader_instance *inst, struct loader_string_list *string_list, char *str);
116 // Resize if there isn't enough space, then copy the string str to a new string the end of the loader_string_list
117 // This function does not take ownership of the string, it merely copies it.
118 // This function appends a null terminator to the string automatically
119 // The str_len parameter does not include the null terminator
120 VkResult copy_str_to_string_list(const struct loader_instance *inst, struct loader_string_list *string_list, const char *str,
121 size_t str_len);
122
123 // Free any string inside of loader_string_list and then free the list itself
124 void free_string_list(const struct loader_instance *inst, struct loader_string_list *string_list);
125
126 VkResult loader_init_generic_list(const struct loader_instance *inst, struct loader_generic_list *list_info, size_t element_size);
127 VkResult loader_resize_generic_list(const struct loader_instance *inst, struct loader_generic_list *list_info);
128 VkResult loader_get_next_available_entry(const struct loader_instance *inst, struct loader_used_object_list *list_info,
129 uint32_t *free_index, const VkAllocationCallbacks *pAllocator);
130 void loader_release_object_from_list(struct loader_used_object_list *list_info, uint32_t index_to_free);
131 bool has_vk_extension_property_array(const VkExtensionProperties *vk_ext_prop, const uint32_t count,
132 const VkExtensionProperties *ext_array);
133 bool has_vk_extension_property(const VkExtensionProperties *vk_ext_prop, const struct loader_extension_list *ext_list);
134 // This function takes ownership of layer_property in the case that allocation fails
135 VkResult loader_append_layer_property(const struct loader_instance *inst, struct loader_layer_list *layer_list,
136 struct loader_layer_properties *layer_property);
137 VkResult loader_add_layer_properties(const struct loader_instance *inst, struct loader_layer_list *layer_instance_list, cJSON *json,
138 bool is_implicit, char *filename);
139 bool loader_find_layer_name_in_list(const char *name, const struct loader_pointer_layer_list *layer_list);
140 VkResult loader_add_layer_properties_to_list(const struct loader_instance *inst, struct loader_pointer_layer_list *list,
141 struct loader_layer_properties *props);
142 void loader_free_layer_properties(const struct loader_instance *inst, struct loader_layer_properties *layer_properties);
143 bool loader_implicit_layer_is_enabled(const struct loader_instance *inst, const struct loader_envvar_all_filters *filters,
144 const struct loader_layer_properties *prop);
145 VkResult loader_add_meta_layer(const struct loader_instance *inst, const struct loader_envvar_all_filters *filters,
146 struct loader_layer_properties *prop, struct loader_pointer_layer_list *target_list,
147 struct loader_pointer_layer_list *expanded_target_list, const struct loader_layer_list *source_list,
148 bool *out_found_all_component_layers);
149 VkResult loader_add_to_ext_list(const struct loader_instance *inst, struct loader_extension_list *ext_list,
150 uint32_t prop_list_count, const VkExtensionProperties *props);
151 VkResult loader_add_device_extensions(const struct loader_instance *inst,
152 PFN_vkEnumerateDeviceExtensionProperties fpEnumerateDeviceExtensionProperties,
153 VkPhysicalDevice physical_device, const char *lib_name,
154 struct loader_extension_list *ext_list);
155 VkResult loader_init_generic_list(const struct loader_instance *inst, struct loader_generic_list *list_info, size_t element_size);
156 void loader_destroy_generic_list(const struct loader_instance *inst, struct loader_generic_list *list);
157 void loader_destroy_pointer_layer_list(const struct loader_instance *inst, struct loader_pointer_layer_list *layer_list);
158 TEST_FUNCTION_EXPORT void loader_delete_layer_list_and_properties(const struct loader_instance *inst,
159 struct loader_layer_list *layer_list);
160 void loader_remove_layer_in_list(const struct loader_instance *inst, struct loader_layer_list *layer_list,
161 uint32_t layer_to_remove);
162 VkResult loader_init_scanned_icd_list(const struct loader_instance *inst, struct loader_icd_tramp_list *icd_tramp_list);
163 void loader_clear_scanned_icd_list(const struct loader_instance *inst, struct loader_icd_tramp_list *icd_tramp_list);
164 VkResult loader_icd_scan(const struct loader_instance *inst, struct loader_icd_tramp_list *icd_tramp_list,
165 const VkInstanceCreateInfo *pCreateInfo, bool *skipped_portability_drivers);
166 void loader_icd_close_objects(struct loader_instance *ptr_inst, struct loader_icd_term *icd_term);
167 void loader_icd_destroy(struct loader_instance *ptr_inst, struct loader_icd_term *icd_term,
168 const VkAllocationCallbacks *pAllocator);
169 VkResult loader_scan_for_layers(struct loader_instance *inst, struct loader_layer_list *instance_layers,
170 const struct loader_envvar_all_filters *layer_filters);
171 VkResult loader_scan_for_implicit_layers(struct loader_instance *inst, struct loader_layer_list *instance_layers,
172 const struct loader_envvar_all_filters *layer_filters);
173 VkResult loader_get_icd_loader_instance_extensions(const struct loader_instance *inst, struct loader_icd_tramp_list *icd_tramp_list,
174 struct loader_extension_list *inst_exts);
175 struct loader_icd_term *loader_get_icd_and_device(const void *device, struct loader_device **found_dev);
176 struct loader_instance *loader_get_instance(const VkInstance instance);
177 loader_platform_dl_handle loader_open_layer_file(const struct loader_instance *inst, struct loader_layer_properties *prop);
178 struct loader_device *loader_create_logical_device(const struct loader_instance *inst, const VkAllocationCallbacks *pAllocator);
179 void loader_add_logical_device(struct loader_icd_term *icd_term, struct loader_device *found_dev);
180 void loader_remove_logical_device(struct loader_icd_term *icd_term, struct loader_device *found_dev,
181 const VkAllocationCallbacks *pAllocator);
182 // NOTE: Outside of loader, this entry-point is only provided for error
183 // cleanup.
184 void loader_destroy_logical_device(struct loader_device *dev, const VkAllocationCallbacks *pAllocator);
185
186 VkResult loader_enable_instance_layers(struct loader_instance *inst, const VkInstanceCreateInfo *pCreateInfo,
187 const struct loader_layer_list *instance_layers,
188 const struct loader_envvar_all_filters *layer_filters);
189
190 VkResult loader_create_instance_chain(const VkInstanceCreateInfo *pCreateInfo, const VkAllocationCallbacks *pAllocator,
191 struct loader_instance *inst, VkInstance *created_instance);
192
193 void loader_activate_instance_layer_extensions(struct loader_instance *inst, VkInstance created_inst);
194
195 VKAPI_ATTR VkResult VKAPI_CALL loader_layer_create_device(VkInstance instance, VkPhysicalDevice physicalDevice,
196 const VkDeviceCreateInfo *pCreateInfo,
197 const VkAllocationCallbacks *pAllocator, VkDevice *pDevice,
198 PFN_vkGetInstanceProcAddr layerGIPA, PFN_vkGetDeviceProcAddr *nextGDPA);
199 VKAPI_ATTR void VKAPI_CALL loader_layer_destroy_device(VkDevice device, const VkAllocationCallbacks *pAllocator,
200 PFN_vkDestroyDevice destroyFunction);
201
202 VkResult loader_create_device_chain(const VkPhysicalDevice pd, const VkDeviceCreateInfo *pCreateInfo,
203 const VkAllocationCallbacks *pAllocator, const struct loader_instance *inst,
204 struct loader_device *dev, PFN_vkGetInstanceProcAddr callingLayer,
205 PFN_vkGetDeviceProcAddr *layerNextGDPA);
206
207 VkResult loader_validate_device_extensions(struct loader_instance *this_instance,
208 const struct loader_pointer_layer_list *activated_device_layers,
209 const struct loader_extension_list *icd_exts, const VkDeviceCreateInfo *pCreateInfo);
210
211 VkResult setup_loader_tramp_phys_devs(struct loader_instance *inst, uint32_t phys_dev_count, VkPhysicalDevice *phys_devs);
212 VkResult setup_loader_tramp_phys_dev_groups(struct loader_instance *inst, uint32_t group_count,
213 VkPhysicalDeviceGroupProperties *groups);
214 void unload_drivers_without_physical_devices(struct loader_instance *inst);
215
216 VkStringErrorFlags vk_string_validate(const int max_length, const char *char_array);
217 char *loader_get_next_path(char *path);
218 VkResult add_data_files(const struct loader_instance *inst, char *search_path, struct loader_string_list *out_files,
219 bool use_first_found_manifest);
220
221 loader_api_version loader_make_version(uint32_t version);
222 loader_api_version loader_combine_version(uint32_t major, uint32_t minor, uint32_t patch);
223
224 // Helper macros for determining if a version is valid or not
225 bool loader_check_version_meets_required(loader_api_version required, loader_api_version version);
226
227 // Convenience macros for common versions
228 #if !defined(LOADER_VERSION_1_0_0)
229 #define LOADER_VERSION_1_0_0 loader_combine_version(1, 0, 0)
230 #endif
231
232 #if !defined(LOADER_VERSION_1_1_0)
233 #define LOADER_VERSION_1_1_0 loader_combine_version(1, 1, 0)
234 #endif
235