'\" t .\" Title: i2o_msg_get_wait .\" 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_GET_WAIT" "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_get_wait \- obtain an I2O message from the IOP .SH "SYNOPSIS" .HP \w'struct\ i2o_message\ *\ i2o_msg_get_wait('u .BI "struct i2o_message * i2o_msg_get_wait(struct\ i2o_controller\ *\ " "c" ", int\ " "wait" ");" .SH "ARGUMENTS" .PP \fIc\fR .RS 4 I2O controller .RE .PP \fIwait\fR .RS 4 how long to wait until timeout .RE .SH "DESCRIPTION" .PP This function waits up to wait seconds for a message slot to be available\&. .PP On a success the message is returned and the pointer to the message is set in msg\&. The returned message is the physical page frame offset address from the read port (see the i2o spec)\&. If no message is available returns I2O_QUEUE_EMPTY and msg is leaved untouched\&. .SH "COPYRIGHT" .br