t_rcvrel(3N)t_rcvrel(3N)NAMEt_rcvrel - acknowledge receipt of an orderly release indication
SYNOPSIS
#ifdef _XOPEN_SOURCE
#include <xti.h>
#else
#include <tiuser.h>
#endif
t_rcvrel (int fd);
DESCRIPTION
This function is used to acknowledge receipt of an orderly release
indication. 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.
This function resides within both the X/Open compliant libxnet and the
SVR4 compliant libnsl Network Services libraries. Network Services
applications which require X/Open compliance must link-load with -lxnet.
Network Services applications which require SVR4 compliance must link-
load with -lnsl.
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 this transport
endpoint and requires immediate attention.
TNOTSUPPORT This function is not supported by the underlying
transport provider.
TOUTSTATE If _XOPEN_SOURCE is defined and t_rcvrel() is issued
in the wrong sequence on the transport endpoint
referenced by fd, the TOUTSTATE error value is
returned within the variable t_errno.
TSYSERR A system error has occurred during execution of this
function.
Page 1
t_rcvrel(3N)t_rcvrel(3N)SEE ALSOt_open(3N), t_sndrel(3N)DIAGNOSTICSt_rcvrel returns 0 on success and -1 on failure t_errno is set to
indicate the error.
Page 2
