Module Name: src
Committed By: uwe
Date: Wed Oct 9 22:02:51 UTC 2024
Modified Files:
src/share/man/man9: bus_dma.9
Log Message:
bus_dma(9): clean up a few mark up nits
To generate a diff of this commit:
cvs rdiff -u -r1.77 -r1.78 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.77 src/share/man/man9/bus_dma.9:1.78
--- src/share/man/man9/bus_dma.9:1.77 Wed Oct 9 21:56:35 2024
+++ src/share/man/man9/bus_dma.9 Wed Oct 9 22:02:51 2024
@@ -1,4 +1,4 @@
-.\" $NetBSD: bus_dma.9,v 1.77 2024/10/09 21:56:35 uwe Exp $
+.\" $NetBSD: bus_dma.9,v 1.78 2024/10/09 22:02:51 uwe Exp $
.\"
.\" Copyright (c) 1996, 1997, 1998, 2001, 2005, 2006 The NetBSD Foundation, Inc.
.\" All rights reserved.
@@ -638,11 +638,14 @@ If given valid arguments,
.Fn bus_dmamap_sync
always succeeds.
.It Fn bus_dmamem_alloc "tag" "size" "alignment" "boundary" "segs" "nsegs" "rsegs" "flags"
-Allocates memory that is "DMA safe" for the bus corresponding to the
+Allocates memory that is
+.Dq DMA safe
+for the bus corresponding to the
given tag.
.Pp
-The mapping of this memory is machine-dependent (or
-"opaque"); machine-independent code is not to assume that the
+The mapping of this memory is machine-dependent
+.Pq or Dq opaque ;
+machine-independent code is not to assume that the
addresses returned are valid in kernel virtual address space, or that
the addresses returned are system physical addresses.
The address value returned as part of
@@ -650,8 +653,8 @@ The address value returned as part of
can thus not be used to program DMA controller address registers.
Only the values in the
.Fa dm_segs
-array of a successfully loaded DMA map (using
-.Fn bus_dmamap_load )
+array of a successfully loaded DMA map
+.Pq using Fn bus_dmamap_load
can be used for this purpose.
.Pp
Allocations will always be rounded to the hardware page size.
@@ -865,7 +868,9 @@ always succeeds.
Provides support for user
.Xr mmap 2 Ap ing
of DMA-safe memory.
-This function is to be called by a device driver's (*d_mmap)() entry
+This function is to be called by a device driver's
+.Li (* Ns Fa d_mmap Ns Li )()
+entry
point, which is called by the device pager for each page to be mapped.
.Bl -tag -width Ds \" Fa
.It Fa tag
