src/gallium/auxiliary/pipe-loader/pipe_loader.h

   1 /**************************************************************************
   2  *
   3  * Copyright 2012 Francisco Jerez
   4  * All Rights Reserved.
   5  *
   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:
  13  *
  14  * The above copyright notice and this permission notice (including the
  15  * next paragraph) shall be included in all copies or substantial portions
  16  * of the Software.
  17  *
  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.
  25  *
  26  **************************************************************************/
  27
  28 /**
  29  * \file Library that provides device enumeration and creation of
  30  * winsys/pipe_screen instances.
  31  */
  32
  33 #ifndef PIPE_LOADER_H
  34 #define PIPE_LOADER_H
  35
  36 #include "pipe/p_compiler.h"
  37 #include "state_tracker/drm_driver.h"
  38 #include "util/xmlconfig.h"
  39
  40 #ifdef __cplusplus
  41 extern "C" {
  42 #endif
  43
  44 struct pipe_screen;
  45 struct drisw_loader_funcs;
  46
  47 enum pipe_loader_device_type {
  48    PIPE_LOADER_DEVICE_SOFTWARE,
  49    PIPE_LOADER_DEVICE_PCI,
  50    PIPE_LOADER_DEVICE_PLATFORM,
  51    NUM_PIPE_LOADER_DEVICE_TYPES
  52 };
  53
  54 /**
  55  * A device known to the pipe loader.
  56  */
  57 struct pipe_loader_device {
  58    enum pipe_loader_device_type type;
  59
  60    union {
  61       struct {
  62          int vendor_id;
  63          int chip_id;
  64       } pci;
  65    } u; /**< Discriminated by \a type */
  66
  67    char *driver_name;
  68    const struct pipe_loader_ops *ops;
  69
  70    driOptionCache option_cache;
  71    driOptionCache option_info;
  72 };
  73
  74 /**
  75  * Get a list of known devices.
  76  *
  77  * \param devs Array that will be filled with pointers to the devices
  78  *             available in the system.
  79  * \param ndev Maximum number of devices to return.
  80  * \return Number of devices available in the system.
  81  */
  82 int
  83 pipe_loader_probe(struct pipe_loader_device **devs, int ndev);
  84
  85 /**
  86  * Create a pipe_screen for the specified device.
  87  *
  88  * \param dev Device the screen will be created for.
  89  */
  90 struct pipe_screen *
  91 pipe_loader_create_screen(struct pipe_loader_device *dev);
  92
  93 /**
  94  * Query the configuration parameters for the specified device.
  95  *
  96  * \param dev Device that will be queried.
  97  * \param conf The drm_conf id of the option to be queried.
  98  */
  99 const struct drm_conf_ret *
 100 pipe_loader_configuration(struct pipe_loader_device *dev,
 101                           enum drm_conf conf);
 102
 103 /**
 104  * Ensure that dev->option_cache is initialized appropriately for the driver.
 105  *
 106  * This function can be called multiple times.
 107  *
 108  * \param dev Device for which options should be loaded.
 109  */
 110 void
 111 pipe_loader_load_options(struct pipe_loader_device *dev);
 112
 113 /**
 114  * Get the driinfo XML string used by the given driver.
 115  *
 116  * The returned string is heap-allocated.
 117  */
 118 char *
 119 pipe_loader_get_driinfo_xml(const char *driver_name);
 120
 121 /**
 122  * Release resources allocated for a list of devices.
 123  *
 124  * Should be called when the specified devices are no longer in use to
 125  * release any resources allocated by pipe_loader_probe.
 126  *
 127  * \param devs Devices to release.
 128  * \param ndev Number of devices to release.
 129  */
 130 void
 131 pipe_loader_release(struct pipe_loader_device **devs, int ndev);
 132
 133 /**
 134  * Initialize sw dri device give the drisw_loader_funcs.
 135  *
 136  * This function is platform-specific.
 137  *
 138  * Function does not take ownership of the fd, but duplicates it locally.
 139  * The local fd is closed during pipe_loader_release.
 140  *
 141  * \sa pipe_loader_probe
 142  */
 143 bool
 144 pipe_loader_sw_probe_dri(struct pipe_loader_device **devs,
 145                          const struct drisw_loader_funcs *drisw_lf);
 146
 147 /**
 148  * Initialize a kms backed sw device given an fd.
 149  *
 150  * This function is platform-specific.
 151  *
 152  * Function does not take ownership of the fd, but duplicates it locally.
 153  * The local fd is closed during pipe_loader_release.
 154  *
 155  * \sa pipe_loader_probe
 156  */
 157 bool
 158 pipe_loader_sw_probe_kms(struct pipe_loader_device **devs, int fd);
 159
 160 /**
 161  * Initialize a null sw device.
 162  *
 163  * This function is platform-specific.
 164  *
 165  * \sa pipe_loader_probe
 166  */
 167 bool
 168 pipe_loader_sw_probe_null(struct pipe_loader_device **devs);
 169
 170 /**
 171  * Get a list of known software devices.
 172  *
 173  * This function is platform-specific.
 174  *
 175  * \sa pipe_loader_probe
 176  */
 177 int
 178 pipe_loader_sw_probe(struct pipe_loader_device **devs, int ndev);
 179
 180 /**
 181  * Get a software device wrapped atop another device.
 182  *
 183  * This function is platform-specific.
 184  *
 185  * \sa pipe_loader_probe
 186  */
 187 boolean
 188 pipe_loader_sw_probe_wrapped(struct pipe_loader_device **dev,
 189                              struct pipe_screen *screen);
 190
 191 /**
 192  * Get a list of known DRM devices.
 193  *
 194  * This function is platform-specific.
 195  *
 196  * \sa pipe_loader_probe
 197  */
 198 int
 199 pipe_loader_drm_probe(struct pipe_loader_device **devs, int ndev);
 200
 201 /**
 202  * Initialize a DRM device in an already opened fd.
 203  *
 204  * This function is platform-specific.
 205  *
 206  * \sa pipe_loader_probe
 207  */
 208 bool
 209 pipe_loader_drm_probe_fd(struct pipe_loader_device **dev, int fd);
 210
 211 /**
 212  * Get the driinfo XML used for the DRM driver of the given name, if any.
 213  *
 214  * The returned string is heap-allocated.
 215  */
 216 char *
 217 pipe_loader_drm_get_driinfo_xml(const char *driver_name);
 218
 219 extern const char gallium_driinfo_xml[];
 220
 221 #ifdef __cplusplus
 222 }
 223 #endif
 224
 225 #endif /* PIPE_LOADER_H */