NAME
t_rcvrel() — acknowledge receipt of an orderly release indication at a transport endpoint
SYNOPSIS
#include <xti.h> /* for X/OPEN Transport Interface - XTI */
/* or */
#include <tiuser.h> /* for Transport Layer Interface - TLI */
int t_rcvrel (fd);
int fd;
DESCRIPTION
The
t_rcvrel()
function is used in connection-oriented mode to acknowledge
receipt of an orderly release indication at a transport endpoint.
The released endpoint is specified by
fd,
which is a file descriptor previously
returned by the
t_open()
function.
After receipt of this orderly release indication at the transport
endpoint specified by
fd,
the transport user should not try to receive additional
data from that transport endpoint. Any attempt to receive more data
from a released transport endpoint blocks continuously. However,
the transport user
may continue to send data across the connection until a release is
sent by the transport user by invoking the
t_sndrel()
function call.
The
t_rcvrel()
function should not be used unless the
servtype
type-of-service returned by the
t_open()
or
t_getinfo()
functions
is
T_COTS_ORD
(supports connection-mode service with the optional
orderly release facility).
Valid States
T_DATAXFER,
T_OUTREL
Note
HP OSI XTI does not support
t_rcvrel().
Fork Safety
t_rcvrel
is not fork-safe.
RETURN VALUE
Upon successful completion, a value of 0 is returned. Otherwise, a value of
-1 is returned and
t_errno
is set to indicate the error.
ERRORS
On failure,
t_errno
is set to one of the following:
- [TBADF]
The specified identifier does not refer to a transport endpoint.
- [TNOREL]
No orderly release indication currently exists on the specified
transport endpoint.
- [TBUFOVFLW]
The number of bytes allocated for incoming data is not
sufficient to store the data.
- [TNOTSUPPORT]
This function is not supported by the underlying transport provider.
- [TLOOK]
An asynchronous event has occurred on the transport endpoint referenced by
fd
and requires immediate attention.
- [TSYSERR]
A system error has occurred during execution of this function.
- [TPROTO]
(XTI only) This error indicates that a communication problem has been
detected between XTI and the transport provider for which there is no
other suitable XTI (
t_errno).
- [TOUTSTATE]
(XTI only) The function was issued in the wrong sequence on the transport
endpoint referenced by
fd.
STANDARDS CONFORMANCE
t_rcvrel(): SVID2, XPG3, XPG4