1 /**************************************************************************
3 * Copyright 2012 Francisco Jerez
6 * Permission is hereby granted, free of charge, to any person obtaining a
7 * copy of this software and associated documentation files (the
8 * "Software"), to deal in the Software without restriction, including
9 * without limitation the rights to use, copy, modify, merge, publish,
10 * distribute, sub license, and/or sell copies of the Software, and to
11 * permit persons to whom the Software is furnished to do so, subject to
12 * the following conditions:
14 * The above copyright notice and this permission notice (including the
15 * next paragraph) shall be included in all copies or substantial portions
18 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
19 * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
20 * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT.
21 * IN NO EVENT SHALL VMWARE AND/OR ITS SUPPLIERS BE LIABLE FOR
22 * ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
23 * TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
24 * SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
26 **************************************************************************/
29 * \file Library that provides device enumeration and creation of
30 * winsys/pipe_screen instances.
36 #include "pipe/p_compiler.h"
38 #ifdef HAVE_WINSYS_XLIB
48 enum pipe_loader_device_type
{
49 PIPE_LOADER_DEVICE_SOFTWARE
,
50 PIPE_LOADER_DEVICE_PCI
,
51 PIPE_LOADER_DEVICE_PLATFORM
,
52 NUM_PIPE_LOADER_DEVICE_TYPES
56 * A device known to the pipe loader.
58 struct pipe_loader_device
{
59 enum pipe_loader_device_type type
;
66 } u
; /**< Discriminated by \a type */
68 const char *driver_name
;
69 const struct pipe_loader_ops
*ops
;
73 * Get a list of known devices.
75 * \param devs Array that will be filled with pointers to the devices
76 * available in the system.
77 * \param ndev Maximum number of devices to return.
78 * \return Number of devices available in the system.
81 pipe_loader_probe(struct pipe_loader_device
**devs
, int ndev
);
84 * Create a pipe_screen for the specified device.
86 * \param dev Device the screen will be created for.
87 * \param library_paths Colon-separated list of filesystem paths that
88 * will be used to look for the pipe driver
89 * module that handles this device.
92 pipe_loader_create_screen(struct pipe_loader_device
*dev
,
93 const char *library_paths
);
96 * Release resources allocated for a list of devices.
98 * Should be called when the specified devices are no longer in use to
99 * release any resources allocated by pipe_loader_probe.
101 * \param devs Devices to release.
102 * \param ndev Number of devices to release.
105 pipe_loader_release(struct pipe_loader_device
**devs
, int ndev
);
107 #ifdef HAVE_WINSYS_XLIB
110 * Initialize Xlib for an associated display.
112 * This function is platform-specific.
114 * \sa pipe_loader_probe
117 pipe_loader_sw_probe_xlib(struct pipe_loader_device
**devs
, Display
*display
);
122 * Get a list of known software devices.
124 * This function is platform-specific.
126 * \sa pipe_loader_probe
129 pipe_loader_sw_probe(struct pipe_loader_device
**devs
, int ndev
);
131 #ifdef HAVE_PIPE_LOADER_DRM
134 * Get a list of known DRM devices.
136 * This function is platform-specific.
138 * \sa pipe_loader_probe
141 pipe_loader_drm_probe(struct pipe_loader_device
**devs
, int ndev
);
144 * Initialize a DRM device in an already opened fd.
146 * This function is platform-specific.
148 * \sa pipe_loader_probe
150 * \param auth_x If true, the pipe-loader will attempt to
151 * authenticate with the X server.
154 pipe_loader_drm_probe_fd(struct pipe_loader_device
**dev
, int fd
,
163 #endif /* PIPE_LOADER_H */