'\" t
.\"     Title: i2o_msg_post_wait_mem
.\"    Author: [FIXME: author] [see http://docbook.sf.net/el/author]
.\" Generator: DocBook XSL Stylesheets v1.78.1 <http://docbook.sf.net/>
.\"      Date: May 2018
.\"    Manual: Message-based devices
.\"    Source: Kernel Hackers Manual 3.16.56
.\"  Language: English
.\"
.TH "I2O_MSG_POST_WAIT_ME" "9" "May 2018" "Kernel Hackers Manual 3\&.16\&" "Message-based devices"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
i2o_msg_post_wait_mem \- Post and wait a message with DMA buffers
.SH "SYNOPSIS"
.HP \w'int\ i2o_msg_post_wait_mem('u
.BI "int i2o_msg_post_wait_mem(struct\ i2o_controller\ *\ " "c" ", struct\ i2o_message\ *\ " "msg" ", unsigned\ long\ " "timeout" ", struct\ i2o_dma\ *\ " "dma" ");"
.SH "ARGUMENTS"
.PP
\fIc\fR
.RS 4
controller
.RE
.PP
\fImsg\fR
.RS 4
message to post
.RE
.PP
\fItimeout\fR
.RS 4
time in seconds to wait
.RE
.PP
\fIdma\fR
.RS 4
i2o_dma struct of the DMA buffer to free on failure
.RE
.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 \*(Aq\-ETIMEDOUT\*(Aq 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\&.
.SH "COPYRIGHT"
.br