mirror of
https://gitlab.rtems.org/rtems/rtos/rtems.git
synced 2025-12-05 23:23:13 +00:00
302 lines
4.2 KiB
Perl
302 lines
4.2 KiB
Perl
@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 - Poll and Send Message to MessageBuffer Send Message to MessageBuffer Send Message to MessageBuffer with Timeout
|
|
|
|
@subheading CALLING SEQUENCE:
|
|
|
|
@ifset is-C
|
|
@example
|
|
ER snd_mbf (
|
|
ID mbfid, VP msg, INT msgsz ER ercd =psnd_mbf
|
|
);
|
|
@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 - Poll and Receive Message from MessageBuffer Receive Message from MessageBuffer Receive Message from MessageBuffer with Timeout
|
|
|
|
@subheading CALLING SEQUENCE:
|
|
|
|
@ifset is-C
|
|
@example
|
|
ER rcv_mbf (
|
|
VP msg, INT *p_msgsz, ID mbfid ER ercd =prcv_mbf
|
|
);
|
|
@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:
|
|
|