t_rcvrel(S) (TLI/XTI) 6 January 1993 t_rcvrel(S) Name t_rcvrel - acknowledge receipt of an orderly release indication Syntax TLI syntax cc . . . -lnsls #include <sys/tiuser.h> t_rcvrel (fd) int fd; XTI syntax cc . . . -lxti #include <xti.h> t_rcvrel (fd) int fd; Description This function is used to acknowledge receipt of an orderly release indi- cation. fd identifies the local transport endpoint where the connection exists. After receipt of this indication, the user may not attempt to receive more data because such an attempt will block forever. However, the user may continue to send data over the connection if tsndrel has not been issued by the user. This function is an optional service of the transport provider, and is only supported if the transport provider returned service type TCOTSORD on topen or tgetinfo. On failure, terrno may be set to one of the following: [TBADF] The specified file descriptor does not refer to a transport endpoint. [TLOOK] An asynchronous event has occurred on this transport endpoint and requires immediate attention. [TNOREL] No orderly release indication currently exists on the specified transport endpoint. [TNOTSUPPORT] Without the TCOTSORD service type being set, this function is not supported by the underlying transport provider. [TOUTSTATE] (XTI only.) The state was incorrect when this rou- tine was called. [TSYSERR] A system error occurred during execution of this function. One possibility is an I/O error and is indicated by errno being set to EIO. Another is a protocol error and is indicated by errno being set to EPROTO. Diagnostics The trcvrel function returns 0 on success and -1 on failure, and terrno is set to indicate the error. See also topen(S), tsndrel(S) Standards conformance trcvrel is conformant with: AT&T SVID Issue 2; X/Open Portability Guide, Issue 3, 1989; and Intel386 Binary Compatibility Specification, Edition 2 (iBCSe2).