t_snddis(3N)            LIBRARY FUNCTIONS            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 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 tran-
                        sport provider.  The transport provider's
                        outgoing  queue  will be flushed, so data



                                                                1

t_snddis(3N)            LIBRARY FUNCTIONS            t_snddis(3N)



                        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),   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.





























                                                                2