T-Kernel Specification (1.B0.02)

4.5. EXTENDED SYNCHRONIZATION AND COMMUNICATION FUNCTIONS 129
tk cre por
Create Port for Rendezvous
[C Language Interface]
ID porid = tk_cre_por ( T_CPOR *pk_cpor ) ;
[Parameters]
T CPOR* pk cpor Information about the rendezvous port to be created
pk cpor detail:
VP exinf Extended information
ATR poratr Rendezvous port attributes
INT maxcmsz Maximum call message size (in bytes)
INT maxrmsz Maximum reply message size (in bytes)
(Other implementation-dependent parameters may be added beyond this point.)
[Return Parameters]
ID porid Port ID
or Error Code
[Error Codes]
E OK
E NOMEM
E LIMIT
E RSATR
E PAR
Normal completion
Insufficient memory (memory for control block cannot be allocated)
Number of rendezvous ports exceeds the system limit
Reserved attribute (poratr is invalid or cannot be used)
Parameter error (pk cpor is invalid; maxcmsz or maxrmsz is negative or invalid)
[Description]
Creates a rendezvous port, assigning to it a rendezvous port ID number.
This specification allocates a control block to the created rendezvous port. A rendezvous port is an
object used as an OS primitive for implementing a rendezvous capability.
exinf can be used freely by the user to set miscellaneous information about the created rendezvous
port. The information set in this parameter can be referenced by tk ref por. If a larger area is needed
for indicating user information, or if the information may need to be changed after the rendezvous port
is created, this can be done by allocating separate memory for this purpose and putting the memory
packet address in exinf. The OS pays no attention to the contents of exinf.
poratr indicates system attributes in its low bits and implementation-dependent information in the high
bits. Designation in the system attributes part of poratr is as follows.
Copyright c○ 2002, 2003 by T-Engine Forum
T-Kernel 1.B0.02