Name

t_rcvrel − acknowledge receipt of an orderly release indication

Syntax

#include <xti.h>
int t_rcvrel(fd)
int fd;

Arguments

fd
Identifies the local transport endpoint.

Description

This function is used to acknowledge receipt of an orderly release indication. After receipt of this indication, the user cannot attempt to receive more data, because such an attempt will block forever.  However, the user can 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().

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. 

Diagnostics

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

[TBADF] The specified file descriptor does not refer to a transport endpoint. 

[TOUTSTATE] The function was issued in the wrong sequence on the transport endpoint referenced by fd. 

[TNOREL] No orderly release indication currently exists on the specified transport endpoint. 

[TLOOK] An asynchronous event has occurred on the transport endpoint and requires immediate attention. 

[TNOTSUPPORT] This function is not supported by the underlying transport provider. 

[TSYSERR] A system error has occurred during execution of this function. 

See Also

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