.\" This manpage has been automatically generated by docbook2man 
.\" from a DocBook document.  This tool can be found at:
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> 
.\" Please send any bug reports, improvements, comments, patches, 
.\" etc. to Steve Cheng <steve@ggi-project.org>.
.TH "SA1100_GET_DMA_POS" "9" "09 October 2005" "" ""

.SH NAME
sa1100_get_dma_pos \- return current DMA position
.SH SYNOPSIS
"SYNOPSIS"
.sp
\fB
.sp
dma_addr_t sa1100_get_dma_pos  (dma_regs_t * \fIregs\fB);
\fR
.SH "ARGUMENTS"
.TP
\fB\fIregs\fB\fR
identifier for the channel to use
.SH "DESCRIPTION"
.PP
This function returns the current physical (or bus) address for the
given DMA channel.  If the channel is running i.e. not in a stopped
state then the caller must disable interrupts prior calling this
function and process the returned value before re-enabling them to
prevent races with the completion interrupt handler and the callback
function. The validation of the returned value is the caller's
responsibility as well -- the hardware seems to return out of range
values when the DMA engine completes a buffer.
.PP
The \fIregs\fR identifier is provided by a successful call to
\fBsa1100_request_dma\fR\&.