1 // SPDX-License-Identifier: GPL-2.0-or-later
3 #include <linux/module.h>
5 #include <drm/drm_gem_ttm_helper.h>
10 * This library provides helper functions for gem objects backed by
15 * drm_gem_ttm_print_info() - Print &ttm_buffer_object info for debugfs
17 * @indent: Tab indentation level
20 * This function can be used as &drm_gem_object_funcs.print_info
23 void drm_gem_ttm_print_info(struct drm_printer *p, unsigned int indent,
24 const struct drm_gem_object *gem)
26 static const char * const plname[] = {
27 [ TTM_PL_SYSTEM ] = "system",
29 [ TTM_PL_VRAM ] = "vram",
30 [ TTM_PL_PRIV ] = "priv",
37 [ 21 ] = "pinned", /* NO_EVICT */
40 const struct ttm_buffer_object *bo = drm_gem_ttm_of_gem(gem);
42 drm_printf_indent(p, indent, "placement=");
43 drm_print_bits(p, bo->resource->placement, plname, ARRAY_SIZE(plname));
46 if (bo->resource->bus.is_iomem)
47 drm_printf_indent(p, indent, "bus.offset=%lx\n",
48 (unsigned long)bo->resource->bus.offset);
50 EXPORT_SYMBOL(drm_gem_ttm_print_info);
53 * drm_gem_ttm_vmap() - vmap &ttm_buffer_object
55 * @map: [out] returns the dma-buf mapping.
57 * Maps a GEM object with ttm_bo_vmap(). This function can be used as
58 * &drm_gem_object_funcs.vmap callback.
61 * 0 on success, or a negative errno code otherwise.
63 int drm_gem_ttm_vmap(struct drm_gem_object *gem,
64 struct dma_buf_map *map)
66 struct ttm_buffer_object *bo = drm_gem_ttm_of_gem(gem);
69 dma_resv_lock(gem->resv, NULL);
70 ret = ttm_bo_vmap(bo, map);
71 dma_resv_unlock(gem->resv);
75 EXPORT_SYMBOL(drm_gem_ttm_vmap);
78 * drm_gem_ttm_vunmap() - vunmap &ttm_buffer_object
80 * @map: dma-buf mapping.
82 * Unmaps a GEM object with ttm_bo_vunmap(). This function can be used as
83 * &drm_gem_object_funcs.vmap callback.
85 void drm_gem_ttm_vunmap(struct drm_gem_object *gem,
86 struct dma_buf_map *map)
88 struct ttm_buffer_object *bo = drm_gem_ttm_of_gem(gem);
90 dma_resv_lock(gem->resv, NULL);
91 ttm_bo_vunmap(bo, map);
92 dma_resv_unlock(gem->resv);
94 EXPORT_SYMBOL(drm_gem_ttm_vunmap);
97 * drm_gem_ttm_mmap() - mmap &ttm_buffer_object
101 * This function can be used as &drm_gem_object_funcs.mmap
104 int drm_gem_ttm_mmap(struct drm_gem_object *gem,
105 struct vm_area_struct *vma)
107 struct ttm_buffer_object *bo = drm_gem_ttm_of_gem(gem);
110 ret = ttm_bo_mmap_obj(vma, bo);
115 * ttm has its own object refcounting, so drop gem reference
116 * to avoid double accounting counting.
118 drm_gem_object_put(gem);
122 EXPORT_SYMBOL(drm_gem_ttm_mmap);
125 * drm_gem_ttm_dumb_map_offset() - Implements struct &drm_driver.dumb_map_offset
126 * @file: DRM file pointer.
128 * @handle: GEM handle
129 * @offset: Returns the mapping's memory offset on success
131 * Provides an implementation of struct &drm_driver.dumb_map_offset for
132 * TTM-based GEM drivers. TTM allocates the offset internally and
133 * drm_gem_ttm_dumb_map_offset() returns it for dumb-buffer implementations.
135 * See struct &drm_driver.dumb_map_offset.
138 * 0 on success, or a negative errno code otherwise.
140 int drm_gem_ttm_dumb_map_offset(struct drm_file *file, struct drm_device *dev,
141 uint32_t handle, uint64_t *offset)
143 struct drm_gem_object *gem;
145 gem = drm_gem_object_lookup(file, handle);
149 *offset = drm_vma_node_offset_addr(&gem->vma_node);
151 drm_gem_object_put(gem);
155 EXPORT_SYMBOL(drm_gem_ttm_dumb_map_offset);
157 MODULE_DESCRIPTION("DRM gem ttm helpers");
158 MODULE_LICENSE("GPL");