[ Bottom of Page | Previous Page | Next Page | Contents | Index | Library Home |
Legal |
Search ]
Technical Reference: Communications, Volume 2
t_sndrel Subroutine for X/Open Transport Interface
Purpose
Initiate an orderly release.
Library
X/Open Transport Interface Library (libxti.a)
Syntax
#include <xti.h>
int t_sndrel (fd)
int fd;
Description
The t_sndrel subroutine is used
to initiate an orderly release of a transport connection and indicates to
the transport provider that the transport user has no more data to send.
After calling the t_sndrel subroutine,
the user may not send any more data over the connection. However, a user may
continue to receive data if an orderly release indication has not been received.
This subroutine is an optional service of the transport provider and is only
supported if the transport provider returned service type T_COTS_ORD on the t_open or t_getinfo subroutines.
Parameter
fd |
Identifies the local transport endpoint where the connection exists. |
Valid States
T_DATAXFER, T_INREL.
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:
Value |
Description |
TBADF |
The specified file descriptor does not refer to a transport endpoint. |
TFLOW |
O_NONBLOCK was set, but the flow control mechanism
prevented the transport provider from accepting the subroutine at this time. |
TLOOK |
An asynchronous event has occurred on this transport endpoint and
requires immediate attention. |
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 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_rcvrel subroutine.
[ Top of Page | Previous Page | Next Page | Contents | Index | Library Home |
Legal |
Search ]