t_rcvdis(3)                         CLIX                         t_rcvdis(3)



  NAME

    t_rcvdis - Retrieves information from disconnect

  LIBRARY

    The Transport Layer Interface (TLI) Library (libnsl_s.a*O)

  SYNOPSIS

    #include <tiuser.h>

    t_rcvdis(
      int fd ,
      struct t_discon *discon );

  PARAMETERS

    fd       Identifies the local transport endpoint where the connection
             existed.

    discon   Points to a t_discon structure.

  DESCRIPTION

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

    struct netbuf udata;
    int reason;
    int sequence;

    The netbuf is described in intro.  The 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.
    The sequence is only meaningful when t_rcvdis() is issued by a passive
    transport user who has executed one or more t_listen() 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 [with t_listen()]
    and discon is NULL, the user is unable to identify which connect
    indication the disconnect is associated.




  2/94 - Intergraph Corporation                                              1

  t_rcvdis(3)                         CLIX                         t_rcvdis(3)



  RETURN VALUES

    The t_rcvdis() function returns 0 on success and -1 on failure and 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.

    [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 T_IDLE, and the disconnect indication information to be
           returned in discon will be discarded.

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

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

  RELATED INFORMATION

    Functions:  t_connect(3), t_listen(3), t_open(3), t_snddis(3)

    AT&T UNIX System V Network Programmer's Guide



















  2                                              Intergraph Corporation - 2/94