kernel/dma/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_LENGTH
  28         bool
  29
  30 config NEED_DMA_MAP_STATE
  31         bool
  32
  33 config ARCH_DMA_ADDR_T_64BIT
  34         def_bool 64BIT || PHYS_ADDR_T_64BIT
  35
  36 config ARCH_HAS_DMA_COHERENCE_H
  37         bool
  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 thing 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 config SWIOTLB
  83         bool
  84         select NEED_DMA_MAP_STATE
  85
  86 #
  87 # Should be selected if we can mmap non-coherent mappings to userspace.
  88 # The only thing that is really required is a way to set an uncached bit
  89 # in the pagetables
  90 #
  91 config DMA_NONCOHERENT_MMAP
  92         default y if !MMU
  93         bool
  94
  95 config DMA_COHERENT_POOL
  96         select GENERIC_ALLOCATOR
  97         bool
  98
  99 config DMA_REMAP
 100         bool
 101         depends on MMU
 102         select DMA_NONCOHERENT_MMAP
 103
 104 config DMA_DIRECT_REMAP
 105         bool
 106         select DMA_REMAP
 107         select DMA_COHERENT_POOL
 108
 109 config DMA_CMA
 110         bool "DMA Contiguous Memory Allocator"
 111         depends on HAVE_DMA_CONTIGUOUS && CMA
 112         help
 113           This enables the Contiguous Memory Allocator which allows drivers
 114           to allocate big physically-contiguous blocks of memory for use with
 115           hardware components that do not support I/O map nor scatter-gather.
 116
 117           You can disable CMA by specifying "cma=0" on the kernel's command
 118           line.
 119
 120           For more information see <kernel/dma/contiguous.c>.
 121           If unsure, say "n".
 122
 123 if  DMA_CMA
 124
 125 config DMA_PERNUMA_CMA
 126         bool "Enable separate DMA Contiguous Memory Area for each NUMA Node"
 127         default NUMA && ARM64
 128         help
 129           Enable this option to get pernuma CMA areas so that devices like
 130           ARM64 SMMU can get local memory by DMA coherent APIs.
 131
 132           You can set the size of pernuma CMA by specifying "cma_pernuma=size"
 133           on the kernel's command line.
 134
 135 comment "Default contiguous memory area size:"
 136
 137 config CMA_SIZE_MBYTES
 138         int "Size in Mega Bytes"
 139         depends on !CMA_SIZE_SEL_PERCENTAGE
 140         default 0 if X86
 141         default 16
 142         help
 143           Defines the size (in MiB) of the default memory area for Contiguous
 144           Memory Allocator.  If the size of 0 is selected, CMA is disabled by
 145           default, but it can be enabled by passing cma=size[MG] to the kernel.
 146
 147
 148 config CMA_SIZE_PERCENTAGE
 149         int "Percentage of total memory"
 150         depends on !CMA_SIZE_SEL_MBYTES
 151         default 0 if X86
 152         default 10
 153         help
 154           Defines the size of the default memory area for Contiguous Memory
 155           Allocator as a percentage of the total memory in the system.
 156           If 0 percent is selected, CMA is disabled by default, but it can be
 157           enabled by passing cma=size[MG] to the kernel.
 158
 159 choice
 160         prompt "Selected region size"
 161         default CMA_SIZE_SEL_MBYTES
 162
 163 config CMA_SIZE_SEL_MBYTES
 164         bool "Use mega bytes value only"
 165
 166 config CMA_SIZE_SEL_PERCENTAGE
 167         bool "Use percentage value only"
 168
 169 config CMA_SIZE_SEL_MIN
 170         bool "Use lower value (minimum)"
 171
 172 config CMA_SIZE_SEL_MAX
 173         bool "Use higher value (maximum)"
 174
 175 endchoice
 176
 177 config CMA_ALIGNMENT
 178         int "Maximum PAGE_SIZE order of alignment for contiguous buffers"
 179         range 2 12
 180         default 8
 181         help
 182           DMA mapping framework by default aligns all buffers to the smallest
 183           PAGE_SIZE order which is greater than or equal to the requested buffer
 184           size. This works well for buffers up to a few hundreds kilobytes, but
 185           for larger buffers it just a memory waste. With this parameter you can
 186           specify the maximum PAGE_SIZE order for contiguous buffers. Larger
 187           buffers will be aligned only to this specified order. The order is
 188           expressed as a power of two multiplied by the PAGE_SIZE.
 189
 190           For example, if your system defaults to 4KiB pages, the order value
 191           of 8 means that the buffers will be aligned up to 1MiB only.
 192
 193           If unsure, leave the default value "8".
 194
 195 endif
 196
 197 config DMA_API_DEBUG
 198         bool "Enable debugging of DMA-API usage"
 199         select NEED_DMA_MAP_STATE
 200         help
 201           Enable this option to debug the use of the DMA API by device drivers.
 202           With this option you will be able to detect common bugs in device
 203           drivers like double-freeing of DMA mappings or freeing mappings that
 204           were never allocated.
 205
 206           This option causes a performance degradation.  Use only if you want to
 207           debug device drivers and dma interactions.
 208
 209           If unsure, say N.
 210
 211 config DMA_API_DEBUG_SG
 212         bool "Debug DMA scatter-gather usage"
 213         default y
 214         depends on DMA_API_DEBUG
 215         help
 216           Perform extra checking that callers of dma_map_sg() have respected the
 217           appropriate segment length/boundary limits for the given device when
 218           preparing DMA scatterlists.
 219
 220           This is particularly likely to have been overlooked in cases where the
 221           dma_map_sg() API is used for general bulk mapping of pages rather than
 222           preparing literal scatter-gather descriptors, where there is a risk of
 223           unexpected behaviour from DMA API implementations if the scatterlist
 224           is technically out-of-spec.
 225
 226           If unsure, say N.
 227
 228 config DMA_MAP_BENCHMARK
 229         bool "Enable benchmarking of streaming DMA mapping"
 230         depends on DEBUG_FS
 231         help
 232           Provides /sys/kernel/debug/dma_map_benchmark that helps with testing
 233           performance of dma_(un)map_page.
 234
 235           See tools/testing/selftests/dma/dma_map_benchmark.c