/src/vulkan-loader/loader/loader.h
Line | Count | Source (jump to first uncovered line) |
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 | | |
35 | | // Declare the once_init variable |
36 | | LOADER_PLATFORM_THREAD_ONCE_EXTERN_DEFINITION(once_init) |
37 | | |
38 | 0 | static inline VkPhysicalDevice loader_unwrap_physical_device(VkPhysicalDevice physicalDevice) { |
39 | 0 | struct loader_physical_device_tramp *phys_dev = (struct loader_physical_device_tramp *)physicalDevice; |
40 | 0 | if (PHYS_TRAMP_MAGIC_NUMBER != phys_dev->magic) { |
41 | 0 | return VK_NULL_HANDLE; |
42 | 0 | } |
43 | 0 | return phys_dev->phys_dev; |
44 | 0 | } Unexecuted instantiation: json_load_fuzzer.c:loader_unwrap_physical_device Unexecuted instantiation: cJSON.c:loader_unwrap_physical_device Unexecuted instantiation: loader.c:loader_unwrap_physical_device Unexecuted instantiation: loader_environment.c:loader_unwrap_physical_device Unexecuted instantiation: loader_linux.c:loader_unwrap_physical_device Unexecuted instantiation: settings.c:loader_unwrap_physical_device Unexecuted instantiation: terminator.c:loader_unwrap_physical_device Unexecuted instantiation: trampoline.c:loader_unwrap_physical_device Unexecuted instantiation: wsi.c:loader_unwrap_physical_device Unexecuted instantiation: debug_utils.c:loader_unwrap_physical_device Unexecuted instantiation: dev_ext_trampoline.c:loader_unwrap_physical_device Unexecuted instantiation: extension_manual.c:loader_unwrap_physical_device Unexecuted instantiation: gpa_helper.c:loader_unwrap_physical_device Unexecuted instantiation: phys_dev_ext.c:loader_unwrap_physical_device |
45 | | |
46 | 0 | static inline void loader_set_dispatch(void *obj, const void *data) { *((const void **)obj) = data; } Unexecuted instantiation: json_load_fuzzer.c:loader_set_dispatch Unexecuted instantiation: cJSON.c:loader_set_dispatch Unexecuted instantiation: loader.c:loader_set_dispatch Unexecuted instantiation: loader_environment.c:loader_set_dispatch Unexecuted instantiation: loader_linux.c:loader_set_dispatch Unexecuted instantiation: settings.c:loader_set_dispatch Unexecuted instantiation: terminator.c:loader_set_dispatch Unexecuted instantiation: trampoline.c:loader_set_dispatch Unexecuted instantiation: wsi.c:loader_set_dispatch Unexecuted instantiation: debug_utils.c:loader_set_dispatch Unexecuted instantiation: dev_ext_trampoline.c:loader_set_dispatch Unexecuted instantiation: extension_manual.c:loader_set_dispatch Unexecuted instantiation: gpa_helper.c:loader_set_dispatch Unexecuted instantiation: phys_dev_ext.c:loader_set_dispatch |
47 | | |
48 | 0 | static inline VkLayerDispatchTable *loader_get_dispatch(const void *obj) { |
49 | 0 | if (VK_NULL_HANDLE == obj) { |
50 | 0 | return NULL; |
51 | 0 | } |
52 | 0 | VkLayerDispatchTable *disp = *((VkLayerDispatchTable **)obj); |
53 | 0 | if (VK_NULL_HANDLE == disp || DEVICE_DISP_TABLE_MAGIC_NUMBER != disp->magic) { |
54 | 0 | return NULL; |
55 | 0 | } |
56 | 0 | return disp; |
57 | 0 | } Unexecuted instantiation: json_load_fuzzer.c:loader_get_dispatch Unexecuted instantiation: cJSON.c:loader_get_dispatch Unexecuted instantiation: loader.c:loader_get_dispatch Unexecuted instantiation: loader_environment.c:loader_get_dispatch Unexecuted instantiation: loader_linux.c:loader_get_dispatch Unexecuted instantiation: settings.c:loader_get_dispatch Unexecuted instantiation: terminator.c:loader_get_dispatch Unexecuted instantiation: trampoline.c:loader_get_dispatch Unexecuted instantiation: wsi.c:loader_get_dispatch Unexecuted instantiation: debug_utils.c:loader_get_dispatch Unexecuted instantiation: dev_ext_trampoline.c:loader_get_dispatch Unexecuted instantiation: extension_manual.c:loader_get_dispatch Unexecuted instantiation: gpa_helper.c:loader_get_dispatch Unexecuted instantiation: phys_dev_ext.c:loader_get_dispatch |
58 | | |
59 | 0 | static inline struct loader_dev_dispatch_table *loader_get_dev_dispatch(const void *obj) { |
60 | 0 | return *((struct loader_dev_dispatch_table **)obj); |
61 | 0 | } Unexecuted instantiation: json_load_fuzzer.c:loader_get_dev_dispatch Unexecuted instantiation: cJSON.c:loader_get_dev_dispatch Unexecuted instantiation: loader.c:loader_get_dev_dispatch Unexecuted instantiation: loader_environment.c:loader_get_dev_dispatch Unexecuted instantiation: loader_linux.c:loader_get_dev_dispatch Unexecuted instantiation: settings.c:loader_get_dev_dispatch Unexecuted instantiation: terminator.c:loader_get_dev_dispatch Unexecuted instantiation: trampoline.c:loader_get_dev_dispatch Unexecuted instantiation: wsi.c:loader_get_dev_dispatch Unexecuted instantiation: debug_utils.c:loader_get_dev_dispatch Unexecuted instantiation: dev_ext_trampoline.c:loader_get_dev_dispatch Unexecuted instantiation: extension_manual.c:loader_get_dev_dispatch Unexecuted instantiation: gpa_helper.c:loader_get_dev_dispatch Unexecuted instantiation: phys_dev_ext.c:loader_get_dev_dispatch |
62 | | |
63 | 0 | static inline VkLayerInstanceDispatchTable *loader_get_instance_layer_dispatch(const void *obj) { |
64 | 0 | return *((VkLayerInstanceDispatchTable **)obj); |
65 | 0 | } Unexecuted instantiation: json_load_fuzzer.c:loader_get_instance_layer_dispatch Unexecuted instantiation: cJSON.c:loader_get_instance_layer_dispatch Unexecuted instantiation: loader.c:loader_get_instance_layer_dispatch Unexecuted instantiation: loader_environment.c:loader_get_instance_layer_dispatch Unexecuted instantiation: loader_linux.c:loader_get_instance_layer_dispatch Unexecuted instantiation: settings.c:loader_get_instance_layer_dispatch Unexecuted instantiation: terminator.c:loader_get_instance_layer_dispatch Unexecuted instantiation: trampoline.c:loader_get_instance_layer_dispatch Unexecuted instantiation: wsi.c:loader_get_instance_layer_dispatch Unexecuted instantiation: debug_utils.c:loader_get_instance_layer_dispatch Unexecuted instantiation: dev_ext_trampoline.c:loader_get_instance_layer_dispatch Unexecuted instantiation: extension_manual.c:loader_get_instance_layer_dispatch Unexecuted instantiation: gpa_helper.c:loader_get_instance_layer_dispatch Unexecuted instantiation: phys_dev_ext.c:loader_get_instance_layer_dispatch |
66 | | |
67 | 0 | static inline struct loader_instance_dispatch_table *loader_get_instance_dispatch(const void *obj) { |
68 | 0 | return *((struct loader_instance_dispatch_table **)obj); |
69 | 0 | } Unexecuted instantiation: json_load_fuzzer.c:loader_get_instance_dispatch Unexecuted instantiation: cJSON.c:loader_get_instance_dispatch Unexecuted instantiation: loader.c:loader_get_instance_dispatch Unexecuted instantiation: loader_environment.c:loader_get_instance_dispatch Unexecuted instantiation: loader_linux.c:loader_get_instance_dispatch Unexecuted instantiation: settings.c:loader_get_instance_dispatch Unexecuted instantiation: terminator.c:loader_get_instance_dispatch Unexecuted instantiation: trampoline.c:loader_get_instance_dispatch Unexecuted instantiation: wsi.c:loader_get_instance_dispatch Unexecuted instantiation: debug_utils.c:loader_get_instance_dispatch Unexecuted instantiation: dev_ext_trampoline.c:loader_get_instance_dispatch Unexecuted instantiation: extension_manual.c:loader_get_instance_dispatch Unexecuted instantiation: gpa_helper.c:loader_get_instance_dispatch Unexecuted instantiation: phys_dev_ext.c:loader_get_instance_dispatch |
70 | | |
71 | 0 | static inline void loader_init_dispatch(void *obj, const void *data) { |
72 | | #if defined(DEBUG) |
73 | | assert(valid_loader_magic_value(obj) && |
74 | | "Incompatible ICD, first dword must be initialized to " |
75 | | "ICD_LOADER_MAGIC. See loader/README.md for details."); |
76 | | #endif |
77 | |
|
78 | 0 | loader_set_dispatch(obj, data); |
79 | 0 | } Unexecuted instantiation: json_load_fuzzer.c:loader_init_dispatch Unexecuted instantiation: cJSON.c:loader_init_dispatch Unexecuted instantiation: loader.c:loader_init_dispatch Unexecuted instantiation: loader_environment.c:loader_init_dispatch Unexecuted instantiation: loader_linux.c:loader_init_dispatch Unexecuted instantiation: settings.c:loader_init_dispatch Unexecuted instantiation: terminator.c:loader_init_dispatch Unexecuted instantiation: trampoline.c:loader_init_dispatch Unexecuted instantiation: wsi.c:loader_init_dispatch Unexecuted instantiation: debug_utils.c:loader_init_dispatch Unexecuted instantiation: dev_ext_trampoline.c:loader_init_dispatch Unexecuted instantiation: extension_manual.c:loader_init_dispatch Unexecuted instantiation: gpa_helper.c:loader_init_dispatch Unexecuted instantiation: phys_dev_ext.c:loader_init_dispatch |
80 | | |
81 | | // Global variables used across files |
82 | | extern struct loader_struct loader; |
83 | | extern loader_platform_thread_mutex loader_lock; |
84 | | extern loader_platform_thread_mutex loader_preload_icd_lock; |
85 | | extern loader_platform_thread_mutex loader_global_instance_list_lock; |
86 | | |
87 | | bool compare_vk_extension_properties(const VkExtensionProperties *op1, const VkExtensionProperties *op2); |
88 | | |
89 | | VkResult loader_validate_layers(const struct loader_instance *inst, const uint32_t layer_count, |
90 | | const char *const *ppEnabledLayerNames, const struct loader_layer_list *list); |
91 | | |
92 | | VkResult loader_validate_instance_extensions(struct loader_instance *inst, const struct loader_extension_list *icd_exts, |
93 | | const struct loader_layer_list *instance_layer, |
94 | | const VkInstanceCreateInfo *pCreateInfo); |
95 | | |
96 | | void loader_initialize(void); |
97 | | void loader_release(void); |
98 | | void loader_preload_icds(void); |
99 | | void loader_unload_preloaded_icds(void); |
100 | | VkResult loader_init_library_list(struct loader_layer_list *instance_layers, loader_platform_dl_handle **libs); |
101 | | |
102 | | // Allocate a new string able to hold source_str and place it in dest_str |
103 | | VkResult loader_copy_to_new_str(const struct loader_instance *inst, const char *source_str, char **dest_str); |
104 | | |
105 | | // Allocate a loader_string_list with enough space for allocated_count strings inside of it |
106 | | VkResult create_string_list(const struct loader_instance *inst, uint32_t allocated_count, struct loader_string_list *string_list); |
107 | | // Resize if there isn't enough space, then add the string str to the end of the loader_string_list |
108 | | // This function takes ownership of the str passed in - but only when it succeeds |
109 | | VkResult append_str_to_string_list(const struct loader_instance *inst, struct loader_string_list *string_list, char *str); |
110 | | // Resize if there isn't enough space, then copy the string str to a new string the end of the loader_string_list |
111 | | // This function does not take ownership of the string, it merely copies it. |
112 | | // This function appends a null terminator to the string automatically |
113 | | VkResult copy_str_to_string_list(const struct loader_instance *inst, struct loader_string_list *string_list, const char *str, |
114 | | size_t str_len); |
115 | | |
116 | | // Free any string inside of loader_string_list and then free the list itself |
117 | | void free_string_list(const struct loader_instance *inst, struct loader_string_list *string_list); |
118 | | |
119 | | VkResult loader_init_generic_list(const struct loader_instance *inst, struct loader_generic_list *list_info, size_t element_size); |
120 | | bool has_vk_extension_property_array(const VkExtensionProperties *vk_ext_prop, const uint32_t count, |
121 | | const VkExtensionProperties *ext_array); |
122 | | bool has_vk_extension_property(const VkExtensionProperties *vk_ext_prop, const struct loader_extension_list *ext_list); |
123 | | // This function takes ownership of layer_property in the case that allocation fails |
124 | | VkResult loader_append_layer_property(const struct loader_instance *inst, struct loader_layer_list *layer_list, |
125 | | struct loader_layer_properties *layer_property); |
126 | | VkResult loader_add_layer_properties(const struct loader_instance *inst, struct loader_layer_list *layer_instance_list, cJSON *json, |
127 | | bool is_implicit, char *filename); |
128 | | bool loader_find_layer_name_in_list(const char *name, const struct loader_pointer_layer_list *layer_list); |
129 | | VkResult loader_add_layer_properties_to_list(const struct loader_instance *inst, struct loader_pointer_layer_list *list, |
130 | | struct loader_layer_properties *props); |
131 | | void loader_free_layer_properties(const struct loader_instance *inst, struct loader_layer_properties *layer_properties); |
132 | | bool loader_implicit_layer_is_enabled(const struct loader_instance *inst, const struct loader_envvar_filter *enable_filter, |
133 | | const struct loader_envvar_disable_layers_filter *disable_filter, |
134 | | const struct loader_layer_properties *prop); |
135 | | VkResult loader_add_meta_layer(const struct loader_instance *inst, const struct loader_envvar_filter *enable_filter, |
136 | | const struct loader_envvar_disable_layers_filter *disable_filter, |
137 | | struct loader_layer_properties *prop, struct loader_pointer_layer_list *target_list, |
138 | | struct loader_pointer_layer_list *expanded_target_list, const struct loader_layer_list *source_list, |
139 | | bool *out_found_all_component_layers); |
140 | | VkResult loader_add_to_ext_list(const struct loader_instance *inst, struct loader_extension_list *ext_list, |
141 | | uint32_t prop_list_count, const VkExtensionProperties *props); |
142 | | VkResult loader_add_device_extensions(const struct loader_instance *inst, |
143 | | PFN_vkEnumerateDeviceExtensionProperties fpEnumerateDeviceExtensionProperties, |
144 | | VkPhysicalDevice physical_device, const char *lib_name, |
145 | | struct loader_extension_list *ext_list); |
146 | | VkResult loader_init_generic_list(const struct loader_instance *inst, struct loader_generic_list *list_info, size_t element_size); |
147 | | void loader_destroy_generic_list(const struct loader_instance *inst, struct loader_generic_list *list); |
148 | | void loader_destroy_pointer_layer_list(const struct loader_instance *inst, struct loader_pointer_layer_list *layer_list); |
149 | | void loader_delete_layer_list_and_properties(const struct loader_instance *inst, struct loader_layer_list *layer_list); |
150 | | void loader_remove_layer_in_list(const struct loader_instance *inst, struct loader_layer_list *layer_list, |
151 | | uint32_t layer_to_remove); |
152 | | VkResult loader_scanned_icd_init(const struct loader_instance *inst, struct loader_icd_tramp_list *icd_tramp_list); |
153 | | void loader_scanned_icd_clear(const struct loader_instance *inst, struct loader_icd_tramp_list *icd_tramp_list); |
154 | | VkResult loader_icd_scan(const struct loader_instance *inst, struct loader_icd_tramp_list *icd_tramp_list, |
155 | | const VkInstanceCreateInfo *pCreateInfo, bool *skipped_portability_drivers); |
156 | | void loader_icd_destroy(struct loader_instance *ptr_inst, struct loader_icd_term *icd_term, |
157 | | const VkAllocationCallbacks *pAllocator); |
158 | | VkResult loader_scan_for_layers(struct loader_instance *inst, struct loader_layer_list *instance_layers); |
159 | | VkResult loader_scan_for_implicit_layers(struct loader_instance *inst, struct loader_layer_list *instance_layers); |
160 | | VkResult loader_get_icd_loader_instance_extensions(const struct loader_instance *inst, struct loader_icd_tramp_list *icd_tramp_list, |
161 | | struct loader_extension_list *inst_exts); |
162 | | struct loader_icd_term *loader_get_icd_and_device(const void *device, struct loader_device **found_dev, uint32_t *icd_index); |
163 | | struct loader_instance *loader_get_instance(const VkInstance instance); |
164 | | struct loader_device *loader_create_logical_device(const struct loader_instance *inst, const VkAllocationCallbacks *pAllocator); |
165 | | void loader_add_logical_device(const struct loader_instance *inst, struct loader_icd_term *icd_term, |
166 | | struct loader_device *found_dev); |
167 | | void loader_remove_logical_device(const struct loader_instance *inst, struct loader_icd_term *icd_term, |
168 | | struct loader_device *found_dev, const VkAllocationCallbacks *pAllocator); |
169 | | // NOTE: Outside of loader, this entry-point is only provided for error |
170 | | // cleanup. |
171 | | void loader_destroy_logical_device(const struct loader_instance *inst, struct loader_device *dev, |
172 | | const VkAllocationCallbacks *pAllocator); |
173 | | |
174 | | VkResult loader_enable_instance_layers(struct loader_instance *inst, const VkInstanceCreateInfo *pCreateInfo, |
175 | | const struct loader_layer_list *instance_layers); |
176 | | |
177 | | VkResult loader_create_instance_chain(const VkInstanceCreateInfo *pCreateInfo, const VkAllocationCallbacks *pAllocator, |
178 | | struct loader_instance *inst, VkInstance *created_instance); |
179 | | |
180 | | void loader_activate_instance_layer_extensions(struct loader_instance *inst, VkInstance created_inst); |
181 | | |
182 | | VKAPI_ATTR VkResult VKAPI_CALL loader_layer_create_device(VkInstance instance, VkPhysicalDevice physicalDevice, |
183 | | const VkDeviceCreateInfo *pCreateInfo, |
184 | | const VkAllocationCallbacks *pAllocator, VkDevice *pDevice, |
185 | | PFN_vkGetInstanceProcAddr layerGIPA, PFN_vkGetDeviceProcAddr *nextGDPA); |
186 | | VKAPI_ATTR void VKAPI_CALL loader_layer_destroy_device(VkDevice device, const VkAllocationCallbacks *pAllocator, |
187 | | PFN_vkDestroyDevice destroyFunction); |
188 | | |
189 | | VkResult loader_create_device_chain(const VkPhysicalDevice pd, const VkDeviceCreateInfo *pCreateInfo, |
190 | | const VkAllocationCallbacks *pAllocator, const struct loader_instance *inst, |
191 | | struct loader_device *dev, PFN_vkGetInstanceProcAddr callingLayer, |
192 | | PFN_vkGetDeviceProcAddr *layerNextGDPA); |
193 | | |
194 | | VkResult loader_validate_device_extensions(struct loader_instance *this_instance, |
195 | | const struct loader_pointer_layer_list *activated_device_layers, |
196 | | const struct loader_extension_list *icd_exts, const VkDeviceCreateInfo *pCreateInfo); |
197 | | |
198 | | VkResult setup_loader_tramp_phys_devs(struct loader_instance *inst, uint32_t phys_dev_count, VkPhysicalDevice *phys_devs); |
199 | | VkResult setup_loader_tramp_phys_dev_groups(struct loader_instance *inst, uint32_t group_count, |
200 | | VkPhysicalDeviceGroupProperties *groups); |
201 | | |
202 | | VkStringErrorFlags vk_string_validate(const int max_length, const char *char_array); |
203 | | char *loader_get_next_path(char *path); |
204 | | VkResult add_data_files(const struct loader_instance *inst, char *search_path, struct loader_string_list *out_files, |
205 | | bool use_first_found_manifest); |
206 | | |
207 | | loader_api_version loader_make_version(uint32_t version); |
208 | | loader_api_version loader_combine_version(uint32_t major, uint32_t minor, uint32_t patch); |
209 | | |
210 | | // Helper macros for determining if a version is valid or not |
211 | | bool loader_check_version_meets_required(loader_api_version required, loader_api_version version); |
212 | | |
213 | | // Convenience macros for common versions |
214 | | #if !defined(LOADER_VERSION_1_0_0) |
215 | 0 | #define LOADER_VERSION_1_0_0 loader_combine_version(1, 0, 0) |
216 | | #endif |
217 | | |
218 | | #if !defined(LOADER_VERSION_1_1_0) |
219 | 0 | #define LOADER_VERSION_1_1_0 loader_combine_version(1, 1, 0) |
220 | | #endif |