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

.SH NAME
i2o_wait_message \- obtain an i2o message from the IOP
.SH SYNOPSIS
"SYNOPSIS"
.sp
\fB
.sp
u32 i2o_wait_message  (struct i2o_controller * \fIc\fB, char * \fIwhy\fB);
\fR
.SH "ARGUMENTS"
.TP
\fB\fIc\fB\fR
controller
.TP
\fB\fIwhy\fB\fR
explanation 
.SH "DESCRIPTION"
.PP
This function waits up to 5 seconds for a message slot to be
available. If no message is available it prints an error message
that is expected to be what the message will be used for (eg
``get_status''). 0xFFFFFFFF is returned on a failure.
.PP
On a success the message is returned. This is the physical page
frame offset address from the read port. (See the i2o spec)