suse man page for i2o_msg_get

I2O_MSG_GET(9)						       Message-based devices						    I2O_MSG_GET(9)

NAME
       i2o_msg_get - obtain an I2O message from the IOP

SYNOPSIS
       struct i2o_message * i2o_msg_get(struct i2o_controller * c);

ARGUMENTS
       c
	   I2O controller

DESCRIPTION
       This function tries to get a message frame. If no message frame is available do not wait until one is availabe (see also i2o_msg_get_wait).
       The returned pointer to the message frame is not in I/O memory, it is allocated from a mempool. But because a MFA is allocated from the
       controller too it is guaranteed that i2o_msg_post will never fail.

       On a success a pointer to the message frame is returned. If the message queue is empty -EBUSY is returned and if no memory is available
       -ENOMEM is returned.

COPYRIGHT
Kernel Hackers Manual 2.6.					     July 2010							    I2O_MSG_GET(9)