[ Previous |
Next |
Contents |
Glossary |
Home |
Search ]
AIX Version 4.3 Communications Technical Reference, Volume 2
t_rcvrel Subroutine for X/Open Transport Interface
Purpose
Acknowledging receipt of an orderly release indication.
Library
X/Open Transport Interface Library (libxti.a)
Syntax
#include <xti.h>
int t_rcvrel (fd)
int fd;
Description
The t_rcvrel subroutine is used to acknowledge receipt of an orderly release indication. After receipt of this indication, the user may 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 the t_sndrel subroutine 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 the T_COTS_ORD service type on t_open or t_getinfo calls.
Parameter
fd |
Identifies the local transport endpoint where the connection exists. |
Valid States
T_DATAXFER, T_OUTREL.
Return Values
0 |
Successful completion. |
-1 |
t_errno is set to indicate an error. |
Error Codes
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 subroutine is not supported by the underlying transport provider. |
TOUTSTATE |
The subroutine was issued in the wrong sequence on the transport endpoint referenced by the fd parameter. |
TPROTO |
This error indicates that a communication problem has been detected between the X/Open Transport Interface and the transport provider for which there is no other suitable X/Open Transport Interface (t_errno). |
TSYSERR |
A system error has occurred during execution of this subroutine. |
Related Information
The t_getinfo subroutine, t_open subroutine, t_sndrel subroutine.
[ Previous |
Next |
Contents |
Glossary |
Home |
Search ]