• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1 /*
2  * Copyright (C) 2013 Rob Clark <robclark@freedesktop.org>
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 <robclark@freedesktop.org>
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 "GL/internal/dri_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 const struct __DRIextensionRec **
73 loader_open_driver(const char *driver_name,
74                    void **out_driver_handle,
75                    const char **search_path_vars);
76 
77 char *
78 loader_get_device_name_for_fd(int fd);
79 
80 /* For dri prime gpu offloading this function will take current render fd and possibly
81  * update it with new prime gpu offloading fd. For dri prime gpu offloading optionally
82  * this function can return the original fd. Also this function returns true/false based
83  * on render gpu is different from display gpu.
84  */
85 
86 bool
87 loader_get_user_preferred_fd(int *fd_render_gpu, int *original_fd);
88 
89 /* for logging.. keep this aligned with egllog.h so we can just use
90  * _eglLog directly.
91  */
92 
93 #define _LOADER_FATAL   0   /* unrecoverable error */
94 #define _LOADER_WARNING 1   /* recoverable error/problem */
95 #define _LOADER_INFO    2   /* just useful info */
96 #define _LOADER_DEBUG   3   /* useful info for debugging */
97 
98 typedef void loader_logger(int level, const char *fmt, ...);
99 void
100 loader_set_logger(loader_logger *logger);
101 
102 char *
103 loader_get_extensions_name(const char *driver_name);
104 
105 struct dri_extension_match {
106    /* __DRI_* extension name */
107    const char *name;
108 
109    /* Required minimum version in the extension struct */
110    int version;
111 
112    /* offset in the data arg at which to store a pointer to the extension */
113    int offset;
114 
115    bool optional;
116 };
117 
118 bool loader_bind_extensions(void *data,
119                             const struct dri_extension_match *matches, size_t num_matches,
120                             const __DRIextension **extensions);
121 
122 #ifdef __cplusplus
123 }
124 #endif
125 
126 #endif /* LOADER_H */
127