linux/Documentation/sound
Takashi Iwai f274baa49b ALSA: usb-audio: Allow non-vmalloc buffer for PCM buffers
Currently, USB-audio driver allocates the PCM buffer via vmalloc(), as
this serves merely as an intermediate buffer that is copied to each
URB transfer buffer.  This works well in general on x86, but on some
archs this may result in cache coherency issues when mmap is used.
OTOH, it works also on such arch unless mmap is used.

This patch is a step for mitigating the inconvenience; a new module
option "use_vmalloc" is provided so that user can choose to allocate
the DMA coherent buffer instead of the existing vmalloc buffer.
The drawback is that it'd be the standard dma_alloc_coherent() calls
and the system would require contiguous pages on non-x86 archs.

Note that it's a global option and not dynamically switchable since
the buffer is pre-allocated at the probe time.  In theory, it's
possible to be switchable, but it'd be trickier and racier.

As default use_vmalloc option is set to true, so that the old behavior
is kept.  For allowing the coherent mmap on ARM or MIPS, pass
use_vmalloc=0 option explicitly.

Reported-and-tested-by: Daniel Danzberger <daniel@dd-wrt.com>
Signed-off-by: Takashi Iwai <tiwai@suse.de>
2018-05-29 10:01:54 +02:00
..
cards Documentation: fix input related doc refs 2017-10-12 11:14:06 -06:00
designs ALSA: pcm: add a documentation for tracepoints 2017-07-02 11:15:52 +02:00
hd-audio ALSA: hda/conexant - Add hp-mic-fix model string 2018-05-22 13:45:37 +02:00
kernel-api Documentation: fix sound related doc refs 2017-10-12 11:15:20 -06:00
soc ASoC: dapm: Add new widget type for constructing DAPM graphs on DSPs. 2017-06-30 11:55:20 +01:00
alsa-configuration.rst ALSA: usb-audio: Allow non-vmalloc buffer for PCM buffers 2018-05-29 10:01:54 +02:00
conf.py docs-rst: add sound book to pdf output 2017-05-16 08:44:07 -03:00
index.rst ASoC: doc: ReSTize overview.txt 2016-11-11 17:32:48 +01:00