.\" 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 "SN_PCI_MAP_SINGLE" "" "06 October 2005" "" ""

.SH NAME
sn_pci_map_single \- map a single region for DMA
.SH SYNOPSIS
"SYNOPSIS"
.sp
\fB
.sp
dma_addr_t sn_pci_map_single  (struct pci_dev * \fIhwdev\fB, void * \fIptr\fB, size_t \fIsize\fB, int \fIdirection\fB);
\fR
.SH "ARGUMENTS"
.TP
\fB\fIhwdev\fB\fR
device to map for
.TP
\fB\fIptr\fB\fR
kernel virtual address of the region to map
.TP
\fB\fIsize\fB\fR
size of the region
.TP
\fB\fIdirection\fB\fR
DMA direction
.SH "DESCRIPTION"
.PP
Map the region pointed to by \fIptr\fR for DMA and return the
DMA address.   Also known as \fBplatform_pci_map_single\fR by
the IA64 machvec code.
.PP
We map this to the one step pcibr_dmamap_trans interface rather than
the two step pciio_dmamap_alloc/pciio_dmamap_addr because we have
no way of saving the dmamap handle from the alloc to later free
(which is pretty much unacceptable).
.SH "TODO"
.PP
simplify our interface;
get rid of dev_desc and vhdl (seems redundant given a pci_dev);
figure out how to save dmamap handle so can use two step.