'\" t .\" Title: i2o_msg_post_wait_complete .\" Author: [FIXME: author] [see http://docbook.sf.net/el/author] .\" Generator: DocBook XSL Stylesheets v1.78.1 .\" Date: May 2018 .\" Manual: Message-based devices .\" Source: Kernel Hackers Manual 3.16.56 .\" Language: English .\" .TH "I2O_MSG_POST_WAIT_CO" "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_complete \- Reply to a i2o_msg_post request from IOP .SH "SYNOPSIS" .HP \w'int\ i2o_msg_post_wait_complete('u .BI "int i2o_msg_post_wait_complete(struct\ i2o_controller\ *\ " "c" ", u32\ " "m" ", struct\ i2o_message\ *\ " "msg" ", u32\ " "context" ");" .SH "ARGUMENTS" .PP \fIc\fR .RS 4 I2O controller which answers .RE .PP \fIm\fR .RS 4 message id .RE .PP \fImsg\fR .RS 4 pointer to the I2O reply message .RE .PP \fIcontext\fR .RS 4 transaction context of request .RE .SH "DESCRIPTION" .PP This function is called in interrupt context only\&. If the reply reached before the timeout, the i2o_exec_wait struct is filled with the message and the task will be waked up\&. The task is now responsible for returning the message m back to the controller! If the message reaches us after the timeout clean up the i2o_exec_wait struct (including allocated DMA buffer)\&. .PP Return 0 on success and if the message m should not be given back to the I2O controller, or >0 on success and if the message should be given back afterwords\&. Returns negative error code on failure\&. In this case the message must also be given back to the controller\&. .SH "COPYRIGHT" .br