t_sndrel(3N) LIBRARY FUNCTIONS 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 iden-
tifies 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 pro-
vider, 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 end-
point. On failure, terrno may be set to one of the follow-
ing:
[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 exe-
cution of this function.
SEE ALSO
topen(3N), trcvrel(3N).
UNIX System V Network Programmer's Guide.
DIAGNOSTICS
tsndrel returns 0 on success and -1 on failure and terrno
is set to indicate the error.
1