'\"macro stdmacro
.if n .pH g3n.t_rcvrel @(#)t_rcvrel	40.5 of 10/10/89
.\" Copyright 1989 AT&T
.nr X
.if \nX=0 .ds x} t_rcvrel 3N "Networking Support Utilities" "\&"
.if \nX=1 .ds x} t_rcvrel 3N "Networking Support Utilities"
.if \nX=2 .ds x} t_rcvrel 3N "" "\&"
.if \nX=3 .ds x} t_rcvrel "" "" "\&"
.if \nX=4 .ds x} t_rcvrel "NS_LIB" "EXTENSION" " "
.TH \*(x}
.SH NAME
\f4t_rcvrel\f1 \- acknowledge receipt of an orderly release indication
.SH SYNOPSIS
\f4#include <tiuser.h>\f1
.PP
\f4t_rcvrel (int fd);\f1
.SH DESCRIPTION
This function is used to acknowledge receipt of
an orderly release indication.
\f4fd\fP
identifies the local transport endpoint where the connection exists.
After receipt of this indication, the user should not attempt to
receive more data because such an attempt will block forever.
However, the user may continue to send data over the connection if
\f4t_sndrel\fP
has not been issued by the user.
.PP
This function is an optional service of the transport provider,
and is only supported if the transport provider returned service
type
\f4T_COTS_ORD\fP
on
\f4t_open\fP
or
\f4t_getinfo\fP.
.P
On failure, \f4t_errno\f1 may be set to one of the following:
.TP 20
\f4[TBADF]\fP
The specified file descriptor does not refer to a transport endpoint.
.TP
\f4[TNOREL]\fP
No orderly release indication currently exists on the specified
transport endpoint.
.TP
\f4[TLOOK]\fP
An asynchronous event has occurred on this transport endpoint and requires
immediate attention.
.TP
\f4[TNOTSUPPORT]\fP
This function is not supported by the underlying transport
provider.
.TP
\f4[TSYSERR]\fP
A system error has occurred during execution of this function.
.SH SEE ALSO
\f4t_open\fP(3N), \f4t_sndrel\fP(3N).
.sp .2
\f2UNIX System V Network Programmer's Guide\f1.
.SH DIAGNOSTICS
\f4t_rcvrel\fP
returns 0 on success and \-1 on failure
\f4t_errno\f1 is set to indicate the error.
.Ee
