t_rcvrel(3N)

NAME
     t_rcvrel - acknowledge receipt of an orderly release indication

SYNOPSIS
     #ifdef _XOPEN_SOURCE
     #include <xti.h>
     #else
     #include <tiuser.h>
     #endif

     t_rcvrel (int fd);

DESCRIPTION
     This function is used to acknowledge receipt of an orderly release
     indication.  fd identifies the local transport endpoint where the
     connection exists.  After receipt of this indication, the user should 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
     t_sndrel 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 T_COTS_ORD
     on t_open or t_getinfo.

     This function resides within both the X/Open compliant libxnet and the
     SVR4 compliant libnsl Network Services libraries.  Network Services
     applications which require X/Open compliance must link-load with -lxnet.
     Network Services applications which require SVR4 compliance must link-
     load with -lnsl.

     On failure, t_errno may be set to one of the following:

     TBADF               The specified file descriptor does not refer to a
                         transport endpoint.

     TNOREL              No orderly release indication currently exists on the
                         specified transport endpoint.

     TLOOK               An asynchronous event has occurred on this transport
                         endpoint and requires immediate attention.

     TNOTSUPPORT         This function is not supported by the underlying
                         transport provider.

     TOUTSTATE           If _XOPEN_SOURCE is defined and t_rcvrel() is issued
                         in the wrong sequence on the transport endpoint
                         referenced by fd, the TOUTSTATE error value is
                         returned within the variable t_errno.

     TSYSERR             A system error has occurred during execution of this
                         function.
SEE ALSO
     t_open(3N), t_sndrel(3N)

DIAGNOSTICS
     t_rcvrel returns 0 on success and -1 on failure t_errno is set to
     indicate the error.