Content-type: text/html
t_rcvrel - Acknowledges receipt of an orderly release indication
#include <xti.h> int t_rcvrel(
int fd) ;
Interfaces documented on this reference page conform to industry standards as follows:
t_rcvrel: XPG4-UNIX
Refer to the standards(5) reference page for more information about industry standards and associated tags.
The following table summarizes the relevance of input parameter data before and after t_rcvrel() is called:
Parameter | Before Call | After Call |
fd | y | n |
y This is a meaningful parameter. n This is not a meaningful parameter.
The t_rcvrel() function can be called only in the T_DATAXFER and T_OUTREL transport provider states.
The t_rcvrel() XTI function is used in connection-oriented mode to acknowledge receipt of an orderly release indication at a transport endpoint. The released endpoint is specified by a file descriptor previously returned by the t_open() function.
After receipt of this orderly release indication, at the transport endpoint specified by the file descriptor, a transport user should not try to receive additional data from that transport endpoint. Any attempt to receive more data from a released transport endpoint blocks continuously. However, a transport user may continue to send data across the connection until a release is sent by a transport user who invokes a t_sndrel() function call.
The t_rcvrel() function should not be used unless the servtype type-of-service returned by the t_open() or t_getinfo() functions is T_COTS_ORD (supports connection-mode service with the optional orderly release facility).
Upon successful completion, a value of 0 (zero) is returned. Otherwise, a value of -1 is returned and t_errno is set to indicate the error.
If the t_rcvrel() function fails, t_errno may be set to one of the following values:
Functions: t_getinfo(3), t_open(3), t_sndrel(3) delim off