t_rcvrel(3xti) [ultrix man page]

t_rcvrel(3xti)															    t_rcvrel(3xti)

Name
       t_rcvrel - acknowledge receipt of an orderly release indication

Syntax
       #include <xti.h>

       int t_rcvrel(fd)
       int fd;

Arguments
       fd	 Identifies the local transport endpoint.

Description
       This function is used to acknowledge receipt of an orderly release indication. After receipt of this indication, the user cannot attempt to
       receive more data, because such an attempt will block forever.  However, the user can continue to send data over the connection if 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 or

       --------------------------------------
       Parameters   Before Call   After Call
       --------------------------------------
       fd	    x		  /
       --------------------------------------

Return Values
       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.

Diagnostics
       On failure, is set to one of the following:

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

       [TOUTSTATE]	   The function was issued in the wrong sequence on the transport endpoint referenced by fd.

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

       [TLOOK]		   An asynchronous event has occurred on the transport endpoint and requires immediate attention.

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

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

See Also
       t_getinfo(3xti), t_open(3xti), t_sndrel(3xti)

																    t_rcvrel(3xti)

t_rcvrel(3)						     Library Functions Manual						       t_rcvrel(3)

NAME

       t_rcvrel - Acknowledges receipt of an orderly release indication

LIBRARY

       XTI Library (libxti.a)

SYNOPSIS

       #include <xti.h>

       int t_rcvrel(
	 int fd) ;

STANDARDS

       Interfaces documented on this reference page conform to industry standards as follows:

       t_rcvrel():  XNS4.0

       Refer to the standards(5) reference page for more information about industry standards and associated tags.

PARAMETERS

       The following table summarizes the relevance of input parameter data before and after t_rcvrel() is called:

							  Parameter   Before Call   After Call
							  -------------------------------------
							     fd 	   y		n
       Notes to Table:
	      y    This is a meaningful parameter.
	      n    This is not a meaningful parameter.

       fd     Specifies a file descriptor returned by the t_open() function that identifies a local transport endpoint that has been released.

VALID STATES

       The t_rcvrel() function can be called only in the T_DATAXFER and T_OUTREL transport provider states.

DESCRIPTION

       The t_rcvrel() XTI function is used in connection-oriented mode to acknowledge receipt of an orderly release indication at a transport end-
       point. The released endpoint is specified by a file descriptor previously returned by the t_open() function.

       After receipt of this orderly release indication, at the transport endpoint specified by the file descriptor, a 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, a transport user may continue to send data across the connection until a release is sent by a  transport  user  who
       invokes a t_sndrel() function call.

       The  t_rcvrel()	function  should  not  be  used  unless  the servtype type-of-service returned by the t_open() or t_getinfo() functions is
       T_COTS_ORD (supports connection-mode service with the optional orderly release facility).

RETURN VALUE

       Upon successful completion, a value of 0 (zero) is returned. Otherwise, a value of -1 is returned and t_errno is set to indicate the error.

ERRORS

       If the t_rcvrel() function fails, t_errno may be set to one of the following values:

       [TBADF]	 File descriptor fd does not refer to a valid transport endpoint.

       [TNOREL]  No orderly release indication currently exists at the transport endpoint specified by the fd parameter.

       [TLOOK]	 An asynchronous event has occurred on the transport endpoint specified by the fd parameter and requires immediate attention.

       [TSYSERR] A system error occurred during execution of this function.

       [TOUTSTATE]
		 The t_rcvrel() function was issued in the wrong sequence at the transport endpoint referenced by the fd parameter.

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

       [TPROTO]  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).

RELATED INFORMATION

       Functions: t_getinfo(3), t_open(3), t_sndrel(3) delim off

																       t_rcvrel(3)