t_rcvrel()

NAME

t_rcvrel - acknowledge receipt of an orderly release indication

SYNOPSIS

#include <xti.h>

int t_rcvrel(
	int fd)

DESCRIPTION

This function is used to receive an orderly release indication for the incoming direction of data transfer.

Parameters	Before call	After call
fd	x	/

The argument fd identifies the local transport endpoint where the connection exists. After receipt of this indication, the user may not attempt to receive more data through t_rcv(3) or t_rcvv(3). Such an attempt will fail with t_error set to [TOUTSTATE]. However, the user may continue to send data over the connection if t_sndrel(3) has not been called 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(3) or t_getinfo(3). Any user data that may be associated with the orderly release indication is discarded when t_rcvrel(3) is called.

VALID STATES

T_DATAXFER,T_OUTREL

ERRORS

On failure, t_errno is set to one of the following:

[TBADF]: The specified file descriptor does not refer to a transport endpoint.
[TLOOK]: An asynchronous event has occurred on this transport endpoint and requires immediate attention.
[TNOREL]: No orderly release indication currently exists on the specified transport endpoint.
[TNOTSUPPORT]: This function is not supported by the underlying transport provider.
[TOUTSTATE]: The communications endpoint referenced by fd is not in one of the states in which a call to this function is valid.
[TPROTO]: This error indicates that a communication problem has been detected between XTI and the transport provider for which there is no other suitable XTI error (t_errno).
[TSYSERR]: A system error has occurred during execution of this function.

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 an error.