T_SNDDIS(3N)         INTERACTIVE UNIX System         T_SNDDIS(3N)



          NAME
               t_snddis - send user-initiated disconnect request

          SYNOPSIS
               #include <tiuser.h>

               int t_snddis(fd, call)
               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.  Fd identifies the local transport endpoint of the
               connection, and call specifies information associated with
               the abortive release.  Call points to a t_call structure
               which contains the following members:

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

               Netbuf is described in intro(3).  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.

               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]        The function was issued in the wrong
                                  sequence.  The transport provider's out-
                                  going queue may be flushed, so data may
                                  be lost.

               [TBADDATA]         The amount of user data specified was not
                                  within the bounds allowed by the


          Rev. Networking Support Utilities                          Page 1

          T_SNDDIS(3N)         INTERACTIVE UNIX System         T_SNDDIS(3N)



                                  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 execu-
                                  tion of this function.

          SEE ALSO
               intro(3), t_connect(3N), t_getinfo(3N), t_listen(3N),
               t_open(3N).
               Programmer's Guide.

          DIAGNOSTICS
               The t_snddis function returns 0 on success and -1 on
               failure, and t_errno is set to indicate the error.



























          Rev. Networking Support Utilities                          Page 2