1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
|
/*
* Copyright (c) 2017, NVIDIA CORPORATION. All rights reserved.
*
* This program is free software; you can redistribute it and/or modify it
* under the terms and conditions of the GNU General Public License,
* version 2, as published by the Free Software Foundation.
*
* This program is distributed in the hope it will be useful, but WITHOUT
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
* FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
* more details.
*
* You should have received a copy of the GNU General Public License
* along with this program. If not, see <http://www.gnu.org/licenses/>.
*/
#ifndef __NVGPU_LINUX_NVGPU_MEM_H__
#define __NVGPU_LINUX_NVGPU_MEM_H__
struct page;
struct sg_table;
struct scatterlist;
struct nvgpu_sgt;
struct gk20a;
struct nvgpu_mem;
struct nvgpu_gmmu_attrs;
struct nvgpu_mem_priv {
struct page **pages;
struct sg_table *sgt;
unsigned long flags;
};
u64 nvgpu_mem_get_addr_sgl(struct gk20a *g, struct scatterlist *sgl);
struct nvgpu_sgt *nvgpu_mem_linux_sgt_create(struct gk20a *g,
struct sg_table *sgt);
void nvgpu_mem_linux_sgt_free(struct gk20a *g, struct nvgpu_sgt *sgt);
struct nvgpu_sgt *nvgpu_linux_sgt_create(struct gk20a *g,
struct sg_table *sgt);
/**
* __nvgpu_mem_create_from_pages - Create an nvgpu_mem from physical pages.
*
* @g - The GPU.
* @dest - nvgpu_mem to initialize.
* @pages - A list of page pointers.
* @nr_pages - The number of pages in @pages.
*
* Create a new nvgpu_mem struct from a pre-existing list of physical pages. The
* pages need not be contiguous (the underlying scatter gather list will help
* with that). However, note, this API will explicitly make it so that the GMMU
* mapping code bypasses SMMU access for the passed pages. This allows one to
* make mem_descs that describe MMIO regions or other non-DRAM things.
*
* This only works for SYSMEM (or other things like SYSMEM - basically just not
* VIDMEM). Also, this API is only available for Linux as it heavily depends on
* the notion of struct %page.
*
* The resulting nvgpu_mem should be released with the nvgpu_dma_free() or the
* nvgpu_dma_unmap_free() function depending on whether or not the resulting
* nvgpu_mem has been mapped. The underlying pages themselves must be cleaned up
* by the caller of this API.
*
* Returns 0 on success, or a relevant error otherwise.
*/
int __nvgpu_mem_create_from_pages(struct gk20a *g, struct nvgpu_mem *dest,
struct page **pages, int nr_pages);
/**
* __nvgpu_mem_create_from_phys - Create an nvgpu_mem from physical mem.
*
* @g - The GPU.
* @dest - nvgpu_mem to initialize.
* @src_phys - start address of physical mem
* @nr_pages - The number of pages in phys.
*
* Create a new nvgpu_mem struct from a physical memory aperure. The physical
* memory aperture needs to be contiguous for requested @nr_pages. This API
* only works for SYSMEM.
*
* The resulting nvgpu_mem should be released with the nvgpu_dma_free() or the
* nvgpu_dma_unmap_free() function depending on whether or not the resulting
* nvgpu_mem has been mapped.
*
* Returns 0 on success, or a relevant error otherwise.
*/
int __nvgpu_mem_create_from_phys(struct gk20a *g, struct nvgpu_mem *dest,
u64 src_phys, int nr_pages);
#endif
|
