mirror of
https://mirrors.bfsu.edu.cn/git/linux.git
synced 2024-11-17 09:14:19 +08:00
7938f42181
Rename struct dma_buf_map to struct iosys_map and corresponding APIs. Over time dma-buf-map grew up to more functionality than the one used by dma-buf: in fact it's just a shim layer to abstract system memory, that can be accessed via regular load and store, from IO memory that needs to be acessed via arch helpers. The idea is to extend this API so it can fulfill other needs, internal to a single driver. Example: in the i915 driver it's desired to share the implementation for integrated graphics, which uses mostly system memory, with discrete graphics, which may need to access IO memory. The conversion was mostly done with the following semantic patch: @r1@ @@ - struct dma_buf_map + struct iosys_map @r2@ @@ ( - DMA_BUF_MAP_INIT_VADDR + IOSYS_MAP_INIT_VADDR | - dma_buf_map_set_vaddr + iosys_map_set_vaddr | - dma_buf_map_set_vaddr_iomem + iosys_map_set_vaddr_iomem | - dma_buf_map_is_equal + iosys_map_is_equal | - dma_buf_map_is_null + iosys_map_is_null | - dma_buf_map_is_set + iosys_map_is_set | - dma_buf_map_clear + iosys_map_clear | - dma_buf_map_memcpy_to + iosys_map_memcpy_to | - dma_buf_map_incr + iosys_map_incr ) @@ @@ - #include <linux/dma-buf-map.h> + #include <linux/iosys-map.h> Then some files had their includes adjusted and some comments were update to remove mentions to dma-buf-map. Since this is not specific to dma-buf anymore, move the documentation to the "Bus-Independent Device Accesses" section. v2: - Squash patches v3: - Fix wrong removal of dma-buf.h from MAINTAINERS - Move documentation from dma-buf.rst to device-io.rst v4: - Change documentation title and level Signed-off-by: Lucas De Marchi <lucas.demarchi@intel.com> Acked-by: Christian König <christian.koenig@amd.com> Acked-by: Sumit Semwal <sumit.semwal@linaro.org> Acked-by: Thomas Zimmermann <tzimmermann@suse.de> Link: https://patchwork.freedesktop.org/patch/msgid/20220204170541.829227-1-lucas.demarchi@intel.com
114 lines
4.1 KiB
C
114 lines
4.1 KiB
C
/*
|
|
* Copyright © 2012 Red Hat
|
|
* Copyright 1999 Precision Insight, Inc., Cedar Park, Texas.
|
|
* Copyright 2000 VA Linux Systems, Inc., Sunnyvale, California.
|
|
* Copyright (c) 2009-2010, Code Aurora Forum.
|
|
*
|
|
* Permission is hereby granted, free of charge, to any person obtaining a
|
|
* copy of this software and associated documentation files (the "Software"),
|
|
* to deal in the Software without restriction, including without limitation
|
|
* the rights to use, copy, modify, merge, publish, distribute, sublicense,
|
|
* and/or sell copies of the Software, and to permit persons to whom the
|
|
* Software is furnished to do so, subject to the following conditions:
|
|
*
|
|
* The above copyright notice and this permission notice (including the next
|
|
* paragraph) shall be included in all copies or substantial portions of the
|
|
* Software.
|
|
*
|
|
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
* FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
|
|
* THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
* LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
|
|
* FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS
|
|
* IN THE SOFTWARE.
|
|
*
|
|
* Authors:
|
|
* Dave Airlie <airlied@redhat.com>
|
|
* Rob Clark <rob.clark@linaro.org>
|
|
*
|
|
*/
|
|
|
|
#ifndef __DRM_PRIME_H__
|
|
#define __DRM_PRIME_H__
|
|
|
|
#include <linux/mutex.h>
|
|
#include <linux/rbtree.h>
|
|
#include <linux/scatterlist.h>
|
|
|
|
/**
|
|
* struct drm_prime_file_private - per-file tracking for PRIME
|
|
*
|
|
* This just contains the internal &struct dma_buf and handle caches for each
|
|
* &struct drm_file used by the PRIME core code.
|
|
*/
|
|
struct drm_prime_file_private {
|
|
/* private: */
|
|
struct mutex lock;
|
|
struct rb_root dmabufs;
|
|
struct rb_root handles;
|
|
};
|
|
|
|
struct device;
|
|
|
|
struct dma_buf_export_info;
|
|
struct dma_buf;
|
|
struct dma_buf_attachment;
|
|
struct iosys_map;
|
|
|
|
enum dma_data_direction;
|
|
|
|
struct drm_device;
|
|
struct drm_gem_object;
|
|
struct drm_file;
|
|
|
|
/* core prime functions */
|
|
struct dma_buf *drm_gem_dmabuf_export(struct drm_device *dev,
|
|
struct dma_buf_export_info *exp_info);
|
|
void drm_gem_dmabuf_release(struct dma_buf *dma_buf);
|
|
|
|
int drm_gem_prime_fd_to_handle(struct drm_device *dev,
|
|
struct drm_file *file_priv, int prime_fd, uint32_t *handle);
|
|
int drm_gem_prime_handle_to_fd(struct drm_device *dev,
|
|
struct drm_file *file_priv, uint32_t handle, uint32_t flags,
|
|
int *prime_fd);
|
|
|
|
/* helper functions for exporting */
|
|
int drm_gem_map_attach(struct dma_buf *dma_buf,
|
|
struct dma_buf_attachment *attach);
|
|
void drm_gem_map_detach(struct dma_buf *dma_buf,
|
|
struct dma_buf_attachment *attach);
|
|
struct sg_table *drm_gem_map_dma_buf(struct dma_buf_attachment *attach,
|
|
enum dma_data_direction dir);
|
|
void drm_gem_unmap_dma_buf(struct dma_buf_attachment *attach,
|
|
struct sg_table *sgt,
|
|
enum dma_data_direction dir);
|
|
int drm_gem_dmabuf_vmap(struct dma_buf *dma_buf, struct iosys_map *map);
|
|
void drm_gem_dmabuf_vunmap(struct dma_buf *dma_buf, struct iosys_map *map);
|
|
|
|
int drm_gem_prime_mmap(struct drm_gem_object *obj, struct vm_area_struct *vma);
|
|
int drm_gem_dmabuf_mmap(struct dma_buf *dma_buf, struct vm_area_struct *vma);
|
|
|
|
struct sg_table *drm_prime_pages_to_sg(struct drm_device *dev,
|
|
struct page **pages, unsigned int nr_pages);
|
|
struct dma_buf *drm_gem_prime_export(struct drm_gem_object *obj,
|
|
int flags);
|
|
|
|
unsigned long drm_prime_get_contiguous_size(struct sg_table *sgt);
|
|
|
|
/* helper functions for importing */
|
|
struct drm_gem_object *drm_gem_prime_import_dev(struct drm_device *dev,
|
|
struct dma_buf *dma_buf,
|
|
struct device *attach_dev);
|
|
struct drm_gem_object *drm_gem_prime_import(struct drm_device *dev,
|
|
struct dma_buf *dma_buf);
|
|
|
|
void drm_prime_gem_destroy(struct drm_gem_object *obj, struct sg_table *sg);
|
|
|
|
int drm_prime_sg_to_page_array(struct sg_table *sgt, struct page **pages,
|
|
int max_pages);
|
|
int drm_prime_sg_to_dma_addr_array(struct sg_table *sgt, dma_addr_t *addrs,
|
|
int max_pages);
|
|
|
|
#endif /* __DRM_PRIME_H__ */
|