t_sndrel(3N) UNIX System V(Networking Support Utilities) t_sndrel(3N)
NAME
tsndrel - initiate an orderly release
SYNOPSIS
#include <tiuser.h>
int tsndrel (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 tsndrel, 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 TCOTSORD
on topen or tgetinfo.
If tsndrel 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, terrno may be set to one of the following:
TBADF The specified file descriptor does not refer to a
transport endpoint.
TFLOW ONDELAY or ONONBLOCK 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
topen(3N), trcvrel(3N)
Programmer's Guide: Networking Interfaces
DIAGNOSTICS
tsndrel returns 0 on success and -1 on failure and terrno is set to
indicate the error.
10/89 Page 1