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

.SH NAME
i2o_post_wait_mem \- I2O query/reply with DMA buffers
.SH SYNOPSIS
"SYNOPSIS"
.sp
\fB
.sp
int i2o_post_wait_mem  (struct i2o_controller * \fIc\fB, u32 * \fImsg\fB, int \fIlen\fB, int \fItimeout\fB, void * \fImem1\fB, void * \fImem2\fB, dma_addr_t \fIphys1\fB, dma_addr_t \fIphys2\fB, int \fIsize1\fB, int \fIsize2\fB);
\fR
.SH "ARGUMENTS"
.TP
\fB\fIc\fB\fR
controller
.TP
\fB\fImsg\fB\fR
message to send
.TP
\fB\fIlen\fB\fR
length of message
.TP
\fB\fItimeout\fB\fR
time in seconds to wait
.TP
\fB\fImem1\fB\fR
attached memory buffer 1
.TP
\fB\fImem2\fB\fR
attached memory buffer 2
.TP
\fB\fIphys1\fB\fR
physical address of buffer 1
.TP
\fB\fIphys2\fB\fR
physical address of buffer 2
.TP
\fB\fIsize1\fB\fR
size of buffer 1
.TP
\fB\fIsize2\fB\fR
size of buffer 2
.SH "DESCRIPTION"
.PP
This core API allows an OSM to post a message and then be told whether
or not the system received a successful reply. 
.PP
If the message times out then the value '-ETIMEDOUT' is returned. This
is a special case. In this situation the message may (should) complete
at an indefinite time in the future. When it completes it will use the
memory buffers attached to the request. If -ETIMEDOUT is returned then
the memory buffers must not be freed. Instead the event completion will
free them for you. In all other cases the buffers are your problem.
.PP
Pass NULL for unneeded buffers.