T-Kernel Specification (1.B0.02)

4.5. EXTENDED SYNCHRONIZATION AND COMMUNICATION FUNCTIONS 131
tk del por
Delete Port for Rendezvous
[C Language Interface]
ER ercd = tk_del_por ( ID porid ) ;
[Parameters]
ID porid Rendezvous port ID
[Return Parameters]
ER ercd Error code
[Error Codes]
E OK
E ID
E NOEXS
Normal completion
Invalid ID number (porid is invalid or cannot be used)
Object does not exist (the rendezvous port designated in porid does not exist)
[Description]
Deletes the rendezvous port designated in porid.
Issuing this system call releases the ID number and control block space allocated to the rendezvous port.
This system call completes normally even if there are tasks waiting on rendezvous acceptance (tk acp por)
or rendezvous port call (tk cal por) at the designated rendezvous port, but error code E DLT is returned
to the tasks in WAIT state.
Deletion of a rendezvous port by tk del por does not affect tasks for which rendezvous is already
established. In this case, nothing is reported to the task accepting the rendezvous (not in WAIT state),
and the state of the task calling the rendezvous (WAIT for rendezvous completion) remains unchanged.
When the task accepting the rendezvous issues tk rpl rdv, that system call will execute normally even
if the port on which the rendezvous was established has been deleted.
Copyright c○ 2002, 2003 by T-Engine Forum
T-Kernel 1.B0.02