Module Name: src
Committed By: uwe
Date: Wed Oct 9 21:08:34 UTC 2024
Modified Files:
src/share/man/man9: bus_dma.9
Log Message:
bus_dma(9): smarter "->" arrows
To generate a diff of this commit:
cvs rdiff -u -r1.72 -r1.73 src/share/man/man9/bus_dma.9
Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.
Modified files:
Index: src/share/man/man9/bus_dma.9
diff -u src/share/man/man9/bus_dma.9:1.72 src/share/man/man9/bus_dma.9:1.73
--- src/share/man/man9/bus_dma.9:1.72 Wed Oct 9 16:40:00 2024
+++ src/share/man/man9/bus_dma.9 Wed Oct 9 21:08:34 2024
@@ -1,4 +1,4 @@
-.\" $NetBSD: bus_dma.9,v 1.72 2024/10/09 16:40:00 uwe Exp $
+.\" $NetBSD: bus_dma.9,v 1.73 2024/10/09 21:08:34 uwe Exp $
.\"
.\" Copyright (c) 1996, 1997, 1998, 2001, 2005, 2006 The NetBSD Foundation, Inc.
.\" All rights reserved.
@@ -391,13 +391,13 @@ function.
.It Dv BUS_DMA_READ
This is a hint to the machine-dependent back-end that indicates the
mapping will be used only for a
-.Em "device -> memory"
+.Em device No \(-> Em memory
transaction.
The back-end may perform optimizations based on this information.
.It Dv BUS_DMA_WRITE
This is a hint to the machine-dependent back-end that indicates the
mapping will be used only for a
-.Em "memory -> device"
+.Em memory No \(-> Em device
transaction.
The back-end may perform optimizations based on this information.
.It Dv BUS_DMA_BUS[1-4]
@@ -447,7 +447,7 @@ which maps buffers pointed to by
for DMA transfers.
Determination if the buffers are in user or kernel virtual address space
is done internally, according to
-.Fa "uio->uio_vmspace" .
+.Fa uio\^ Ns Li -> Ns Fa uio_vmspace .
See
.Xr uiomove 9
for details of the
@@ -547,21 +547,21 @@ copying, and/or memory barriers.
.Pp
More than one operation may performed in a given synchronization call.
Mixing of
-.Em PRE
+.Dv PRE
and
-.Em POST
+.Dv POST
operations is not allowed, and behavior is undefined if this is attempted.
.El
.Pp
Synchronization operations are expressed from the perspective of
-the host RAM, e.g., a
-.Em "device -> memory"
+the host RAM, i.e., a
+.Em device No \(-> Em memory
operation is a
-.Em READ
+.Dv READ ,
and a
-.Em "memory -> device"
+.Em memory No \(-> Em device
operation is a
-.Em WRITE .
+.Dv WRITE .
.Pp
.Fn bus_dmamap_sync
may consult state kept within the DMA map to determine if the memory
