DOC HOME SITE MAP MAN PAGES GNU INFO SEARCH PRINT BOOK
 

OSMMsgMfaConvert(D3i2o)


OSMMsgMfaConvert -- return preserved message frame address if function fails

Synopsis

#include <i2o/i2omsg.h>
#include <i2o/common.h>

I2O_MESSAGE_FRAME *OSMMsgMfaConvert(int IopNum, U32 mfa)

Description

OSMMsgMfaConvert passes the mfa address (from the message) which will be an offset in the IOP's address space (normally mapped directly to a system-space physical address), and returns a kernel virtual address for that mfa.

Arguments


IopNum
The number of the IOP.

mfa
The preserved message frame address.

Return values

OSMMsgMfaConvert returns a valid kernel virtual address, or NULL if the mapping fails for any reason.


NOTE: OSMMsgMfaConvert will only correctly convert mfas from the inbound FIFO.

Usage

OSMMsgMfaConvert is normally called when the OSM discovers that a function has failed and that a preserved mfa exists.

Context

All contexts

Synchronization constraints

Does not block.

Driver-defined basic locks, read/write locks, and sleep locks may be held across calls to this function.

Hardware applicability

All

Version applicability

i2omsg: in HDK Technical Reference 2

Differences between versions

None

References

Intro(D3i2o)
19 June 2005
© 2005 The SCO Group, Inc. All rights reserved.
OpenServer 6 and UnixWare (SVR5) HDK - June 2005