xref: /aosp_15_r20/external/mesa3d/src/loader/loader.h (revision 6104692788411f58d303aa86923a9ff6ecaded22)
1 /*
2  * Copyright (C) 2013 Rob Clark <[email protected]>
3  *
4  * Permission is hereby granted, free of charge, to any person obtaining a
5  * copy of this software and associated documentation files (the "Software"),
6  * to deal in the Software without restriction, including without limitation
7  * the rights to use, copy, modify, merge, publish, distribute, sublicense,
8  * and/or sell copies of the Software, and to permit persons to whom the
9  * Software is furnished to do so, subject to the following conditions:
10  *
11  * The above copyright notice and this permission notice (including the next
12  * paragraph) shall be included in all copies or substantial portions of the
13  * Software.
14  *
15  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16  * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17  * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL
18  * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19  * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20  * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21  * SOFTWARE.
22  *
23  * Authors:
24  *    Rob Clark <[email protected]>
25  */
26 
27 #ifndef LOADER_H
28 #define LOADER_H
29 
30 #include <stdbool.h>
31 #include <sys/stat.h>
32 #include <stddef.h>
33 #include "mesa_interface.h"
34 
35 #ifdef __cplusplus
36 extern "C" {
37 #endif
38 
39 struct __DRIextensionRec;
40 
41 /* Helpers to figure out driver and device name, eg. from pci-id, etc. */
42 
43 int
44 loader_open_device(const char *);
45 
46 char *
47 loader_get_kernel_driver_name(int fd);
48 
49 int
50 loader_open_render_node_platform_device(const char * const drivers[],
51                                         unsigned int n_drivers);
52 
53 bool
54 loader_is_device_render_capable(int fd);
55 
56 char *
57 loader_get_render_node(dev_t device);
58 
59 bool
60 loader_get_pci_id_for_fd(int fd, int *vendor_id, int *chip_id);
61 
62 char *
63 loader_get_driver_for_fd(int fd);
64 
65 void *
66 loader_open_driver_lib(const char *driver_name,
67                        const char *lib_suffix,
68                        const char **search_path_vars,
69                        const char *default_search_path,
70                        bool warn_on_fail);
71 
72 char *
73 loader_get_device_name_for_fd(int fd);
74 
75 /* For dri prime gpu offloading this function will take current render fd and possibly
76  * update it with new prime gpu offloading fd. For dri prime gpu offloading optionally
77  * this function can return the original fd. Also this function returns true/false based
78  * on render gpu is different from display gpu.
79  */
80 
81 bool
82 loader_get_user_preferred_fd(int *fd_render_gpu, int *original_fd);
83 
84 /* for logging.. keep this aligned with egllog.h so we can just use
85  * _eglLog directly.
86  */
87 
88 #define _LOADER_FATAL   0   /* unrecoverable error */
89 #define _LOADER_WARNING 1   /* recoverable error/problem */
90 #define _LOADER_INFO    2   /* just useful info */
91 #define _LOADER_DEBUG   3   /* useful info for debugging */
92 
93 typedef void loader_logger(int level, const char *fmt, ...);
94 void
95 loader_set_logger(loader_logger *logger);
96 
97 struct dri_extension_match {
98    /* __DRI_* extension name */
99    const char *name;
100 
101    /* Required minimum version in the extension struct */
102    int version;
103 
104    /* offset in the data arg at which to store a pointer to the extension */
105    int offset;
106 
107    bool optional;
108 };
109 
110 bool loader_bind_extensions(void *data,
111                             const struct dri_extension_match *matches, size_t num_matches,
112                             const __DRIextension **extensions);
113 
114 #ifdef __cplusplus
115 }
116 #endif
117 
118 #endif /* LOADER_H */
119