Previous section.

Technical Standard: Networking Services (XNS), Issue 5.2 Draft 2.0
Copyright © 1999 The Open Group

NAME

t_sndrel - initiate an orderly release

SYNOPSIS


#include <xti.h>

int t_sndrel(int fd);


DESCRIPTION






Parameters Before call After call

fd x /


For transport providers of type T_COTS_ORD, this function is used to initiate an orderly release of the outgoing direction of data transfer and indicates to the transport provider that the transport user has no more data to send. The argument fd identifies the local transport endpoint where the connection exists. After calling t_sndrel(), 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. For transport providers of types other than T_COTS_ORD, this function fails with error [TNOTSUPPORT].

VALID STATES

T_DATAXFER,T_INREL

ERRORS

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

[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 function at this time.

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

[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_rcvrel().

CHANGE HISTORY

Issue 4

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

Contents Next section Index