t_rcvrel(3N)                                            t_rcvrel(3N)


       NAME
             t_rcvrel - acknowledge receipt of an orderly release
             indication

       SYNOPSIS
             cc [options] file -lnsl
             #include <xti.h>
             int t_rcvrel(int fd);

          Parameters
             fd    the file descriptor for the transport endpoint where the
                   connect indication is received.

       DESCRIPTION
             This function is a TLI/XTI connection release routine used to
             acknowledge receipt of an orderly release indication.  In
             t_rcvrel, 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.

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

          Errors
             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 the transport
                       endpoint specified by fd and requires immediate
                       attention.





                           Copyright 1994 Novell, Inc.               Page 1

      t_rcvrel(3N)                                            t_rcvrel(3N)


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

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

            TOUTSTATE The function was issued in the wrong sequence on the
                      transport endpoint referenced by fd.

            TPROTO    A communication problem has been detected with the
                      transport provider and there is no other value of
                      t_errno to describe the error condition.

         State Transitions
            T_DATAXFER on entry and T_INREL on exit; or T_OUTREL on entry
            and T_IDLE on exit.

         Files
            /usr/lib/libxti.so
                              X/Open Transport Interface Library (shared
                              object)
            /usr/lib/libnsl.so
                              Network Services Library (shared object)

      REFERENCES
            t_open(3N), t_sndrel(3N)





















                          Copyright 1994 Novell, Inc.               Page 2