t_rcvdis(3N)      UNIX System V(Networking Support Utilities)      t_rcvdis(3N)


NAME
      trcvdis - retrieve information from disconnect

SYNOPSIS
      #include <tiuser.h>

      trcvdis (int fd, struct tdiscon *discon);

DESCRIPTION
      This function is used to identify the cause of a disconnect, and to
      retrieve any user data sent with the disconnect.  fd identifies the local
      transport endpoint where the connection existed, and discon points to a
      tdiscon structure containing the following members:

            struct netbuf udata;
            int reason;
            int sequence;

      netbuf is described in intro(3N).  reason specifies the reason for the
      disconnect through a protocol-dependent reason code, udata identifies any
      user data that was sent with the disconnect, and sequence may identify an
      outstanding connect indication with which the disconnect is associated.
      sequence is only meaningful when trcvdis is issued by a passive
      transport user who has executed one or more tlisten functions and is
      processing the resulting connect indications.  If a disconnect indication
      occurs, sequence can be used to identify which of the outstanding connect
      indications is associated with the disconnect.

      If a user does not care if there is incoming data and does not need to
      know the value of reason or sequence, discon may be NULL and any user
      data associated with the disconnect will be discarded.  However, if a
      user has retrieved more than one outstanding connect indication (via
      tlisten) and discon is NULL, the user will be unable to identify which
      connect indication the disconnect is associated with.

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

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

      TNODIS              No disconnect indication currently exists on the
                          specified transport endpoint.

      TBUFOVFLW           The number of bytes allocated for incoming data is
                          not sufficient to store the data.  The provider's
                          state, as seen by the user, will change to TIDLE,
                          and the disconnect indication information to be
                          returned in discon will be discarded.

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



10/89                                                                    Page 1

t_rcvdis(3N)      UNIX System V(Networking Support Utilities)      t_rcvdis(3N)


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




















































Page 2                                                                    10/89

t_rcvdis(3N)      UNIX System V(Networking Support Utilities)      t_rcvdis(3N)


SEE ALSO
      intro(3N), tconnect(3N), tlisten(3N), topen(3N), tsnddis(3N)
      Programmer's Guide:  Networking Interfaces

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















































10/89                                                                    Page 3