t_snddis(3N)                   DG/UX 5.4R3.00                   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(3).  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 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 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 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



Licensed material--property of copyright holder(s)                         1

t_snddis(3N)                   DG/UX 5.4R3.00                   t_snddis(3N)


                          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(3), tconnect(3N), tgetinfo(3N), tlisten(3N), topen(3N).
       UNIX System V Network Programmer's Guide.

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





































Licensed material--property of copyright holder(s)                         2