NAME [Toc] [Back]
t_sndrel() - initiate an orderly release
SYNOPSIS [Toc] [Back]
#include <xti.h> /* for X/OPEN Transport Interface - XTI */
/* or */
#include <tiuser.h> /* for Transport Layer Interface - TLI */
int t_sndrel (fd);
DESCRIPTION [Toc] [Back]
The t_sndrel() function is used in connection-oriented mode to
initiate an orderly release at a transport endpoint specified by fd,
which is a file descriptor previously returned by the t_open()
After this orderly release is indicated, the transport user should not
try to send more data through that transport endpoint. An attempt to
send more data to a released transport endpoint may block
continuously. However, the transport user may continue to receive
data over the connection until an orderly release indication is
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().
Thread-Safeness [Toc] [Back]
The t_sndrel() function is safe to be called by multithreaded
applications, and it is thread-safe for both POSIX Threads and DCE
User Threads. It has a cancellation point. It is neither asynccancel
safe nor async-signal safe. Finally, it is not fork-safe.
Note [Toc] [Back]
HP OSI XTI does not support t_sndrel().
RETURN VALUE [Toc] [Back]
Upon successful completion, a value of 0 is returned. Otherwise, a
value of -1 is returned and t_errno is set to indicate the error.
ERRORS [Toc] [Back]
On failure, t_errno is set to one of the following:
[TBADF] The specified identifier does not refer to a
[TFLOW] Asynchronous mode is indicated because O_NONBLOCK
was set, but the transport provider cannot accept
a release because of flow-control restrictions.
[TLOOK] An asynchronous event has occurred on this
transport endpoint and requires immediate
Hewlett-Packard Company - 1 - HP-UX 11i Version 2: August 2003
[TNOTSUPPORT] This function is not supported by the underlying
[TSYSERR] A system error has occurred during execution of
[TPROTO] (XTI only) This error indicates that a
communication problem has been detected between
XTI and the transport provider for which there is
no other suitable XTI (t_errno).
SEE ALSO [Toc] [Back]
t_getinfo(3), t_open(3), t_rcvrel(3).
STANDARDS CONFORMANCE [Toc] [Back]
t_sndrel(): SVID2, XPG3, XPG4
Hewlett-Packard Company - 2 - HP-UX 11i Version 2: August 2003 [ Back ]