t_rcvrel(3N)							  t_rcvrel(3N)

NAME    [Toc]    [Back]

     t_rcvrel -	acknowledge receipt of an orderly release indication

SYNOPSIS    [Toc]    [Back]

     #ifdef _XOPEN_SOURCE
     #include <xti.h>
     #else
     #include <tiuser.h>
     #endif

     t_rcvrel (int fd);

DESCRIPTION    [Toc]    [Back]

     This function is used to acknowledge receipt of an	orderly	release
     indication.  fd 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
     t_sndrel has not been issued by the user.

     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.

     This function resides within both the X/Open compliant libxnet and	the
     SVR4 compliant libnsl Network Services libraries.	Network	Services
     applications which	require	X/Open compliance must link-load with -lxnet.
     Network Services applications which require SVR4 compliance must linkload
 with -lnsl.

     On	failure, t_errno may be	set to one of the following:

     TBADF		 The specified file descriptor does not	refer to a
			 transport endpoint.

     TNOREL		 No orderly release indication currently exists	on the
			 specified transport endpoint.

     TLOOK		 An asynchronous event has occurred on this transport
			 endpoint and requires immediate attention.

     TNOTSUPPORT	 This function is not supported	by the underlying
			 transport provider.

     TOUTSTATE		 If _XOPEN_SOURCE is defined and t_rcvrel() is issued
			 in the	wrong sequence on the transport	endpoint
			 referenced by fd, the TOUTSTATE error value is
			 returned within the variable t_errno.

     TSYSERR		 A system error	has occurred during execution of this
			 function.




									Page 1






t_rcvrel(3N)							  t_rcvrel(3N)

SEE ALSO    [Toc]    [Back]

     t_open(3N), t_sndrel(3N)

DIAGNOSTICS    [Toc]    [Back]

     t_rcvrel returns 0	on success and -1 on failure t_errno is	set to
     indicate the error.


									PPPPaaaaggggeeee 2222