@c
@c This is the chapter from the RTEMS ITRON User's Guide that
@c documents the services provided by the message buffer
@c manager.
@c
@c $Id$
@c
@chapter Message Buffer Manager
@section Introduction
The
message buffer manager is ...
The services provided by the message buffer manager are:
@itemize @bullet
@item @code{cre_mbf} - Create MessageBuffer
@item @code{del_mbf} - Delete MessageBuffer
@item @code{snd_mbf} - Send Message to MessageBuffer
@item @code{psnd_mbf} - Poll and Send Message to MessageBuffer
@item @code{tsnd_mbf} - Send Message to MessageBuffer with Timeout
@item @code{rcv_mbf} - Receive Message from MessageBuffer
@item @code{prcv_mbf} - Poll and Receive Message from MessageBuffer
@item @code{trcv_mbf} - Receive Message from MessageBuffer with Timeout
@item @code{ref_mbf} - Reference MessageBuffer Status
@end itemize
@section Background
@section Operations
@section System Calls
This section details the message buffer manager's services.
A subsection is dedicated to each of this manager's services
and describes the calling sequence, related constants, usage,
and status codes.
@c
@c cre_mbf
@c
@page
@subsection cre_mbf - Create MessageBuffer
@subheading CALLING SEQUENCE:
@ifset is-C
@example
ER cre_mbf(
ID mbfid,
T_CMBF *pk_cmbf
);
@end example
@end ifset
@ifset is-Ada
@end ifset
@subheading STATUS CODES:
@code{EXXX} -
@subheading DESCRIPTION:
@subheading NOTES:
@c
@c del_mbf
@c
@page
@subsection del_mbf - Delete MessageBuffer
@subheading CALLING SEQUENCE:
@ifset is-C
@example
ER del_mbf(
ID mbfid
);
@end example
@end ifset
@ifset is-Ada
@end ifset
@subheading STATUS CODES:
@code{EXXX} -
@subheading DESCRIPTION:
@subheading NOTES:
@c
@c snd_mbf
@c
@page
@subsection snd_mbf - Send Message to MessageBuffer
@subheading CALLING SEQUENCE:
@ifset is-C
@example
ER snd_mbf(
ID mbfid,
VP msg,
INT msgsz
);
@end example
@end ifset
@ifset is-Ada
@end ifset
@subheading STATUS CODES:
@code{EXXX} -
@subheading DESCRIPTION:
@subheading NOTES:
@c
@c psnd_mbf
@c
@page
@subsection psnd_mbf - Poll and Send Message to MessageBuffer
@subheading CALLING SEQUENCE:
@ifset is-C
@example
ER ercd =psnd_mbf(
ID mbfid,
VP msg,
INT msgsz
);
@end example
@end ifset
@ifset is-Ada
@end ifset
@subheading STATUS CODES:
@code{EXXX} -
@subheading DESCRIPTION:
@subheading NOTES:
@c
@c tsnd_mbf
@c
@page
@subsection tsnd_mbf - Send Message to MessageBuffer with Timeout
@subheading CALLING SEQUENCE:
@ifset is-C
@example
ER ercd =tsnd_mbf(
ID mbfid,
VP msg,
INT msgsz,
TMO tmout
);
@end example
@end ifset
@ifset is-Ada
@end ifset
@subheading STATUS CODES:
@code{EXXX} -
@subheading DESCRIPTION:
@subheading NOTES:
@c
@c rcv_mbf
@c
@page
@subsection rcv_mbf - Receive Message from MessageBuffer
@subheading CALLING SEQUENCE:
@ifset is-C
@example
ER rcv_mbf(
VP msg,
INT *p_msgsz,
ID mbfid
);
@end example
@end ifset
@ifset is-Ada
@end ifset
@subheading STATUS CODES:
@code{EXXX} -
@subheading DESCRIPTION:
@subheading NOTES:
@c
@c prcv_mbf
@c
@page
@subsection prcv_mbf - Poll and Receive Message from MessageBuffer
@subheading CALLING SEQUENCE:
@ifset is-C
@example
ER ercd =prcv_mbf(
VP msg,
INT *p_msgsz,
ID mbfid
);
@end example
@end ifset
@ifset is-Ada
@end ifset
@subheading STATUS CODES:
@code{EXXX} -
@subheading DESCRIPTION:
@subheading NOTES:
@c
@c trcv_mbf
@c
@page
@subsection trcv_mbf - Receive Message from MessageBuffer with Timeout
@subheading CALLING SEQUENCE:
@ifset is-C
@example
ER ercd =trcv_mbf(
VP msg,
INT *p_msgsz,
ID mbfid,
TMO tmout
);
@end example
@end ifset
@ifset is-Ada
@end ifset
@subheading STATUS CODES:
@code{EXXX} -
@subheading DESCRIPTION:
@subheading NOTES:
@c
@c ref_mbf
@c
@page
@subsection ref_mbf - Reference MessageBuffer Status
@subheading CALLING SEQUENCE:
@ifset is-C
@example
ER ref_mbf(
T_RMBF *pk_rmbf,
ID mbfid
);
@end example
@end ifset
@ifset is-Ada
@end ifset
@subheading STATUS CODES:
@code{EXXX} -
@subheading DESCRIPTION:
@subheading NOTES: