.\" 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_MSG_POST_WAIT_MEM" "9" "09 October 2005" "" ""

.SH NAME
i2o_msg_post_wait_mem \- Post and wait a message with DMA buffers
.SH SYNOPSIS
"SYNOPSIS"
.sp
\fB
.sp
int i2o_msg_post_wait_mem  (struct i2o_controller * \fIc\fB, u32 \fIm\fB, unsigned long \fItimeout\fB, struct i2o_dma * \fIdma\fB);
\fR
.SH "ARGUMENTS"
.TP
\fB\fIc\fB\fR
controller
.TP
\fB\fIm\fB\fR
message to post
.TP
\fB\fItimeout\fB\fR
time in seconds to wait
.TP
\fB\fIdma\fB\fR
i2o_dma struct of the DMA buffer to free on failure
.SH "DESCRIPTION"
.PP
This API allows an OSM to post a message and then be told whether or
not the system received a successful reply. 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 buffer
attached to the request. If -ETIMEDOUT is returned then the memory
buffer must not be freed. Instead the event completion will free them
for you. In all other cases the buffer are your problem.
.PP
Returns 0 on success, negative error code on timeout or positive error
code from reply.