forked from Imagelibrary/rtems
351 lines
4.5 KiB
Perl
351 lines
4.5 KiB
Perl
@c
|
|
@c This is the chapter from the RTEMS ITRON User's Guide that
|
|
@c documents the services provided by the rendezvous
|
|
@c manager.
|
|
@c
|
|
@c $Id$
|
|
@c
|
|
|
|
@chapter Rendezvous Manager
|
|
|
|
@section Introduction
|
|
|
|
The
|
|
rendezvous manager is ...
|
|
|
|
The services provided by the rendezvous manager are:
|
|
|
|
@itemize @bullet
|
|
@item @code{cre_por} - Create Port for Rendezvous
|
|
@item @code{del_por} - Delete Port for Rendezvous
|
|
@item @code{cal_por} - Call Port for Rendezvous
|
|
Poll and Call Port for Rendezvous
|
|
Call Port for Rendezvous with Timeout
|
|
@item @code{pcal_por} - Poll and Call Port for Rendezvous
|
|
@item @code{tcal_por} - Call Port for Rendezvous with Timeout
|
|
@item @code{acp_por} - Accept Port for Rendezvous
|
|
Poll and Accept Port for Rendezvous
|
|
Accept Port for Rendezvous with Timeout
|
|
@item @code{pacp_por} - Poll and Accept Port for Rendezvous
|
|
@item @code{tacp_por} - Accept Port for Rendezvous with Timeout
|
|
@item @code{fwd_por} - Forward Rendezvous to Other Port
|
|
@item @code{rpl_rdv} - Reply Rendezvous
|
|
@item @code{ref_por} - Reference Port Status
|
|
@end itemize
|
|
|
|
@section Background
|
|
|
|
@section Operations
|
|
|
|
@section System Calls
|
|
|
|
This section details the rendezvous 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_por
|
|
@c
|
|
|
|
@page
|
|
@subsection cre_por - Create Port for Rendezvous
|
|
|
|
@subheading CALLING SEQUENCE:
|
|
|
|
@ifset is-C
|
|
@example
|
|
int cre_por(
|
|
);
|
|
@end example
|
|
@end ifset
|
|
|
|
@ifset is-Ada
|
|
@end ifset
|
|
|
|
@subheading STATUS CODES:
|
|
|
|
@code{EXXX} -
|
|
|
|
@subheading DESCRIPTION:
|
|
|
|
@subheading NOTES:
|
|
|
|
|
|
@c
|
|
@c del_por
|
|
@c
|
|
|
|
@page
|
|
@subsection del_por - Delete Port for Rendezvous
|
|
|
|
@subheading CALLING SEQUENCE:
|
|
|
|
@ifset is-C
|
|
@example
|
|
int del_por(
|
|
);
|
|
@end example
|
|
@end ifset
|
|
|
|
@ifset is-Ada
|
|
@end ifset
|
|
|
|
@subheading STATUS CODES:
|
|
|
|
@code{EXXX} -
|
|
|
|
@subheading DESCRIPTION:
|
|
|
|
@subheading NOTES:
|
|
|
|
|
|
@c
|
|
@c cal_por
|
|
@c
|
|
|
|
@page
|
|
@subsection cal_por - Call Port for Rendezvous
|
|
Poll and Call Port for Rendezvous
|
|
Call Port for Rendezvous with Timeout
|
|
|
|
@subheading CALLING SEQUENCE:
|
|
|
|
@ifset is-C
|
|
@example
|
|
int cal_por(
|
|
);
|
|
@end example
|
|
@end ifset
|
|
|
|
@ifset is-Ada
|
|
@end ifset
|
|
|
|
@subheading STATUS CODES:
|
|
|
|
@code{EXXX} -
|
|
|
|
@subheading DESCRIPTION:
|
|
|
|
@subheading NOTES:
|
|
|
|
|
|
@c
|
|
@c pcal_por
|
|
@c
|
|
|
|
@page
|
|
@subsection pcal_por - Poll and Call Port for Rendezvous
|
|
|
|
@subheading CALLING SEQUENCE:
|
|
|
|
@ifset is-C
|
|
@example
|
|
int pcal_por(
|
|
);
|
|
@end example
|
|
@end ifset
|
|
|
|
@ifset is-Ada
|
|
@end ifset
|
|
|
|
@subheading STATUS CODES:
|
|
|
|
@code{EXXX} -
|
|
|
|
@subheading DESCRIPTION:
|
|
|
|
@subheading NOTES:
|
|
|
|
|
|
@c
|
|
@c tcal_por
|
|
@c
|
|
|
|
@page
|
|
@subsection tcal_por - Call Port for Rendezvous with Timeout
|
|
|
|
@subheading CALLING SEQUENCE:
|
|
|
|
@ifset is-C
|
|
@example
|
|
int tcal_por(
|
|
);
|
|
@end example
|
|
@end ifset
|
|
|
|
@ifset is-Ada
|
|
@end ifset
|
|
|
|
@subheading STATUS CODES:
|
|
|
|
@code{EXXX} -
|
|
|
|
@subheading DESCRIPTION:
|
|
|
|
@subheading NOTES:
|
|
|
|
|
|
@c
|
|
@c acp_por
|
|
@c
|
|
|
|
@page
|
|
@subsection acp_por - Accept Port for Rendezvous
|
|
Poll and Accept Port for Rendezvous
|
|
Accept Port for Rendezvous with Timeout
|
|
|
|
@subheading CALLING SEQUENCE:
|
|
|
|
@ifset is-C
|
|
@example
|
|
int acp_por(
|
|
);
|
|
@end example
|
|
@end ifset
|
|
|
|
@ifset is-Ada
|
|
@end ifset
|
|
|
|
@subheading STATUS CODES:
|
|
|
|
@code{EXXX} -
|
|
|
|
@subheading DESCRIPTION:
|
|
|
|
@subheading NOTES:
|
|
|
|
|
|
@c
|
|
@c pacp_por
|
|
@c
|
|
|
|
@page
|
|
@subsection pacp_por - Poll and Accept Port for Rendezvous
|
|
|
|
@subheading CALLING SEQUENCE:
|
|
|
|
@ifset is-C
|
|
@example
|
|
int pacp_por(
|
|
);
|
|
@end example
|
|
@end ifset
|
|
|
|
@ifset is-Ada
|
|
@end ifset
|
|
|
|
@subheading STATUS CODES:
|
|
|
|
@code{EXXX} -
|
|
|
|
@subheading DESCRIPTION:
|
|
|
|
@subheading NOTES:
|
|
|
|
|
|
@c
|
|
@c tacp_por
|
|
@c
|
|
|
|
@page
|
|
@subsection tacp_por - Accept Port for Rendezvous with Timeout
|
|
|
|
@subheading CALLING SEQUENCE:
|
|
|
|
@ifset is-C
|
|
@example
|
|
int tacp_por(
|
|
);
|
|
@end example
|
|
@end ifset
|
|
|
|
@ifset is-Ada
|
|
@end ifset
|
|
|
|
@subheading STATUS CODES:
|
|
|
|
@code{EXXX} -
|
|
|
|
@subheading DESCRIPTION:
|
|
|
|
@subheading NOTES:
|
|
|
|
|
|
@c
|
|
@c fwd_por
|
|
@c
|
|
|
|
@page
|
|
@subsection fwd_por - Forward Rendezvous to Other Port
|
|
|
|
@subheading CALLING SEQUENCE:
|
|
|
|
@ifset is-C
|
|
@example
|
|
int fwd_por(
|
|
);
|
|
@end example
|
|
@end ifset
|
|
|
|
@ifset is-Ada
|
|
@end ifset
|
|
|
|
@subheading STATUS CODES:
|
|
|
|
@code{EXXX} -
|
|
|
|
@subheading DESCRIPTION:
|
|
|
|
@subheading NOTES:
|
|
|
|
|
|
@c
|
|
@c rpl_rdv
|
|
@c
|
|
|
|
@page
|
|
@subsection rpl_rdv - Reply Rendezvous
|
|
|
|
@subheading CALLING SEQUENCE:
|
|
|
|
@ifset is-C
|
|
@example
|
|
int rpl_rdv(
|
|
);
|
|
@end example
|
|
@end ifset
|
|
|
|
@ifset is-Ada
|
|
@end ifset
|
|
|
|
@subheading STATUS CODES:
|
|
|
|
@code{EXXX} -
|
|
|
|
@subheading DESCRIPTION:
|
|
|
|
@subheading NOTES:
|
|
|
|
|
|
@c
|
|
@c ref_por
|
|
@c
|
|
|
|
@page
|
|
@subsection ref_por - Reference Port Status
|
|
|
|
@subheading CALLING SEQUENCE:
|
|
|
|
@ifset is-C
|
|
@example
|
|
int ref_por(
|
|
);
|
|
@end example
|
|
@end ifset
|
|
|
|
@ifset is-Ada
|
|
@end ifset
|
|
|
|
@subheading STATUS CODES:
|
|
|
|
@code{EXXX} -
|
|
|
|
@subheading DESCRIPTION:
|
|
|
|
@subheading NOTES:
|
|
|