NAME

t_sndrel - initiate an orderly release

SYNOPSIS

#include <tiuser.h>

int t_sndrel (int fd);

DESCRIPTION

This function 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. fd identifies the local transport endpoint where the connection exists. After issuing 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.

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. If t_sndrel is issued from an invalid state, the provider will generate an EPROTO protocol error; however, this error may not occur until a subsequent reference to the transport endpoint. On failure, t_errno may be set to one of the following:

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

[TFLOW]             O_NDELAY or O_NONBLOCK was set, but  the
                    flow  control  mechanism  prevented  the
                    transport provider  from  accepting  the
                    function at this time.

[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_open(3N), t_rcvrel(3N).
UNIX System V Network Programmer's Guide.

DIAGNOSTICS

t_sndrel returns 0 on success and -1 on failure and t_errno is set to indicate the error.