Home | History | Annotate | Download | only in common
      1 /*
      2  * (C) Copyright IBM Corporation 2002, 2004
      3  * All Rights Reserved.
      4  *
      5  * Permission is hereby granted, free of charge, to any person obtaining a
      6  * copy of this software and associated documentation files (the "Software"),
      7  * to deal in the Software without restriction, including without limitation
      8  * on the rights to use, copy, modify, merge, publish, distribute, sub
      9  * license, and/or sell copies of the Software, and to permit persons to whom
     10  * the Software is furnished to do so, subject to the following conditions:
     11  *
     12  * The above copyright notice and this permission notice (including the next
     13  * paragraph) shall be included in all copies or substantial portions of the
     14  * Software.
     15  *
     16  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
     17  * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
     18  * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT.  IN NO EVENT SHALL
     19  * THE AUTHORS AND/OR THEIR SUPPLIERS BE LIABLE FOR ANY CLAIM,
     20  * DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR
     21  * OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE
     22  * USE OR OTHER DEALINGS IN THE SOFTWARE.
     23  */
     24 
     25 /**
     26  * \file dri_util.c
     27  * DRI utility functions.
     28  *
     29  * This module acts as glue between GLX and the actual hardware driver.  A DRI
     30  * driver doesn't really \e have to use any of this - it's optional.  But, some
     31  * useful stuff is done here that otherwise would have to be duplicated in most
     32  * drivers.
     33  *
     34  * Basically, these utility functions take care of some of the dirty details of
     35  * screen initialization, context creation, context binding, DRM setup, etc.
     36  *
     37  * These functions are compiled into each DRI driver so libGL.so knows nothing
     38  * about them.
     39  */
     40 
     41 
     42 #include <stdbool.h>
     43 #include "dri_util.h"
     44 #include "utils.h"
     45 #include "xmlpool.h"
     46 #include "main/mtypes.h"
     47 #include "main/framebuffer.h"
     48 #include "main/version.h"
     49 #include "main/debug_output.h"
     50 #include "main/errors.h"
     51 #include "main/macros.h"
     52 
     53 const char __dri2ConfigOptions[] =
     54    DRI_CONF_BEGIN
     55       DRI_CONF_SECTION_PERFORMANCE
     56          DRI_CONF_VBLANK_MODE(DRI_CONF_VBLANK_DEF_INTERVAL_1)
     57       DRI_CONF_SECTION_END
     58    DRI_CONF_END;
     59 
     60 /*****************************************************************/
     61 /** \name Screen handling functions                              */
     62 /*****************************************************************/
     63 /*@{*/
     64 
     65 static void
     66 setupLoaderExtensions(__DRIscreen *psp,
     67 		      const __DRIextension **extensions)
     68 {
     69     int i;
     70 
     71     for (i = 0; extensions[i]; i++) {
     72 	if (strcmp(extensions[i]->name, __DRI_DRI2_LOADER) == 0)
     73 	    psp->dri2.loader = (__DRIdri2LoaderExtension *) extensions[i];
     74 	if (strcmp(extensions[i]->name, __DRI_IMAGE_LOOKUP) == 0)
     75 	    psp->dri2.image = (__DRIimageLookupExtension *) extensions[i];
     76 	if (strcmp(extensions[i]->name, __DRI_USE_INVALIDATE) == 0)
     77 	    psp->dri2.useInvalidate = (__DRIuseInvalidateExtension *) extensions[i];
     78 	if (strcmp(extensions[i]->name, __DRI_SWRAST_LOADER) == 0)
     79 	    psp->swrast_loader = (__DRIswrastLoaderExtension *) extensions[i];
     80         if (strcmp(extensions[i]->name, __DRI_IMAGE_LOADER) == 0)
     81            psp->image.loader = (__DRIimageLoaderExtension *) extensions[i];
     82     }
     83 }
     84 
     85 /**
     86  * This pointer determines which driver API we'll use in the case of the
     87  * loader not passing us an explicit driver extensions list (that would,
     88  * itself, contain a pointer to a driver API.)
     89  *
     90  * A driver's driDriverGetExtensions_drivername() can update this pointer to
     91  * what it's returning, and a loader that is ignorant of createNewScreen2()
     92  * will get the correct driver screen created, as long as no other
     93  * driDriverGetExtensions() happened in between the first one and the
     94  * createNewScreen().
     95  *
     96  * This allows the X Server to not require the significant dri_interface.h
     97  * updates for doing createNewScreen2(), which would discourage backporting of
     98  * the X Server patches to support the new loader interface.
     99  */
    100 const struct __DriverAPIRec *globalDriverAPI = &driDriverAPI;
    101 
    102 /**
    103  * This is the first entrypoint in the driver called by the DRI driver loader
    104  * after dlopen()ing it.
    105  *
    106  * It's used to create global state for the driver across contexts on the same
    107  * Display.
    108  */
    109 static __DRIscreen *
    110 driCreateNewScreen2(int scrn, int fd,
    111                     const __DRIextension **extensions,
    112                     const __DRIextension **driver_extensions,
    113                     const __DRIconfig ***driver_configs, void *data)
    114 {
    115     static const __DRIextension *emptyExtensionList[] = { NULL };
    116     __DRIscreen *psp;
    117 
    118     psp = calloc(1, sizeof(*psp));
    119     if (!psp)
    120 	return NULL;
    121 
    122     /* By default, use the global driDriverAPI symbol (non-megadrivers). */
    123     psp->driver = globalDriverAPI;
    124 
    125     /* If the driver exposes its vtable through its extensions list
    126      * (megadrivers), use that instead.
    127      */
    128     if (driver_extensions) {
    129        for (int i = 0; driver_extensions[i]; i++) {
    130           if (strcmp(driver_extensions[i]->name, __DRI_DRIVER_VTABLE) == 0) {
    131              psp->driver =
    132                 ((__DRIDriverVtableExtension *)driver_extensions[i])->vtable;
    133           }
    134        }
    135     }
    136 
    137     setupLoaderExtensions(psp, extensions);
    138 
    139     psp->loaderPrivate = data;
    140 
    141     psp->extensions = emptyExtensionList;
    142     psp->fd = fd;
    143     psp->myNum = scrn;
    144 
    145     *driver_configs = psp->driver->InitScreen(psp);
    146     if (*driver_configs == NULL) {
    147 	free(psp);
    148 	return NULL;
    149     }
    150 
    151     struct gl_constants consts = { 0 };
    152     gl_api api;
    153     unsigned version;
    154 
    155     api = API_OPENGLES2;
    156     if (_mesa_override_gl_version_contextless(&consts, &api, &version))
    157        psp->max_gl_es2_version = version;
    158 
    159     api = API_OPENGL_COMPAT;
    160     if (_mesa_override_gl_version_contextless(&consts, &api, &version)) {
    161        if (api == API_OPENGL_CORE) {
    162           psp->max_gl_core_version = version;
    163        } else {
    164           psp->max_gl_compat_version = version;
    165        }
    166     }
    167 
    168     psp->api_mask = 0;
    169     if (psp->max_gl_compat_version > 0)
    170        psp->api_mask |= (1 << __DRI_API_OPENGL);
    171     if (psp->max_gl_core_version > 0)
    172        psp->api_mask |= (1 << __DRI_API_OPENGL_CORE);
    173     if (psp->max_gl_es1_version > 0)
    174        psp->api_mask |= (1 << __DRI_API_GLES);
    175     if (psp->max_gl_es2_version > 0)
    176        psp->api_mask |= (1 << __DRI_API_GLES2);
    177     if (psp->max_gl_es2_version >= 30)
    178        psp->api_mask |= (1 << __DRI_API_GLES3);
    179 
    180     driParseOptionInfo(&psp->optionInfo, __dri2ConfigOptions);
    181     driParseConfigFiles(&psp->optionCache, &psp->optionInfo, psp->myNum, "dri2");
    182 
    183 
    184     return psp;
    185 }
    186 
    187 static __DRIscreen *
    188 dri2CreateNewScreen(int scrn, int fd,
    189 		    const __DRIextension **extensions,
    190 		    const __DRIconfig ***driver_configs, void *data)
    191 {
    192    return driCreateNewScreen2(scrn, fd, extensions, NULL,
    193                                driver_configs, data);
    194 }
    195 
    196 /** swrast driver createNewScreen entrypoint. */
    197 static __DRIscreen *
    198 driSWRastCreateNewScreen(int scrn, const __DRIextension **extensions,
    199                          const __DRIconfig ***driver_configs, void *data)
    200 {
    201    return driCreateNewScreen2(scrn, -1, extensions, NULL,
    202                                driver_configs, data);
    203 }
    204 
    205 static __DRIscreen *
    206 driSWRastCreateNewScreen2(int scrn, const __DRIextension **extensions,
    207                           const __DRIextension **driver_extensions,
    208                           const __DRIconfig ***driver_configs, void *data)
    209 {
    210    return driCreateNewScreen2(scrn, -1, extensions, driver_extensions,
    211                                driver_configs, data);
    212 }
    213 
    214 /**
    215  * Destroy the per-screen private information.
    216  *
    217  * \internal
    218  * This function calls __DriverAPIRec::DestroyScreen on \p screenPrivate, calls
    219  * drmClose(), and finally frees \p screenPrivate.
    220  */
    221 static void driDestroyScreen(__DRIscreen *psp)
    222 {
    223     if (psp) {
    224 	/* No interaction with the X-server is possible at this point.  This
    225 	 * routine is called after XCloseDisplay, so there is no protocol
    226 	 * stream open to the X-server anymore.
    227 	 */
    228 
    229 	psp->driver->DestroyScreen(psp);
    230 
    231 	driDestroyOptionCache(&psp->optionCache);
    232 	driDestroyOptionInfo(&psp->optionInfo);
    233 
    234 	free(psp);
    235     }
    236 }
    237 
    238 static const __DRIextension **driGetExtensions(__DRIscreen *psp)
    239 {
    240     return psp->extensions;
    241 }
    242 
    243 /*@}*/
    244 
    245 
    246 static bool
    247 validate_context_version(__DRIscreen *screen,
    248                          int mesa_api,
    249                          unsigned major_version,
    250                          unsigned minor_version,
    251                          unsigned *dri_ctx_error)
    252 {
    253    unsigned req_version = 10 * major_version + minor_version;
    254    unsigned max_version = 0;
    255 
    256    switch (mesa_api) {
    257    case API_OPENGL_COMPAT:
    258       max_version = screen->max_gl_compat_version;
    259       break;
    260    case API_OPENGL_CORE:
    261       max_version = screen->max_gl_core_version;
    262       break;
    263    case API_OPENGLES:
    264       max_version = screen->max_gl_es1_version;
    265       break;
    266    case API_OPENGLES2:
    267       max_version = screen->max_gl_es2_version;
    268       break;
    269    default:
    270       max_version = 0;
    271       break;
    272    }
    273 
    274    if (max_version == 0) {
    275       *dri_ctx_error = __DRI_CTX_ERROR_BAD_API;
    276       return false;
    277    } else if (req_version > max_version) {
    278       *dri_ctx_error = __DRI_CTX_ERROR_BAD_VERSION;
    279       return false;
    280    }
    281 
    282    return true;
    283 }
    284 
    285 /*****************************************************************/
    286 /** \name Context handling functions                             */
    287 /*****************************************************************/
    288 /*@{*/
    289 
    290 static __DRIcontext *
    291 driCreateContextAttribs(__DRIscreen *screen, int api,
    292                         const __DRIconfig *config,
    293                         __DRIcontext *shared,
    294                         unsigned num_attribs,
    295                         const uint32_t *attribs,
    296                         unsigned *error,
    297                         void *data)
    298 {
    299     __DRIcontext *context;
    300     const struct gl_config *modes = (config != NULL) ? &config->modes : NULL;
    301     void *shareCtx = (shared != NULL) ? shared->driverPrivate : NULL;
    302     gl_api mesa_api;
    303     unsigned major_version = 1;
    304     unsigned minor_version = 0;
    305     uint32_t flags = 0;
    306     bool notify_reset = false;
    307 
    308     assert((num_attribs == 0) || (attribs != NULL));
    309 
    310     if (!(screen->api_mask & (1 << api))) {
    311 	*error = __DRI_CTX_ERROR_BAD_API;
    312 	return NULL;
    313     }
    314 
    315     switch (api) {
    316     case __DRI_API_OPENGL:
    317 	mesa_api = API_OPENGL_COMPAT;
    318 	break;
    319     case __DRI_API_GLES:
    320 	mesa_api = API_OPENGLES;
    321 	break;
    322     case __DRI_API_GLES2:
    323     case __DRI_API_GLES3:
    324 	mesa_api = API_OPENGLES2;
    325 	break;
    326     case __DRI_API_OPENGL_CORE:
    327         mesa_api = API_OPENGL_CORE;
    328         break;
    329     default:
    330 	*error = __DRI_CTX_ERROR_BAD_API;
    331 	return NULL;
    332     }
    333 
    334     for (unsigned i = 0; i < num_attribs; i++) {
    335 	switch (attribs[i * 2]) {
    336 	case __DRI_CTX_ATTRIB_MAJOR_VERSION:
    337 	    major_version = attribs[i * 2 + 1];
    338 	    break;
    339 	case __DRI_CTX_ATTRIB_MINOR_VERSION:
    340 	    minor_version = attribs[i * 2 + 1];
    341 	    break;
    342 	case __DRI_CTX_ATTRIB_FLAGS:
    343 	    flags = attribs[i * 2 + 1];
    344 	    break;
    345         case __DRI_CTX_ATTRIB_RESET_STRATEGY:
    346             notify_reset = (attribs[i * 2 + 1]
    347                             != __DRI_CTX_RESET_NO_NOTIFICATION);
    348             break;
    349 	default:
    350 	    /* We can't create a context that satisfies the requirements of an
    351 	     * attribute that we don't understand.  Return failure.
    352 	     */
    353 	    assert(!"Should not get here.");
    354 	    *error = __DRI_CTX_ERROR_UNKNOWN_ATTRIBUTE;
    355 	    return NULL;
    356 	}
    357     }
    358 
    359     /* Mesa does not support the GL_ARB_compatibilty extension or the
    360      * compatibility profile.  This means that we treat a API_OPENGL_COMPAT 3.1 as
    361      * API_OPENGL_CORE and reject API_OPENGL_COMPAT 3.2+.
    362      */
    363     if (mesa_api == API_OPENGL_COMPAT && major_version == 3 && minor_version == 1)
    364        mesa_api = API_OPENGL_CORE;
    365 
    366     if (mesa_api == API_OPENGL_COMPAT
    367         && ((major_version > 3)
    368             || (major_version == 3 && minor_version >= 2))) {
    369        *error = __DRI_CTX_ERROR_BAD_API;
    370        return NULL;
    371     }
    372 
    373     /* The latest version of EGL_KHR_create_context spec says:
    374      *
    375      *     "If the EGL_CONTEXT_OPENGL_DEBUG_BIT_KHR flag bit is set in
    376      *     EGL_CONTEXT_FLAGS_KHR, then a <debug context> will be created.
    377      *     [...] This bit is supported for OpenGL and OpenGL ES contexts.
    378      *
    379      * No other EGL_CONTEXT_OPENGL_*_BIT is legal for an ES context.
    380      *
    381      * However, Mesa's EGL layer translates the context attribute
    382      * EGL_CONTEXT_OPENGL_ROBUST_ACCESS into the context flag
    383      * __DRI_CTX_FLAG_ROBUST_BUFFER_ACCESS.  That attribute is legal for ES
    384      * (with EGL 1.5 or EGL_EXT_create_context_robustness) and GL (only with
    385      * EGL 1.5).
    386      *
    387      * From the EGL_EXT_create_context_robustness spec:
    388      *
    389      *     This extension is written against the OpenGL ES 2.0 Specification
    390      *     but can apply to OpenGL ES 1.1 and up.
    391      *
    392      * From the EGL 1.5 (2014.08.27) spec, p55:
    393      *
    394      *     If the EGL_CONTEXT_OPENGL_ROBUST_ACCESS attribute is set to
    395      *     EGL_TRUE, a context supporting robust buffer access will be created.
    396      *     OpenGL contexts must support the GL_ARB_robustness extension, or
    397      *     equivalent core API functional- ity. OpenGL ES contexts must support
    398      *     the GL_EXT_robustness extension, or equivalent core API
    399      *     functionality.
    400      */
    401     if (mesa_api != API_OPENGL_COMPAT
    402         && mesa_api != API_OPENGL_CORE
    403         && (flags & ~(__DRI_CTX_FLAG_DEBUG |
    404 	              __DRI_CTX_FLAG_ROBUST_BUFFER_ACCESS))) {
    405 	*error = __DRI_CTX_ERROR_BAD_FLAG;
    406 	return NULL;
    407     }
    408 
    409     /* There are no forward-compatible contexts before OpenGL 3.0.  The
    410      * GLX_ARB_create_context spec says:
    411      *
    412      *     "Forward-compatible contexts are defined only for OpenGL versions
    413      *     3.0 and later."
    414      *
    415      * Forward-looking contexts are supported by silently converting the
    416      * requested API to API_OPENGL_CORE.
    417      *
    418      * In Mesa, a debug context is the same as a regular context.
    419      */
    420     if ((flags & __DRI_CTX_FLAG_FORWARD_COMPATIBLE) != 0) {
    421        mesa_api = API_OPENGL_CORE;
    422     }
    423 
    424     const uint32_t allowed_flags = (__DRI_CTX_FLAG_DEBUG
    425                                     | __DRI_CTX_FLAG_FORWARD_COMPATIBLE
    426                                     | __DRI_CTX_FLAG_ROBUST_BUFFER_ACCESS);
    427     if (flags & ~allowed_flags) {
    428 	*error = __DRI_CTX_ERROR_UNKNOWN_FLAG;
    429 	return NULL;
    430     }
    431 
    432     if (!validate_context_version(screen, mesa_api,
    433                                   major_version, minor_version, error))
    434        return NULL;
    435 
    436     context = calloc(1, sizeof *context);
    437     if (!context) {
    438 	*error = __DRI_CTX_ERROR_NO_MEMORY;
    439 	return NULL;
    440     }
    441 
    442     context->loaderPrivate = data;
    443 
    444     context->driScreenPriv = screen;
    445     context->driDrawablePriv = NULL;
    446     context->driReadablePriv = NULL;
    447 
    448     if (!screen->driver->CreateContext(mesa_api, modes, context,
    449                                        major_version, minor_version,
    450                                        flags, notify_reset, error, shareCtx)) {
    451         free(context);
    452         return NULL;
    453     }
    454 
    455     *error = __DRI_CTX_ERROR_SUCCESS;
    456     return context;
    457 }
    458 
    459 void
    460 driContextSetFlags(struct gl_context *ctx, uint32_t flags)
    461 {
    462     if ((flags & __DRI_CTX_FLAG_FORWARD_COMPATIBLE) != 0)
    463         ctx->Const.ContextFlags |= GL_CONTEXT_FLAG_FORWARD_COMPATIBLE_BIT;
    464     if ((flags & __DRI_CTX_FLAG_DEBUG) != 0) {
    465        _mesa_set_debug_state_int(ctx, GL_DEBUG_OUTPUT, GL_TRUE);
    466         ctx->Const.ContextFlags |= GL_CONTEXT_FLAG_DEBUG_BIT;
    467     }
    468 }
    469 
    470 static __DRIcontext *
    471 driCreateNewContextForAPI(__DRIscreen *screen, int api,
    472                           const __DRIconfig *config,
    473                           __DRIcontext *shared, void *data)
    474 {
    475     unsigned error;
    476 
    477     return driCreateContextAttribs(screen, api, config, shared, 0, NULL,
    478                                    &error, data);
    479 }
    480 
    481 static __DRIcontext *
    482 driCreateNewContext(__DRIscreen *screen, const __DRIconfig *config,
    483                     __DRIcontext *shared, void *data)
    484 {
    485     return driCreateNewContextForAPI(screen, __DRI_API_OPENGL,
    486                                      config, shared, data);
    487 }
    488 
    489 /**
    490  * Destroy the per-context private information.
    491  *
    492  * \internal
    493  * This function calls __DriverAPIRec::DestroyContext on \p contextPrivate, calls
    494  * drmDestroyContext(), and finally frees \p contextPrivate.
    495  */
    496 static void
    497 driDestroyContext(__DRIcontext *pcp)
    498 {
    499     if (pcp) {
    500 	pcp->driScreenPriv->driver->DestroyContext(pcp);
    501 	free(pcp);
    502     }
    503 }
    504 
    505 static int
    506 driCopyContext(__DRIcontext *dest, __DRIcontext *src, unsigned long mask)
    507 {
    508     (void) dest;
    509     (void) src;
    510     (void) mask;
    511     return GL_FALSE;
    512 }
    513 
    514 /*@}*/
    515 
    516 
    517 /*****************************************************************/
    518 /** \name Context (un)binding functions                          */
    519 /*****************************************************************/
    520 /*@{*/
    521 
    522 static void dri_get_drawable(__DRIdrawable *pdp);
    523 static void dri_put_drawable(__DRIdrawable *pdp);
    524 
    525 /**
    526  * This function takes both a read buffer and a draw buffer.  This is needed
    527  * for \c glXMakeCurrentReadSGI or GLX 1.3's \c glXMakeContextCurrent
    528  * function.
    529  */
    530 static int driBindContext(__DRIcontext *pcp,
    531 			  __DRIdrawable *pdp,
    532 			  __DRIdrawable *prp)
    533 {
    534     /*
    535     ** Assume error checking is done properly in glXMakeCurrent before
    536     ** calling driUnbindContext.
    537     */
    538 
    539     if (!pcp)
    540 	return GL_FALSE;
    541 
    542     /* Bind the drawable to the context */
    543     pcp->driDrawablePriv = pdp;
    544     pcp->driReadablePriv = prp;
    545     if (pdp) {
    546 	pdp->driContextPriv = pcp;
    547 	dri_get_drawable(pdp);
    548     }
    549     if (prp && pdp != prp) {
    550 	dri_get_drawable(prp);
    551     }
    552 
    553     return pcp->driScreenPriv->driver->MakeCurrent(pcp, pdp, prp);
    554 }
    555 
    556 /**
    557  * Unbind context.
    558  *
    559  * \param scrn the screen.
    560  * \param gc context.
    561  *
    562  * \return \c GL_TRUE on success, or \c GL_FALSE on failure.
    563  *
    564  * \internal
    565  * This function calls __DriverAPIRec::UnbindContext, and then decrements
    566  * __DRIdrawableRec::refcount which must be non-zero for a successful
    567  * return.
    568  *
    569  * While casting the opaque private pointers associated with the parameters
    570  * into their respective real types it also assures they are not \c NULL.
    571  */
    572 static int driUnbindContext(__DRIcontext *pcp)
    573 {
    574     __DRIdrawable *pdp;
    575     __DRIdrawable *prp;
    576 
    577     /*
    578     ** Assume error checking is done properly in glXMakeCurrent before
    579     ** calling driUnbindContext.
    580     */
    581 
    582     if (pcp == NULL)
    583 	return GL_FALSE;
    584 
    585     /*
    586     ** Call driUnbindContext before checking for valid drawables
    587     ** to handle surfaceless contexts properly.
    588     */
    589     pcp->driScreenPriv->driver->UnbindContext(pcp);
    590 
    591     pdp = pcp->driDrawablePriv;
    592     prp = pcp->driReadablePriv;
    593 
    594     /* already unbound */
    595     if (!pdp && !prp)
    596 	return GL_TRUE;
    597 
    598     assert(pdp);
    599     if (pdp->refcount == 0) {
    600 	/* ERROR!!! */
    601 	return GL_FALSE;
    602     }
    603 
    604     dri_put_drawable(pdp);
    605 
    606     if (prp != pdp) {
    607 	if (prp->refcount == 0) {
    608 	    /* ERROR!!! */
    609 	    return GL_FALSE;
    610 	}
    611 
    612 	dri_put_drawable(prp);
    613     }
    614 
    615     pcp->driDrawablePriv = NULL;
    616     pcp->driReadablePriv = NULL;
    617 
    618     return GL_TRUE;
    619 }
    620 
    621 /*@}*/
    622 
    623 
    624 static void dri_get_drawable(__DRIdrawable *pdp)
    625 {
    626     pdp->refcount++;
    627 }
    628 
    629 static void dri_put_drawable(__DRIdrawable *pdp)
    630 {
    631     if (pdp) {
    632 	pdp->refcount--;
    633 	if (pdp->refcount)
    634 	    return;
    635 
    636 	pdp->driScreenPriv->driver->DestroyBuffer(pdp);
    637 	free(pdp);
    638     }
    639 }
    640 
    641 static __DRIdrawable *
    642 driCreateNewDrawable(__DRIscreen *screen,
    643                      const __DRIconfig *config,
    644                      void *data)
    645 {
    646     __DRIdrawable *pdraw;
    647 
    648     assert(data != NULL);
    649 
    650     pdraw = malloc(sizeof *pdraw);
    651     if (!pdraw)
    652 	return NULL;
    653 
    654     pdraw->loaderPrivate = data;
    655 
    656     pdraw->driScreenPriv = screen;
    657     pdraw->driContextPriv = NULL;
    658     pdraw->refcount = 0;
    659     pdraw->lastStamp = 0;
    660     pdraw->w = 0;
    661     pdraw->h = 0;
    662 
    663     dri_get_drawable(pdraw);
    664 
    665     if (!screen->driver->CreateBuffer(screen, pdraw, &config->modes,
    666                                       GL_FALSE)) {
    667        free(pdraw);
    668        return NULL;
    669     }
    670 
    671     pdraw->dri2.stamp = pdraw->lastStamp + 1;
    672 
    673     return pdraw;
    674 }
    675 
    676 static void
    677 driDestroyDrawable(__DRIdrawable *pdp)
    678 {
    679     /*
    680      * The loader's data structures are going away, even if pdp itself stays
    681      * around for the time being because it is currently bound. This happens
    682      * when a currently bound GLX pixmap is destroyed.
    683      *
    684      * Clear out the pointer back into the loader's data structures to avoid
    685      * accessing an outdated pointer.
    686      */
    687     pdp->loaderPrivate = NULL;
    688 
    689     dri_put_drawable(pdp);
    690 }
    691 
    692 static __DRIbuffer *
    693 dri2AllocateBuffer(__DRIscreen *screen,
    694 		   unsigned int attachment, unsigned int format,
    695 		   int width, int height)
    696 {
    697     return screen->driver->AllocateBuffer(screen, attachment, format,
    698                                           width, height);
    699 }
    700 
    701 static void
    702 dri2ReleaseBuffer(__DRIscreen *screen, __DRIbuffer *buffer)
    703 {
    704     screen->driver->ReleaseBuffer(screen, buffer);
    705 }
    706 
    707 
    708 static int
    709 dri2ConfigQueryb(__DRIscreen *screen, const char *var, unsigned char *val)
    710 {
    711    if (!driCheckOption(&screen->optionCache, var, DRI_BOOL))
    712       return -1;
    713 
    714    *val = driQueryOptionb(&screen->optionCache, var);
    715 
    716    return 0;
    717 }
    718 
    719 static int
    720 dri2ConfigQueryi(__DRIscreen *screen, const char *var, int *val)
    721 {
    722    if (!driCheckOption(&screen->optionCache, var, DRI_INT) &&
    723        !driCheckOption(&screen->optionCache, var, DRI_ENUM))
    724       return -1;
    725 
    726     *val = driQueryOptioni(&screen->optionCache, var);
    727 
    728     return 0;
    729 }
    730 
    731 static int
    732 dri2ConfigQueryf(__DRIscreen *screen, const char *var, float *val)
    733 {
    734    if (!driCheckOption(&screen->optionCache, var, DRI_FLOAT))
    735       return -1;
    736 
    737     *val = driQueryOptionf(&screen->optionCache, var);
    738 
    739     return 0;
    740 }
    741 
    742 static unsigned int
    743 driGetAPIMask(__DRIscreen *screen)
    744 {
    745     return screen->api_mask;
    746 }
    747 
    748 /**
    749  * swrast swapbuffers entrypoint.
    750  *
    751  * DRI2 implements this inside the loader with only flushes handled by the
    752  * driver.
    753  */
    754 static void
    755 driSwapBuffers(__DRIdrawable *pdp)
    756 {
    757     assert(pdp->driScreenPriv->swrast_loader);
    758 
    759     pdp->driScreenPriv->driver->SwapBuffers(pdp);
    760 }
    761 
    762 /** Core interface */
    763 const __DRIcoreExtension driCoreExtension = {
    764     .base = { __DRI_CORE, 1 },
    765 
    766     .createNewScreen            = NULL,
    767     .destroyScreen              = driDestroyScreen,
    768     .getExtensions              = driGetExtensions,
    769     .getConfigAttrib            = driGetConfigAttrib,
    770     .indexConfigAttrib          = driIndexConfigAttrib,
    771     .createNewDrawable          = NULL,
    772     .destroyDrawable            = driDestroyDrawable,
    773     .swapBuffers                = driSwapBuffers, /* swrast */
    774     .createNewContext           = driCreateNewContext, /* swrast */
    775     .copyContext                = driCopyContext,
    776     .destroyContext             = driDestroyContext,
    777     .bindContext                = driBindContext,
    778     .unbindContext              = driUnbindContext
    779 };
    780 
    781 /** DRI2 interface */
    782 const __DRIdri2Extension driDRI2Extension = {
    783     .base = { __DRI_DRI2, 4 },
    784 
    785     .createNewScreen            = dri2CreateNewScreen,
    786     .createNewDrawable          = driCreateNewDrawable,
    787     .createNewContext           = driCreateNewContext,
    788     .getAPIMask                 = driGetAPIMask,
    789     .createNewContextForAPI     = driCreateNewContextForAPI,
    790     .allocateBuffer             = dri2AllocateBuffer,
    791     .releaseBuffer              = dri2ReleaseBuffer,
    792     .createContextAttribs       = driCreateContextAttribs,
    793     .createNewScreen2           = driCreateNewScreen2,
    794 };
    795 
    796 const __DRIswrastExtension driSWRastExtension = {
    797     .base = { __DRI_SWRAST, 4 },
    798 
    799     .createNewScreen            = driSWRastCreateNewScreen,
    800     .createNewDrawable          = driCreateNewDrawable,
    801     .createNewContextForAPI     = driCreateNewContextForAPI,
    802     .createContextAttribs       = driCreateContextAttribs,
    803     .createNewScreen2           = driSWRastCreateNewScreen2,
    804 };
    805 
    806 const __DRI2configQueryExtension dri2ConfigQueryExtension = {
    807    .base = { __DRI2_CONFIG_QUERY, 1 },
    808 
    809    .configQueryb        = dri2ConfigQueryb,
    810    .configQueryi        = dri2ConfigQueryi,
    811    .configQueryf        = dri2ConfigQueryf,
    812 };
    813 
    814 void
    815 dri2InvalidateDrawable(__DRIdrawable *drawable)
    816 {
    817     drawable->dri2.stamp++;
    818 }
    819 
    820 /**
    821  * Check that the gl_framebuffer associated with dPriv is the right size.
    822  * Resize the gl_framebuffer if needed.
    823  * It's expected that the dPriv->driverPrivate member points to a
    824  * gl_framebuffer object.
    825  */
    826 void
    827 driUpdateFramebufferSize(struct gl_context *ctx, const __DRIdrawable *dPriv)
    828 {
    829    struct gl_framebuffer *fb = (struct gl_framebuffer *) dPriv->driverPrivate;
    830    if (fb && (dPriv->w != fb->Width || dPriv->h != fb->Height)) {
    831       _mesa_resize_framebuffer(ctx, fb, dPriv->w, dPriv->h);
    832       /* if the driver needs the hw lock for ResizeBuffers, the drawable
    833          might have changed again by now */
    834       assert(fb->Width == dPriv->w);
    835       assert(fb->Height == dPriv->h);
    836    }
    837 }
    838 
    839 uint32_t
    840 driGLFormatToImageFormat(mesa_format format)
    841 {
    842    switch (format) {
    843    case MESA_FORMAT_B5G6R5_UNORM:
    844       return __DRI_IMAGE_FORMAT_RGB565;
    845    case MESA_FORMAT_B5G5R5A1_UNORM:
    846       return __DRI_IMAGE_FORMAT_ARGB1555;
    847    case MESA_FORMAT_B8G8R8X8_UNORM:
    848       return __DRI_IMAGE_FORMAT_XRGB8888;
    849    case MESA_FORMAT_B10G10R10A2_UNORM:
    850       return __DRI_IMAGE_FORMAT_ARGB2101010;
    851    case MESA_FORMAT_B10G10R10X2_UNORM:
    852       return __DRI_IMAGE_FORMAT_XRGB2101010;
    853    case MESA_FORMAT_B8G8R8A8_UNORM:
    854       return __DRI_IMAGE_FORMAT_ARGB8888;
    855    case MESA_FORMAT_R8G8B8A8_UNORM:
    856       return __DRI_IMAGE_FORMAT_ABGR8888;
    857    case MESA_FORMAT_R8G8B8X8_UNORM:
    858       return __DRI_IMAGE_FORMAT_XBGR8888;
    859    case MESA_FORMAT_L_UNORM8:
    860    case MESA_FORMAT_R_UNORM8:
    861       return __DRI_IMAGE_FORMAT_R8;
    862    case MESA_FORMAT_L8A8_UNORM:
    863    case MESA_FORMAT_R8G8_UNORM:
    864       return __DRI_IMAGE_FORMAT_GR88;
    865    case MESA_FORMAT_NONE:
    866       return __DRI_IMAGE_FORMAT_NONE;
    867    case MESA_FORMAT_B8G8R8A8_SRGB:
    868       return __DRI_IMAGE_FORMAT_SARGB8;
    869    default:
    870       return 0;
    871    }
    872 }
    873 
    874 mesa_format
    875 driImageFormatToGLFormat(uint32_t image_format)
    876 {
    877    switch (image_format) {
    878    case __DRI_IMAGE_FORMAT_RGB565:
    879       return MESA_FORMAT_B5G6R5_UNORM;
    880    case __DRI_IMAGE_FORMAT_ARGB1555:
    881       return MESA_FORMAT_B5G5R5A1_UNORM;
    882    case __DRI_IMAGE_FORMAT_XRGB8888:
    883       return MESA_FORMAT_B8G8R8X8_UNORM;
    884    case __DRI_IMAGE_FORMAT_ARGB2101010:
    885       return MESA_FORMAT_B10G10R10A2_UNORM;
    886    case __DRI_IMAGE_FORMAT_XRGB2101010:
    887       return MESA_FORMAT_B10G10R10X2_UNORM;
    888    case __DRI_IMAGE_FORMAT_ARGB8888:
    889       return MESA_FORMAT_B8G8R8A8_UNORM;
    890    case __DRI_IMAGE_FORMAT_ABGR8888:
    891       return MESA_FORMAT_R8G8B8A8_UNORM;
    892    case __DRI_IMAGE_FORMAT_XBGR8888:
    893       return MESA_FORMAT_R8G8B8X8_UNORM;
    894    case __DRI_IMAGE_FORMAT_R8:
    895       return MESA_FORMAT_R_UNORM8;
    896    case __DRI_IMAGE_FORMAT_GR88:
    897       return MESA_FORMAT_R8G8_UNORM;
    898    case __DRI_IMAGE_FORMAT_SARGB8:
    899       return MESA_FORMAT_B8G8R8A8_SRGB;
    900    case __DRI_IMAGE_FORMAT_NONE:
    901       return MESA_FORMAT_NONE;
    902    default:
    903       return MESA_FORMAT_NONE;
    904    }
    905 }
    906 
    907 /** Image driver interface */
    908 const __DRIimageDriverExtension driImageDriverExtension = {
    909     .base = { __DRI_IMAGE_DRIVER, 1 },
    910 
    911     .createNewScreen2           = driCreateNewScreen2,
    912     .createNewDrawable          = driCreateNewDrawable,
    913     .getAPIMask                 = driGetAPIMask,
    914     .createContextAttribs       = driCreateContextAttribs,
    915 };
    916 
    917 /* swrast copy sub buffer entrypoint. */
    918 static void driCopySubBuffer(__DRIdrawable *pdp, int x, int y,
    919                              int w, int h)
    920 {
    921     assert(pdp->driScreenPriv->swrast_loader);
    922 
    923     pdp->driScreenPriv->driver->CopySubBuffer(pdp, x, y, w, h);
    924 }
    925 
    926 /* for swrast only */
    927 const __DRIcopySubBufferExtension driCopySubBufferExtension = {
    928    .base = { __DRI_COPY_SUB_BUFFER, 1 },
    929 
    930    .copySubBuffer               = driCopySubBuffer,
    931 };
    932