t_sndrel(3xti)
Name
t_sndrel − initiate an orderly release
Syntax
#include <xti.h>
int t_sndrel(fd)
int fd;
Arguments
fdIdentifies the local transport endpoint where the connection exists.
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. After issuing t_sndrel(), the user can not send any more data over the connection. However, a user can continue to receive data if an orderly indication has not been received.
This function is an optional service of the transport provider and is only supported if the transport provider returned service type T_COTS_ORD on t_open() or t_getinfo().
| Parameters | Before Call | After Call |
| fd | x | / |
Return Values
Upon successful completion, a value of 0 is returned. On failure, a value of −1 is returned, and t_errno is set to indicate the error.
Diagnostics
On failure, t_errno is 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 on the transport endpoint referenced by fd.
[TFLOW] O_NONBLOCK was set, but the flow control mechanism prevented the transport provider from accepting the function at this time.
[TLOOK] An asynchronous event has occurred on the transport endpoint referenced by fd 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.