NAME [Toc] [Back]
t_rcvrel() - acknowledge receipt of an orderly release indication at a
SYNOPSIS [Toc] [Back]
#include <xti.h> /* for X/OPEN Transport Interface - XTI */
/* or */
#include <tiuser.h> /* for Transport Layer Interface - TLI */
int t_rcvrel (fd);
DESCRIPTION [Toc] [Back]
The t_rcvrel() function is used in connection-oriented mode to
acknowledge receipt of an orderly release indication at a transport
endpoint. The released endpoint is specified by fd, which is a file
descriptor previously returned by the t_open() function.
After receipt of this orderly release indication at the transport
endpoint specified by fd, the transport user should not try to receive
additional data from that transport endpoint. Any attempt to receive
more data from a released transport endpoint blocks continuously.
However, the transport user may continue to send data across the
connection until a release is sent by the transport user by invoking
the t_sndrel() function call.
The t_rcvrel() function should not be used unless the servtype typeof-service
returned by the t_open() or t_getinfo() functions is
T_COTS_ORD (supports connection-mode service with the optional orderly
Thread-Safeness [Toc] [Back]
The t_rcvrel() 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.
Valid States [Toc] [Back]
Note [Toc] [Back]
HP OSI XTI does not support t_rcvrel().
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:
Hewlett-Packard Company - 1 - HP-UX 11i Version 2: August 2003
[TBADF] The specified identifier does not refer to a
[TNOREL] No orderly release indication currently exists on
the specified transport endpoint.
[TBUFOVFLW] The number of bytes allocated for incoming data is
not sufficient to store the data.
[TNOTSUPPORT] This function is not supported by the underlying
[TLOOK] An asynchronous event has occurred on the
transport endpoint referenced by fd and requires
[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).
[TOUTSTATE] (XTI only) The function was issued in the wrong
sequence on the transport endpoint referenced by
SEE ALSO [Toc] [Back]
t_getinfo(3), t_open(3), t_sndrel(3).
STANDARDS CONFORMANCE [Toc] [Back]
t_rcvrel(): SVID2, XPG3, XPG4
Hewlett-Packard Company - 2 - HP-UX 11i Version 2: August 2003 [ Back ]