t_sndrel(3N) (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.
7/91 Page 1