d62f5957f36be7601d99ffc2491a95473967f912
[linux-modified.git] / Kconfig
1 # SPDX-License-Identifier: GPL-2.0-only
2
3 config NO_DMA
4         bool
5
6 config HAS_DMA
7         bool
8         depends on !NO_DMA
9         default y
10
11 config DMA_OPS
12         depends on HAS_DMA
13         bool
14
15 #
16 # IOMMU drivers that can bypass the IOMMU code and optionally use the direct
17 # mapping fast path should select this option and set the dma_ops_bypass
18 # flag in struct device where applicable
19 #
20 config DMA_OPS_BYPASS
21         bool
22
23 # Lets platform IOMMU driver choose between bypass and IOMMU
24 config ARCH_HAS_DMA_MAP_DIRECT
25         bool
26
27 config NEED_SG_DMA_FLAGS
28         bool
29
30 config NEED_SG_DMA_LENGTH
31         bool
32
33 config NEED_DMA_MAP_STATE
34         bool
35
36 config ARCH_DMA_ADDR_T_64BIT
37         def_bool 64BIT || PHYS_ADDR_T_64BIT
38
39 config ARCH_HAS_DMA_SET_MASK
40         bool
41
42 #
43 # Select this option if the architecture needs special handling for
44 # DMA_ATTR_WRITE_COMBINE.  Normally the "uncached" mapping should be what
45 # people think of when saying write combine, so very few platforms should
46 # need to enable this.
47 #
48 config ARCH_HAS_DMA_WRITE_COMBINE
49         bool
50
51 #
52 # Select if the architectures provides the arch_dma_mark_clean hook
53 #
54 config ARCH_HAS_DMA_MARK_CLEAN
55         bool
56
57 config DMA_DECLARE_COHERENT
58         bool
59
60 config ARCH_HAS_SETUP_DMA_OPS
61         bool
62
63 config ARCH_HAS_TEARDOWN_DMA_OPS
64         bool
65
66 config ARCH_HAS_SYNC_DMA_FOR_DEVICE
67         bool
68
69 config ARCH_HAS_SYNC_DMA_FOR_CPU
70         bool
71         select NEED_DMA_MAP_STATE
72
73 config ARCH_HAS_SYNC_DMA_FOR_CPU_ALL
74         bool
75
76 config ARCH_HAS_DMA_PREP_COHERENT
77         bool
78
79 config ARCH_HAS_FORCE_DMA_UNENCRYPTED
80         bool
81
82 #
83 # Select this option if the architecture assumes DMA devices are coherent
84 # by default.
85 #
86 config ARCH_DMA_DEFAULT_COHERENT
87         bool
88
89 config SWIOTLB
90         bool
91         select NEED_DMA_MAP_STATE
92
93 config SWIOTLB_DYNAMIC
94         bool "Dynamic allocation of DMA bounce buffers"
95         default n
96         depends on SWIOTLB
97         help
98           This enables dynamic resizing of the software IO TLB. The kernel
99           starts with one memory pool at boot and it will allocate additional
100           pools as needed. To reduce run-time kernel memory requirements, you
101           may have to specify a smaller size of the initial pool using
102           "swiotlb=" on the kernel command line.
103
104           If unsure, say N.
105
106 config DMA_BOUNCE_UNALIGNED_KMALLOC
107         bool
108         depends on SWIOTLB
109
110 config DMA_RESTRICTED_POOL
111         bool "DMA Restricted Pool"
112         depends on OF && OF_RESERVED_MEM && SWIOTLB
113         help
114           This enables support for restricted DMA pools which provide a level of
115           DMA memory protection on systems with limited hardware protection
116           capabilities, such as those lacking an IOMMU.
117
118           For more information see
119           <Documentation/devicetree/bindings/reserved-memory/reserved-memory.txt>
120           and <kernel/dma/swiotlb.c>.
121           If unsure, say "n".
122
123 #
124 # Should be selected if we can mmap non-coherent mappings to userspace.
125 # The only thing that is really required is a way to set an uncached bit
126 # in the pagetables
127 #
128 config DMA_NONCOHERENT_MMAP
129         default y if !MMU
130         bool
131
132 config DMA_COHERENT_POOL
133         select GENERIC_ALLOCATOR
134         bool
135
136 config DMA_GLOBAL_POOL
137         select DMA_DECLARE_COHERENT
138         depends on !ARCH_HAS_DMA_SET_UNCACHED
139         depends on !DMA_DIRECT_REMAP
140         bool
141
142 config DMA_DIRECT_REMAP
143         bool
144         select DMA_COHERENT_POOL
145         select DMA_NONCOHERENT_MMAP
146
147 #
148 # Fallback to arch code for DMA allocations.  This should eventually go away.
149 #
150 config ARCH_HAS_DMA_ALLOC
151         depends on !ARCH_HAS_DMA_SET_UNCACHED
152         depends on !DMA_DIRECT_REMAP
153         depends on !DMA_GLOBAL_POOL
154         bool
155
156 config DMA_CMA
157         bool "DMA Contiguous Memory Allocator"
158         depends on HAVE_DMA_CONTIGUOUS && CMA
159         help
160           This enables the Contiguous Memory Allocator which allows drivers
161           to allocate big physically-contiguous blocks of memory for use with
162           hardware components that do not support I/O map nor scatter-gather.
163
164           You can disable CMA by specifying "cma=0" on the kernel's command
165           line.
166
167           For more information see <kernel/dma/contiguous.c>.
168           If unsure, say "n".
169
170 if  DMA_CMA
171
172 config DMA_NUMA_CMA
173         bool "Enable separate DMA Contiguous Memory Area for NUMA Node"
174         depends on NUMA
175         help
176           Enable this option to get numa CMA areas so that NUMA devices
177           can get local memory by DMA coherent APIs.
178
179           You can set the size of pernuma CMA by specifying "cma_pernuma=size"
180           or set the node id and its size of CMA by specifying "numa_cma=
181           <node>:size[,<node>:size]" on the kernel's command line.
182
183 comment "Default contiguous memory area size:"
184
185 config CMA_SIZE_MBYTES
186         int "Size in Mega Bytes"
187         depends on !CMA_SIZE_SEL_PERCENTAGE
188         default 0 if X86
189         default 16
190         help
191           Defines the size (in MiB) of the default memory area for Contiguous
192           Memory Allocator.  If the size of 0 is selected, CMA is disabled by
193           default, but it can be enabled by passing cma=size[MG] to the kernel.
194
195
196 config CMA_SIZE_PERCENTAGE
197         int "Percentage of total memory"
198         depends on !CMA_SIZE_SEL_MBYTES
199         default 0 if X86
200         default 10
201         help
202           Defines the size of the default memory area for Contiguous Memory
203           Allocator as a percentage of the total memory in the system.
204           If 0 percent is selected, CMA is disabled by default, but it can be
205           enabled by passing cma=size[MG] to the kernel.
206
207 choice
208         prompt "Selected region size"
209         default CMA_SIZE_SEL_MBYTES
210
211 config CMA_SIZE_SEL_MBYTES
212         bool "Use mega bytes value only"
213
214 config CMA_SIZE_SEL_PERCENTAGE
215         bool "Use percentage value only"
216
217 config CMA_SIZE_SEL_MIN
218         bool "Use lower value (minimum)"
219
220 config CMA_SIZE_SEL_MAX
221         bool "Use higher value (maximum)"
222
223 endchoice
224
225 config CMA_ALIGNMENT
226         int "Maximum PAGE_SIZE order of alignment for contiguous buffers"
227         range 2 12
228         default 8
229         help
230           DMA mapping framework by default aligns all buffers to the smallest
231           PAGE_SIZE order which is greater than or equal to the requested buffer
232           size. This works well for buffers up to a few hundreds kilobytes, but
233           for larger buffers it just a memory waste. With this parameter you can
234           specify the maximum PAGE_SIZE order for contiguous buffers. Larger
235           buffers will be aligned only to this specified order. The order is
236           expressed as a power of two multiplied by the PAGE_SIZE.
237
238           For example, if your system defaults to 4KiB pages, the order value
239           of 8 means that the buffers will be aligned up to 1MiB only.
240
241           If unsure, leave the default value "8".
242
243 endif
244
245 config DMA_API_DEBUG
246         bool "Enable debugging of DMA-API usage"
247         select NEED_DMA_MAP_STATE
248         help
249           Enable this option to debug the use of the DMA API by device drivers.
250           With this option you will be able to detect common bugs in device
251           drivers like double-freeing of DMA mappings or freeing mappings that
252           were never allocated.
253
254           This option causes a performance degradation.  Use only if you want to
255           debug device drivers and dma interactions.
256
257           If unsure, say N.
258
259 config DMA_API_DEBUG_SG
260         bool "Debug DMA scatter-gather usage"
261         default y
262         depends on DMA_API_DEBUG
263         help
264           Perform extra checking that callers of dma_map_sg() have respected the
265           appropriate segment length/boundary limits for the given device when
266           preparing DMA scatterlists.
267
268           This is particularly likely to have been overlooked in cases where the
269           dma_map_sg() API is used for general bulk mapping of pages rather than
270           preparing literal scatter-gather descriptors, where there is a risk of
271           unexpected behaviour from DMA API implementations if the scatterlist
272           is technically out-of-spec.
273
274           If unsure, say N.
275
276 config DMA_MAP_BENCHMARK
277         bool "Enable benchmarking of streaming DMA mapping"
278         depends on DEBUG_FS
279         help
280           Provides /sys/kernel/debug/dma_map_benchmark that helps with testing
281           performance of dma_(un)map_page.
282
283           See tools/testing/selftests/dma/dma_map_benchmark.c