aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorScott Long <scottl@FreeBSD.org>2005-01-15 20:50:52 +0000
committerScott Long <scottl@FreeBSD.org>2005-01-15 20:50:52 +0000
commit824f4edf4f0c0081782b4955ca8191dcd65cc24e (patch)
tree860cee12a943a2e48ed874c04c3a3eb597cea699
parent2f69affe3657b874ae249d48d1228d0908d75792 (diff)
downloadsrc-824f4edf4f0c0081782b4955ca8191dcd65cc24e.tar.gz
src-824f4edf4f0c0081782b4955ca8191dcd65cc24e.zip
Document bus_dmamap_load_mbuf_sg()
Notes
Notes: svn path=/head/; revision=140317
-rw-r--r--share/man/man9/bus_dma.917
1 files changed, 17 insertions, 0 deletions
diff --git a/share/man/man9/bus_dma.9 b/share/man/man9/bus_dma.9
index 30e676d48650..5fce33479f8b 100644
--- a/share/man/man9/bus_dma.9
+++ b/share/man/man9/bus_dma.9
@@ -71,6 +71,7 @@
.Nm bus_dmamap_destroy ,
.Nm bus_dmamap_load ,
.Nm bus_dmamap_load_mbuf ,
+.Nm bus_dmamap_load_mbuf_sg ,
.Nm bus_dmamap_load_uio ,
.Nm bus_dmamap_unload ,
.Nm bus_dmamap_sync ,
@@ -100,6 +101,9 @@
"struct mbuf *mbuf" "bus_dmamap_callback2_t *callback" "void *callback_arg" \
"int flags"
.Ft int
+.Fn bus_dmamap_load_mbuf_sg "bus_dma_tag_t dmat" "bus_dmamap_t map" \
+"struct mbuf *mbuf" "bus_dma_segment_t *segs" "int *nsegs" "int flags"
+.Ft int
.Fn bus_dmamap_load_uio "bus_dma_tag_t dmat" "bus_dmamap_t map" \
"struct uio *uio" "bus_dmamap_callback2_t *callback" "void *callback_arg" \
"int flags"
@@ -556,6 +560,19 @@ Returns
.Er EINVAL
if the size of the mbuf chain exceeds the maximum limit of the
DMA tag.
+.It Fn bus_dmamap_load_mbuf_sg "dmat" "map" "mbuf" "segs" "nsegs" "flags"
+This is just like
+.Fn bus_dmamap_load_mbuf
+except that it returns immediately without calling a callback function. It is
+provided for efficiency.
+The scatter/gather segment array
+.Va segs
+is provided by the caller and filled in directly by the function.
+The
+.Va nsegs
+argument is returned with the number of segments filled in.
+Returns the same errors as
+.Fn bus_dmamap_load_mbuf .
.It Fn bus_dmamap_load_uio "dmat" "map" "uio" "callback2" "callback_arg" "flags"
This is a variation of
.Fn bus_dmamap_load