libdrm/radeon/radeon_bo.h

   1 /*
   2  * Copyright © 2008 Jérôme Glisse
   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
   7  * "Software"), to deal in the Software without restriction, including
   8  * without limitation the rights to use, copy, modify, merge, publish,
   9  * distribute, sub license, and/or sell copies of the Software, and to
  10  * permit persons to whom the Software is furnished to do so, subject to
  11  * the following conditions:
  12  *
  13  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
  14  * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
  15  * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL
  16  * THE COPYRIGHT HOLDERS, AUTHORS AND/OR ITS SUPPLIERS BE LIABLE FOR ANY CLAIM,
  17  * DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR
  18  * OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE
  19  * USE OR OTHER DEALINGS IN THE SOFTWARE.
  20  *
  21  * The above copyright notice and this permission notice (including the
  22  * next paragraph) shall be included in all copies or substantial portions
  23  * of the Software.
  24  */
  25 /*
  26  * Authors:
  27  *      Jérôme Glisse <glisse@freedesktop.org>
  28  */
  29 #ifndef RADEON_BO_H
  30 #define RADEON_BO_H
  31
  32 #include <stdio.h>
  33 #include <stdint.h>
  34
  35 /* bo object */
  36 #define RADEON_BO_FLAGS_MACRO_TILE  1
  37 #define RADEON_BO_FLAGS_MICRO_TILE  2
  38
  39 struct radeon_bo_manager;
  40
  41 struct radeon_bo {
  42     uint32_t                    alignment;
  43     uint32_t                    handle;
  44     uint32_t                    size;
  45     uint32_t                    flags;
  46     unsigned                    cref;
  47     void                        *ptr;
  48     struct radeon_bo_manager    *bom;
  49 };
  50
  51 /* bo functions */
  52 struct radeon_bo_funcs {
  53     struct radeon_bo *(*bo_open)(struct radeon_bo_manager *bom,
  54                                  uint32_t handle,
  55                                  uint32_t size,
  56                                  uint32_t alignment,
  57                                  uint32_t flags);
  58     void (*bo_ref)(struct radeon_bo *bo);
  59     void (*bo_unref)(struct radeon_bo *bo);
  60     int (*bo_map)(struct radeon_bo *bo, int write);
  61     int (*bo_unmap)(struct radeon_bo *bo);
  62 };
  63
  64 struct radeon_bo_manager {
  65     struct radeon_bo_funcs  *funcs;
  66     int                     fd;
  67 };
  68
  69 static inline void _radeon_bo_debug(struct radeon_bo *bo,
  70                                     int opcode,
  71                                     const char *file,
  72                                     const char *func,
  73                                     int line)
  74 {
  75     fprintf(stderr, "%02d %p 0x%08X 0x%08X [%s %s %d]\n",
  76             opcode, bo, bo->size, bo->cref, file, func, line);
  77 }
  78
  79 static inline struct radeon_bo *_radeon_bo_open(struct radeon_bo_manager *bom,
  80                                                 uint32_t handle,
  81                                                 uint32_t size,
  82                                                 uint32_t alignment,
  83                                                 uint32_t flags,
  84                                                 const char *file,
  85                                                 const char *func,
  86                                                 int line)
  87 {
  88     struct radeon_bo *bo;
  89     bo = bom->funcs->bo_open(bom, handle, size, alignment, flags);
  90 #ifdef RADEON_BO_TRACK_OPEN
  91     if (bo) {
  92         _radeon_bo_debug(bo, 1, file, func, line);
  93     }
  94 #endif
  95     return bo;
  96 }
  97
  98 static inline void _radeon_bo_ref(struct radeon_bo *bo,
  99                                   const char *file,
 100                                   const char *func,
 101                                   int line)
 102 {
 103     bo->cref++;
 104 #ifdef RADEON_BO_TRACK_REF
 105     _radeon_bo_debug(bo, 2, file, func, line);
 106 #endif
 107     bo->bom->funcs->bo_ref(bo);
 108 }
 109
 110 static inline void _radeon_bo_unref(struct radeon_bo *bo,
 111                                     const char *file,
 112                                     const char *func,
 113                                     int line)
 114 {
 115     bo->cref--;
 116 #ifdef RADEON_BO_TRACK_REF
 117     _radeon_bo_debug(bo, 3, file, func, line);
 118 #endif
 119     bo->bom->funcs->bo_unref(bo);
 120 }
 121
 122 static inline int _radeon_bo_map(struct radeon_bo *bo,
 123                                  int write,
 124                                  const char *file,
 125                                  const char *func,
 126                                  int line)
 127 {
 128 #ifdef RADEON_BO_TRACK_MAP
 129     _radeon_bo_debug(bo, 4, file, func, line);
 130 #endif
 131     return bo->bom->funcs->bo_map(bo, write);
 132 }
 133
 134 static inline int _radeon_bo_unmap(struct radeon_bo *bo,
 135                                    const char *file,
 136                                    const char *func,
 137                                    int line)
 138 {
 139 #ifdef RADEON_BO_TRACK_MAP
 140     _radeon_bo_debug(bo, 5, file, func, line);
 141 #endif
 142     return bo->bom->funcs->bo_unmap(bo);
 143 }
 144
 145 #define radeon_bo_open(bom, h, s, a, f)\
 146     _radeon_bo_open(bom, h, s, a, f, __FILE__, __FUNCTION__, __LINE__)
 147 #define radeon_bo_ref(bo)\
 148     _radeon_bo_ref(bo, __FILE__, __FUNCTION__, __LINE__)
 149 #define radeon_bo_unref(bo)\
 150     _radeon_bo_unref(bo, __FILE__, __FUNCTION__, __LINE__)
 151 #define radeon_bo_map(bo, w)\
 152     _radeon_bo_map(bo, w, __FILE__, __FUNCTION__, __LINE__)
 153 #define radeon_bo_unmap(bo)\
 154     _radeon_bo_unmap(bo, __FILE__, __FUNCTION__, __LINE__)
 155 #define radeon_bo_debug(bo, opcode)\
 156     _radeon_bo_debug(bo, opcode, __FILE__, __FUNCTION__, __LINE__)
 157
 158 #endif