diff options
author | Scott Long <scottl@FreeBSD.org> | 2003-07-03 08:32:42 +0000 |
---|---|---|
committer | Scott Long <scottl@FreeBSD.org> | 2003-07-03 08:32:42 +0000 |
commit | 0e5f9b7d5bffb763c52c1fbd809cfea43425f1c4 (patch) | |
tree | ebe67988a322e873f392150e863b177f455d8f46 /share/man/man9/bus_dma.9 | |
parent | d91534027fd656466620a6be21d3971acfef4c86 (diff) | |
download | src-0e5f9b7d5bffb763c52c1fbd809cfea43425f1c4.tar.gz src-0e5f9b7d5bffb763c52c1fbd809cfea43425f1c4.zip |
Update the busdma manpage to reflect the recent API change to
bus_dma_tag_create.
Notes
Notes:
svn path=/head/; revision=117190
Diffstat (limited to 'share/man/man9/bus_dma.9')
-rw-r--r-- | share/man/man9/bus_dma.9 | 36 |
1 files changed, 35 insertions, 1 deletions
diff --git a/share/man/man9/bus_dma.9 b/share/man/man9/bus_dma.9 index 68fa72e4830d..14ccbba06d54 100644 --- a/share/man/man9/bus_dma.9 +++ b/share/man/man9/bus_dma.9 @@ -83,7 +83,8 @@ .Fn bus_dma_tag_create "bus_dma_tag_t parent" "bus_size_t alignment" \ "bus_size_t boundary" "bus_addr_t lowaddr" "bus_addr_t highaddr" \ "bus_dma_filter_t *filtfunc" "void *filtfuncarg" "bus_size_t maxsize" \ -"int nsegments" "bus_size_t maxsegsz" "int flags" "bus_dma_tag_t *dmat" +"int nsegments" "bus_size_t maxsegsz" "int flags" "bus_dma_lock_t *lockfunc" \ +"void *lockfuncarg" "bus_dma_tag_t *dmat" .Ft int .Fn bus_dma_tag_destroy "bus_dma_tag_t dmat" .Ft int @@ -260,7 +261,40 @@ to CPU access of the memory. Perform any synchronization required after a combination of DMA read and write operations. .El +.It Vt bus_dma_lock_t +Client specified lock/mutex manipulation method. This will be called from +within busdma whenever a client lock needs to be manipulated. +This method is of the format: +.Bl -tag -width compact +.It Ft void +.Fn "lockfunc" "void *lockfunc_arg" "bus_dma_lock_op_t op" +.El +.sp +Two +.Vt lockfunc +implementations are provided for convenience. +.Fn busdma_lock_mutex +performs standard mutex operations on the sleep mutex provided via the +.Fa lockfuncarg . +passed into +.Fn bus_dma_tag_create . +.Fn dflt_lock +will generate a system panic if it is called. It is substituted into +the tag when +.Fa lockfunc +is passed as NULL to +.Fn bus_dma_tag_create . +.It Vt bus_dma_lock_op_t +Operations to be performed by the client-specified +.Fn lockfunc . +.Bl -tag -width BUS_DMA_UNLOCK +.It Dv BUS_DMA_LOCK +Aquires and/or locks the client locking primitive. +.It Dv BUS_DMA_UNLOCK +Releases and/or unlocks the client locking primitive. .El +.El +.sp .Sh FUNCTIONS .Bl -tag -width compact .It Fn bus_dma_tag_create "parent" "alignment" "boundary" "lowaddr" \ |