I2O_MSG_GET

Section: Message-based devices (9)
Updated: February 2011
Index Return to Main Contents
 

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