Coverage Report

Created: 2023-06-07 06:30

/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