mirror of
https://git.kernel.org/pub/scm/linux/kernel/git/stable/linux.git
synced 2024-09-05 02:19:51 +00:00
![Lucas De Marchi](/assets/img/avatar_default.png)
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
61 lines
1.8 KiB
C
61 lines
1.8 KiB
C
/* SPDX-License-Identifier: MIT */
|
|
/*
|
|
* Copyright © 2021 Intel Corporation
|
|
*/
|
|
#ifndef __TTM_KMAP_ITER_H__
|
|
#define __TTM_KMAP_ITER_H__
|
|
|
|
#include <linux/types.h>
|
|
|
|
struct ttm_kmap_iter;
|
|
struct iosys_map;
|
|
|
|
/**
|
|
* struct ttm_kmap_iter_ops - Ops structure for a struct
|
|
* ttm_kmap_iter.
|
|
* @maps_tt: Whether the iterator maps TT memory directly, as opposed
|
|
* mapping a TT through an aperture. Both these modes have
|
|
* struct ttm_resource_manager::use_tt set, but the latter typically
|
|
* returns is_iomem == true from ttm_mem_io_reserve.
|
|
*/
|
|
struct ttm_kmap_iter_ops {
|
|
/**
|
|
* kmap_local() - Map a PAGE_SIZE part of the resource using
|
|
* kmap_local semantics.
|
|
* @res_iter: Pointer to the struct ttm_kmap_iter representing
|
|
* the resource.
|
|
* @dmap: The struct iosys_map holding the virtual address after
|
|
* the operation.
|
|
* @i: The location within the resource to map. PAGE_SIZE granularity.
|
|
*/
|
|
void (*map_local)(struct ttm_kmap_iter *res_iter,
|
|
struct iosys_map *dmap, pgoff_t i);
|
|
/**
|
|
* unmap_local() - Unmap a PAGE_SIZE part of the resource previously
|
|
* mapped using kmap_local.
|
|
* @res_iter: Pointer to the struct ttm_kmap_iter representing
|
|
* the resource.
|
|
* @dmap: The struct iosys_map holding the virtual address after
|
|
* the operation.
|
|
*/
|
|
void (*unmap_local)(struct ttm_kmap_iter *res_iter,
|
|
struct iosys_map *dmap);
|
|
bool maps_tt;
|
|
};
|
|
|
|
/**
|
|
* struct ttm_kmap_iter - Iterator for kmap_local type operations on a
|
|
* resource.
|
|
* @ops: Pointer to the operations struct.
|
|
*
|
|
* This struct is intended to be embedded in a resource-specific specialization
|
|
* implementing operations for the resource.
|
|
*
|
|
* Nothing stops us from extending the operations to vmap, vmap_pfn etc,
|
|
* replacing some or parts of the ttm_bo_util. cpu-map functionality.
|
|
*/
|
|
struct ttm_kmap_iter {
|
|
const struct ttm_kmap_iter_ops *ops;
|
|
};
|
|
|
|
#endif /* __TTM_KMAP_ITER_H__ */
|