1*4882a593Smuzhiyun /* 2*4882a593Smuzhiyun * Copyright © 2012 Red Hat 3*4882a593Smuzhiyun * Copyright 1999 Precision Insight, Inc., Cedar Park, Texas. 4*4882a593Smuzhiyun * Copyright 2000 VA Linux Systems, Inc., Sunnyvale, California. 5*4882a593Smuzhiyun * Copyright (c) 2009-2010, Code Aurora Forum. 6*4882a593Smuzhiyun * 7*4882a593Smuzhiyun * Permission is hereby granted, free of charge, to any person obtaining a 8*4882a593Smuzhiyun * copy of this software and associated documentation files (the "Software"), 9*4882a593Smuzhiyun * to deal in the Software without restriction, including without limitation 10*4882a593Smuzhiyun * the rights to use, copy, modify, merge, publish, distribute, sublicense, 11*4882a593Smuzhiyun * and/or sell copies of the Software, and to permit persons to whom the 12*4882a593Smuzhiyun * Software is furnished to do so, subject to the following conditions: 13*4882a593Smuzhiyun * 14*4882a593Smuzhiyun * The above copyright notice and this permission notice (including the next 15*4882a593Smuzhiyun * paragraph) shall be included in all copies or substantial portions of the 16*4882a593Smuzhiyun * Software. 17*4882a593Smuzhiyun * 18*4882a593Smuzhiyun * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR 19*4882a593Smuzhiyun * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, 20*4882a593Smuzhiyun * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL 21*4882a593Smuzhiyun * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER 22*4882a593Smuzhiyun * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING 23*4882a593Smuzhiyun * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS 24*4882a593Smuzhiyun * IN THE SOFTWARE. 25*4882a593Smuzhiyun * 26*4882a593Smuzhiyun * Authors: 27*4882a593Smuzhiyun * Dave Airlie <airlied@redhat.com> 28*4882a593Smuzhiyun * Rob Clark <rob.clark@linaro.org> 29*4882a593Smuzhiyun * 30*4882a593Smuzhiyun */ 31*4882a593Smuzhiyun 32*4882a593Smuzhiyun #ifndef __DRM_PRIME_H__ 33*4882a593Smuzhiyun #define __DRM_PRIME_H__ 34*4882a593Smuzhiyun 35*4882a593Smuzhiyun #include <linux/mutex.h> 36*4882a593Smuzhiyun #include <linux/rbtree.h> 37*4882a593Smuzhiyun #include <linux/scatterlist.h> 38*4882a593Smuzhiyun 39*4882a593Smuzhiyun /** 40*4882a593Smuzhiyun * struct drm_prime_file_private - per-file tracking for PRIME 41*4882a593Smuzhiyun * 42*4882a593Smuzhiyun * This just contains the internal &struct dma_buf and handle caches for each 43*4882a593Smuzhiyun * &struct drm_file used by the PRIME core code. 44*4882a593Smuzhiyun */ 45*4882a593Smuzhiyun struct drm_prime_file_private { 46*4882a593Smuzhiyun /* private: */ 47*4882a593Smuzhiyun struct mutex lock; 48*4882a593Smuzhiyun struct rb_root dmabufs; 49*4882a593Smuzhiyun struct rb_root handles; 50*4882a593Smuzhiyun }; 51*4882a593Smuzhiyun 52*4882a593Smuzhiyun struct device; 53*4882a593Smuzhiyun 54*4882a593Smuzhiyun struct dma_buf_export_info; 55*4882a593Smuzhiyun struct dma_buf; 56*4882a593Smuzhiyun struct dma_buf_attachment; 57*4882a593Smuzhiyun 58*4882a593Smuzhiyun enum dma_data_direction; 59*4882a593Smuzhiyun 60*4882a593Smuzhiyun struct drm_device; 61*4882a593Smuzhiyun struct drm_gem_object; 62*4882a593Smuzhiyun struct drm_file; 63*4882a593Smuzhiyun 64*4882a593Smuzhiyun /* core prime functions */ 65*4882a593Smuzhiyun struct dma_buf *drm_gem_dmabuf_export(struct drm_device *dev, 66*4882a593Smuzhiyun struct dma_buf_export_info *exp_info); 67*4882a593Smuzhiyun void drm_gem_dmabuf_release(struct dma_buf *dma_buf); 68*4882a593Smuzhiyun 69*4882a593Smuzhiyun int drm_gem_prime_fd_to_handle(struct drm_device *dev, 70*4882a593Smuzhiyun struct drm_file *file_priv, int prime_fd, uint32_t *handle); 71*4882a593Smuzhiyun int drm_gem_prime_handle_to_fd(struct drm_device *dev, 72*4882a593Smuzhiyun struct drm_file *file_priv, uint32_t handle, uint32_t flags, 73*4882a593Smuzhiyun int *prime_fd); 74*4882a593Smuzhiyun 75*4882a593Smuzhiyun /* helper functions for exporting */ 76*4882a593Smuzhiyun int drm_gem_map_attach(struct dma_buf *dma_buf, 77*4882a593Smuzhiyun struct dma_buf_attachment *attach); 78*4882a593Smuzhiyun void drm_gem_map_detach(struct dma_buf *dma_buf, 79*4882a593Smuzhiyun struct dma_buf_attachment *attach); 80*4882a593Smuzhiyun struct sg_table *drm_gem_map_dma_buf(struct dma_buf_attachment *attach, 81*4882a593Smuzhiyun enum dma_data_direction dir); 82*4882a593Smuzhiyun void drm_gem_unmap_dma_buf(struct dma_buf_attachment *attach, 83*4882a593Smuzhiyun struct sg_table *sgt, 84*4882a593Smuzhiyun enum dma_data_direction dir); 85*4882a593Smuzhiyun void *drm_gem_dmabuf_vmap(struct dma_buf *dma_buf); 86*4882a593Smuzhiyun void drm_gem_dmabuf_vunmap(struct dma_buf *dma_buf, void *vaddr); 87*4882a593Smuzhiyun 88*4882a593Smuzhiyun int drm_gem_prime_mmap(struct drm_gem_object *obj, struct vm_area_struct *vma); 89*4882a593Smuzhiyun int drm_gem_dmabuf_mmap(struct dma_buf *dma_buf, struct vm_area_struct *vma); 90*4882a593Smuzhiyun 91*4882a593Smuzhiyun struct sg_table *drm_prime_pages_to_sg(struct drm_device *dev, 92*4882a593Smuzhiyun struct page **pages, unsigned int nr_pages); 93*4882a593Smuzhiyun struct dma_buf *drm_gem_prime_export(struct drm_gem_object *obj, 94*4882a593Smuzhiyun int flags); 95*4882a593Smuzhiyun 96*4882a593Smuzhiyun unsigned long drm_prime_get_contiguous_size(struct sg_table *sgt); 97*4882a593Smuzhiyun 98*4882a593Smuzhiyun /* helper functions for importing */ 99*4882a593Smuzhiyun struct drm_gem_object *drm_gem_prime_import_dev(struct drm_device *dev, 100*4882a593Smuzhiyun struct dma_buf *dma_buf, 101*4882a593Smuzhiyun struct device *attach_dev); 102*4882a593Smuzhiyun struct drm_gem_object *drm_gem_prime_import(struct drm_device *dev, 103*4882a593Smuzhiyun struct dma_buf *dma_buf); 104*4882a593Smuzhiyun 105*4882a593Smuzhiyun void drm_prime_gem_destroy(struct drm_gem_object *obj, struct sg_table *sg); 106*4882a593Smuzhiyun 107*4882a593Smuzhiyun int drm_prime_sg_to_page_addr_arrays(struct sg_table *sgt, struct page **pages, 108*4882a593Smuzhiyun dma_addr_t *addrs, int max_pages); 109*4882a593Smuzhiyun 110*4882a593Smuzhiyun int drm_gem_dmabuf_get_uuid(struct dma_buf *dma_buf, uuid_t *uuid); 111*4882a593Smuzhiyun 112*4882a593Smuzhiyun #endif /* __DRM_PRIME_H__ */ 113