t_snddis(3)                         CLIX                         t_snddis(3)



  NAME

    t_snddis - Sends user-initiated disconnect request

  LIBRARY

    Transport Layer Interface (TLI) Library (libnsl_s.a)

  SYNOPSIS

    #include <tiuser.h>

    int t_snddis(
      int fd ,
      struct t_call *call );

  DESCRIPTION

    This function is used to initiate an abortive release on an already
    established connection or to reject a connect request.   The fd identifies
    the local transport endpoint of the connection, and call specifies
    information associated with the abortive release.  The call parameter
    points to a t_call structure which contains the following members:

    struct netbuf addr;
    struct netbuf opt;
    struct netbuf udata;
    int sequence;

    The netbuf is described in intro.  The values in call have different
    semantics, depending on the context of the call to t_snddis().  When
    rejecting a connect request, call must be non-NULL and contain a valid
    value of sequence to uniquely identify the rejected connect indication to
    the transport provider.  The addr and opt fields of call are ignored.  In
    all other cases, call need only be used when data is being sent with the
    disconnect request.  The addr, opt, and sequence fields of the t_call
    structure are ignored.  If the user does not wish to send data to the
    remote user, the value of call may be NULL.

    The udata specifies the user data to be sent to the remote user.  The
    amount of user data must not exceed the limits supported by the transport
    provider as returned by t_open() or t_getinfo().  If the len field of
    udata is zero, no data will be sent to the remote user.

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

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

    [TOUTSTATE]



  2/94 - Intergraph Corporation                                              1

  t_snddis(3)                         CLIX                         t_snddis(3)



           The function was issued in the wrong sequence.  The transport
           provider's outgoing queue may be flushed, so data may be lost.

    [TBADDATA]
           The amount of user data specified was not within the bounds allowed
           by the transport provider.  The transport provider's outgoing queue
           will be flushed, so data may be lost.

    [TBADSEQ]
           An invalid sequence number was specified, or a NULL call structure
           was specified when rejecting a connect request.  The transport
           provider's outgoing queue will be flushed, so data may be lost.

    [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.

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

  RETURN VALUES

    The t_snddis() returns 0 on success and -1 on failure and t_errno is set
    to indicate the error.

  RELATED INFORMATION

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

    AT&T UNIX System V Network Programmer's Guide




















  2                                              Intergraph Corporation - 2/94