• 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 "mesa_interface.h"
34 
35 #ifdef __cplusplus
36 extern "C" {
37 #endif
38 
39 /* Helpers to figure out driver and device name, eg. from pci-id, etc. */
40 
41 int
42 loader_open_device(const char *);
43 
44 char *
45 loader_get_kernel_driver_name(int fd);
46 
47 int
48 loader_open_render_node_platform_device(const char * const drivers[],
49                                         unsigned int n_drivers);
50 
51 bool
52 loader_is_device_render_capable(int fd);
53 
54 char *
55 loader_get_render_node(dev_t device);
56 
57 bool
58 loader_get_pci_id_for_fd(int fd, int *vendor_id, int *chip_id);
59 
60 char *
61 loader_get_driver_for_fd(int fd);
62 
63 void *
64 loader_open_driver_lib(const char *driver_name,
65                        const char *lib_suffix,
66                        const char **search_path_vars,
67                        const char *default_search_path,
68                        bool warn_on_fail);
69 
70 char *
71 loader_get_device_name_for_fd(int fd);
72 
73 /* For dri prime gpu offloading this function will take current render fd and possibly
74  * update it with new prime gpu offloading fd. For dri prime gpu offloading optionally
75  * this function can return the original fd. Also this function returns true/false based
76  * on render gpu is different from display gpu.
77  */
78 
79 bool
80 loader_get_user_preferred_fd(int *fd_render_gpu, int *original_fd);
81 
82 /* for logging.. keep this aligned with egllog.h so we can just use
83  * _eglLog directly.
84  */
85 
86 #define _LOADER_FATAL   0   /* unrecoverable error */
87 #define _LOADER_WARNING 1   /* recoverable error/problem */
88 #define _LOADER_INFO    2   /* just useful info */
89 #define _LOADER_DEBUG   3   /* useful info for debugging */
90 
91 typedef void loader_logger(int level, const char *fmt, ...);
92 void
93 loader_set_logger(loader_logger *logger);
94 
95 struct dri_extension_match {
96    /* __DRI_* extension name */
97    const char *name;
98 
99    /* Required minimum version in the extension struct */
100    int version;
101 
102    /* offset in the data arg at which to store a pointer to the extension */
103    int offset;
104 
105    bool optional;
106 };
107 
108 bool loader_bind_extensions(void *data,
109                             const struct dri_extension_match *matches, size_t num_matches,
110                             const __DRIextension **extensions);
111 
112 #ifdef __cplusplus
113 }
114 #endif
115 
116 #endif /* LOADER_H */
117