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


NAME
      tsnddis - send user-initiated disconnect request

SYNOPSIS
      #include <tiuser.h>

      int tsnddis (int fd, struct tcall *call):

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

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

      netbuf is described in intro(3N).  The values in call have different
      semantics, depending on the context of the call to tsnddis.  When
      rejecting a connect request, call must be non-NULL and contain a valid
      value of sequence to identify uniquely 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 tcall
      structure are ignored.  If the user does not want to send data to the
      remote user, the value of call may be NULL.

      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 in the discon field of the info argument of topen
      or tgetinfo.  If the len field of udata is zero, no data will be sent to
      the remote user.

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

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

      TOUTSTATE          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 supported by the transport provider as returned
                         in the discon field of the info argument of topen or
                         tgetinfo.  The transport provider's outgoing queue
                         will be flushed, so data may be lost.




10/89                                                                    Page 1

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


      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.

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

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

































Page 2                                                                    10/89