t_rcvrel(3)                                                 t_rcvrel(3)

  t_rcvrel()

  NAME

    t_rcvrel - acknowledge receipt of an orderly release indication

  SYNOPSIS

    #include 

    int t_rcvrel(
        int fd)

  DESCRIPTION

    This function is used to receive an orderly release indication for the
    incoming direction of data transfer.

    Parameters     Before call     After call

    fd             x               /

    The argument fd identifies the local transport endpoint where the
    connection exists. After receipt of this indication, the user may not
    attempt to receive more data through t_rcv(3) or t_rcvv(3). Such an
    attempt will fail with t_error set to [TOUTSTATE]. However, the user may
    continue to send data over the connection if t_sndrel(3) has not been
    called 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(3) or t_getinfo(3). Any user data that may be
    associated with the orderly release indication is discarded when
    t_rcvrel(3) is called.

  VALID STATES

    T_DATAXFER,T_OUTREL

  ERRORS

    On failure, t_errno is 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]
        This function is not supported by the underlying transport provider.

    [TOUTSTATE]
        The communications endpoint referenced by fd is not in one of the
        states in which a call to this function is valid.

    [TPROTO]
        This error indicates that a communication problem has been detected
        between XTI and the transport provider for which there is no other
        suitable XTI error (t_errno).

    [TSYSERR]
        A system error has occurred during execution of this function.

  RETURN VALUE

    Upon successful completion, a value of 0 is returned. Otherwise, a value
    of -1 is returned and t_errno is set to indicate an error.

  SEE ALSO

    t_getinfo(3)

    t_open(3)

    t_sndrel(3)

  USAGE NOTES

    The t_rcvrel function is not thread safe.

    The t_rcvrel function is not async-signal safe.