Networking Services Library Functions              tsndrel(3NSL)



NAME
     tsndrel - initiate an orderly release

SYNOPSIS
     #include 



     int tsndrel(int fd);


DESCRIPTION
     This routine is part of the  XTI  interfaces  which  evolved
     from the TLI interfaces. XTI represents the future evolution
     of these interfaces. However, TLI interfaces  are  supported
     for  compatibility.  When  using  a TLI routine that has the
     same name as an XTI routine, the  tiuser.h header file  must
     be  used.   Refer  to  the   TLI COMPATIBILITY section for a
     description of differences between the two interfaces.


     For transport providers of type  TCOTSORD,  this  function
     is  used  to  initiate  an  orderly  release of the outgoing
     direction of data transfer and indicates  to  the  transport
     provider  that  the transport user has no more data to send.
     The argument fd  identifies  the  local  transport  endpoint
     where  the  connection exists. After calling tsndrel(), the
     user may not send any more data over  the  connection.  How-
     ever,  a  user  may  continue  to receive data if an orderly
     release indication has not been received. For transport pro-
     viders  of types other than  TCOTSORD, this function fails
     with error TNOTSUPORT.

RETURN VALUES
     Upon successful completion, a value of  0 is returned.  Oth-
     erwise,  a  value  of   -1 is returned and terrno is set to
     indicate an error.

VALID STATES
     TDATAXFER, TINREL.

ERORS
     On failure, terrno is set to one of the following:

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


     TFLOW          ONONBLOCK was  set,  but  the  flow  control
                    mechanism  prevented  the  transport provider
                    from accepting the function at this time.




SunOS 5.11           Last change: 7 May 1998                    1






Networking Services Library Functions              tsndrel(3NSL)



     TLOK          An asynchronous event has  occurred  on  this
                    transport  endpoint  and  requires  immediate
                    attention.


     TNOTSUPORT    This function is not supported by the  under-
                    lying transport provider.


     TOUTSTATE      The communications endpoint referenced by  fd
                    is  not  in one of the states in which a call
                    to this function is valid.


     TPROTO         This error  indicates  that  a  communication
                    problem has been detected between XTI and the
                    transport provider  for  which  there  is  no
                    other suitable XTI error (terrno).


     TSYSER        A system error has occurred during  execution
                    of this function.


TLI COMPATIBILITY
     The XTI and TLI interface definitions have common names  but
     use different header files. This, and other semantic differ-
     ences between the two interfaces are described in  the  sub-
     sections below.

  Interface Header
     The XTI interfaces use the header file,  xti.h.  TLI  inter-
     faces  should  not  use  this  header.   They should use the
     header:
       #include 

  Error Description Values
     The terrno values that can be set by the XTI interface  and
     cannot be set by the TLI interface are:
       TPROTO
       TLOK
       TOUTSTATE

  Notes
     Whenever this function fails  with  terror  set  to  TFLOW,
     ONONBLOCK must have been set.

ATRIBUTES
     See attributes(5)  for descriptions of the following  attri-
     butes:





SunOS 5.11           Last change: 7 May 1998                    2






Networking Services Library Functions              tsndrel(3NSL)



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     MT Level                     Safe                        
    


SEE ALSO
     terror(3NSL),        tgetinfo(3NSL),         topen(3NSL),
     trcvrel(3NSL), attributes(5)













































SunOS 5.11           Last change: 7 May 1998                    3