t_sndrel(3xti)
t_sndrel --
initiate an orderly release
Synopsis
cc [options] file -lnsl
#include <xti.h>
int t_sndrel(int fd);
Description
This function is a TLI/XTI connection release routine
used to initiate an orderly release of a transport connection
associated with the transport endpoint specified by fd.
t_sndrel indicates to the transport provider that
the transport user has no more data to send.
This function is an optional service of the transport provider
and is only supported if the transport provider returned service
type T_COTS or T_COTS_ORD on t_open or t_getinfo.
Parameters
fd-
the file descriptor for the transport endpoint where the
connection exists.
State transitions
T_DATAXFER on entry and T_OUTREL on exit;
or T_INREL on entry and T_IDLE on exit.
Files
/usr/lib/libxti.so-
X/Open® Transport Interface Library (shared object)
/usr/lib/libnsl.so-
Network Services Library (shared object)
Usage
After issuing t_sndrel,
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.
If t_sndrel 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.
Return values
t_sndrel returns 0 on success and -1 on failure and
t_errno is set to indicate the error.
Errors
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_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 execution of this function.
TLOOK-
An asynchronous even has occurred on the transport endpoint
referenced by fd and requires immediate attention.
TOUTSTATE-
The function was issued in the wrong sequence
on the transport endpoint referenced by fd.
TPROTO-
A communication problem has been detected with the transport provider
and there is no other value of t_errno to describe
the error condition.
References
intro(3xti),
t_getinfo(3xti),
t_open(3xti),
t_rcvrel(3xti)
© 2004 The SCO Group, Inc. All rights reserved.
UnixWare 7 Release 7.1.4 - 25 April 2004