Re: [PATCH 2/8] docs: dma-api: replace consistent with coherent
From: Marek Szyprowski
Date: Thu Jun 26 2025 - 03:21:16 EST
On 26.06.2025 06:51, Petr Tesarik wrote:
> On Tue, 24 Jun 2025 15:39:17 +0200
> Petr Tesarik <ptesarik@xxxxxxxx> wrote:
>
>> For consistency, always use the term "coherent" when talking about memory
>> that is not subject to CPU caching effects. The term "consistent" is a
>> relic of a long-removed pci_alloc_consistent() function.
> I realize that I'm not an authoritative source for this, but I forgot
> to add more trusted maintainers to the recipient list.
>
> Now, all you DMA experts, do you agree that the word "consistent"
> should be finally eradicated from DMA API documentation?
Well, this was always puzzling for me, why there are those 2 names used
(especially in case of dma_alloc_coherent() vs.
dma_alloc_nonconsistent()). I'm for unifying them to "coherent" as this
is the term use more often.
> > ...
Best regards
--
Marek Szyprowski, PhD
Samsung R&D Institute Poland