TSNDREL(3N-SVR4)   RISC/os Reference Manual    TSNDREL(3N-SVR4)



NAME
     t_sndrel - initiate an orderly release

SYNOPSIS
     #include <tiuser.h>

     int tsndrel (int fd);

DESCRIPTION
     This function is used to initiate an orderly release of a
     transport connection and indicates to the transport provider
     that the transport user has no more data to send.  fd iden-
     tifies the local transport endpoint where the connection
     exists.  After issuing tsndrel, the user may not send any
     more data over the connection.  However, a user may continue
     to receive data if an orderly release indication has not
     been received.

     This function is an optional service of the transport pro-
     vider, and is only supported if the transport provider
     returned service type T_COTS_ORD on t_open or t_getinfo.

     If tsndrel is issued from an invalid state, the provider
     will generate an EPROTO protocol error; however, this error
     may not occur until a subsequent reference to the transport
     endpoint.

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

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

     [TFLOW]             O_NDELAY or O_NONBLOCK was set, but the
                         flow control mechanism prevented the
                         transport provider from accepting the
                         function at this time.

     [TNOTSUPPORT]       This function is not supported by the
                         underlying transport provider.

     [TSYSERR]           A system error has occurred during exe-
                         cution of this function.

SEE ALSO
     t_open(3N), t_rcvrel(3N).

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






                        Printed 11/19/92                   Page 1