t_rcvrel(3)t_rcvrel(3)NAMEt_rcvrel - Acknowledge receipt of an orderly release indication
SYNOPSIS
#include <xti.h>
int t_rcvrel(
int fd );
LIBRARY
XTI Library (libxti.a)
STANDARDS
Interfaces documented on this reference page conform to industry stan‐
dards as follows:
t_rcvrel(): XNS4.0, XNS5.0
Refer to the standards(5) reference page for more information about
industry standards and associated tags.
PARAMETERS
The following table summarizes the relevance of input parameter data
before and after t_rcvrel() is called:
─────────────────────────────────────
Parameter Before Call After Call
─────────────────────────────────────
fd y n
─────────────────────────────────────
Notes to Table: This is a meaningful parameter. This is not a meaning‐
ful parameter. Specifies a file descriptor returned by the t_open()
function that identifies a local transport endpoint that has been
released.
DESCRIPTION
The t_rcvrel() XTI 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 a file descriptor pre‐
viously returned by the t_open() function.
After receipt of this orderly release indication, at the transport end‐
point specified by the file descriptor, a 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 continu‐
ously. However, a transport user may continue to send data across the
connection until a release is sent by a transport user who invokes a
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).
ERRORS
If the t_rcvrel() function fails, t_errno may be set to one of the fol‐
lowing values: File descriptor fd does not refer to a valid transport
endpoint. No orderly release indication currently exists at the trans‐
port endpoint specified by the fd parameter. An asynchronous event has
occurred on the transport endpoint specified by the fd parameter and
requires immediate attention. A system error occurred during execution
of this function. The t_rcvrel() function was issued in the wrong
sequence at the transport endpoint referenced by the fd parameter.
This function is not supported by the underlying transport provider.
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).
VALID STATES
The t_rcvrel() function can be called only in the T_DATAXFER and T_OUT‐
REL transport provider states.
RETURN VALUE
Upon successful completion, a value of 0 (zero) is returned. Otherwise,
a value of -1 is returned and t_errno is set to indicate the error.
SEE ALSO
Functions: t_getinfo(3), t_open(3), t_sndrel(3)
Standards: standards(5)
Network Programmer's Guide
t_rcvrel(3)