RTEMS 4.7.99.2 On-Line Library

Message Buffer Manager cre_mbf - Create MessageBuffer

RTEMS ITRON 3.0 API User's Guide

6.4.1: cre_mbf - Create MessageBuffer

CALLING SEQUENCE:

ER cre_mbf(
  ID mbfid,
  T_CMBF *pk_cmbf
);

STATUS CODES:

E_OK - Normal Completion

E_NOMEM - Insufficient memory (Memory for control block and/or ring buffer cannot be allocted)

E_ID - Invalid ID number (mbfid was invalid or could not be used)

E_RSATR - Reserved attribute (mbfatr was invalid or could not be used)

E_OBJ - Invalid object state (a messagebuffer of the same ID already exists)

E_OACV - Object access violation (A mbfid less than -4 was specified from a user task. This is implementation dependent.)

E_PAR - Parameter error (pk_cmbf is invalid or bufsz and/or maxmsz is negative or invalid)

EN_OBJNO - An object number which could not be accessed on the target node is specified.

EN_CTXID - Specified an object on another node when the system call was issued from a task in dispatch disabled state or from a task-independent portion

EN_PAR - A value outside the range supported by the target node and/or transmission packet format was specified as a parameter (a value outside supported range was specified for exinf, mbfatr, bufsz and/or maxmsz)

DESCRIPTION:

This routine creates a message buffer on the local node. The message buffer is initialized based on the attributes specified in the pk_cmbf structure. The buffer size and the maximum message size are determined by the bufsz and maxmsz fields in this structure.

The mbfatr field represents attributes of the message buffer. If TA_TFIFO is specified, tasks will be put on the queue on a First In-First Out basis. If TA_TPRI is specified, tasks will be placed on the queue according to their priority.

NOTES:

Multiprocessing is not supported. Thus none of the "EN_" status codes will be returned.

RTEMS ITRON 3.0 API User's Guide