NAME

t_rcvrel - acknowledge receipt of an orderly release indication

SYNOPSIS

#include <xti.h>

int t_rcvrel(int fd);

DESCRIPTION

Parameters	Before call	After call
fd	x	/

This function is used to receive an orderly release indication for the incoming direction of data transfer. 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 via t_rcv() or t_rcvv(). 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() 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() or t_getinfo(). Any user data that may be associated with the orderly release indication is discarded when t_rcvrel() 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.

SEE ALSO

t_getinfo(), t_open(), t_sndrel().

CHANGE HISTORY

Issue 4

The SYNOPSIS section is placed in the form of a standard C function prototype.