t_rcvrel(3xti)
t_rcvrel --
acknowledge receipt of an orderly release indication
Synopsis
cc [options] file -lnsl
#include <xti.h>
int t_rcvrel(int fd);
Description
This function is a TLI/XTI connection release routine
used to acknowledge receipt of an orderly release indication.
In t_rcvrel, fd
identifies the local transport endpoint where the connection exists.
After receipt of this indication, the user should not attempt to
receive more data because such an attempt will block forever.
However, the user may continue to send data over the connection if
t_sndrel has not been issued by the user.
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
fd-
the file descriptor for the transport endpoint where the connect
indication is received.
State transitions
T_DATAXFER on entry and T_INREL on exit;
or T_OUTREL 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)
Return values
t_rcvrel returns 0 on success and -1 on failure
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.
TNOREL-
No orderly release indication currently exists on the specified
transport endpoint.
TLOOK-
An asynchronous event has occurred on the transport endpoint
specified 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.
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
t_open(3xti),
t_sndrel(3xti)
© 2004 The SCO Group, Inc. All rights reserved.
UnixWare 7 Release 7.1.4 - 25 April 2004