osf1 man page for t_sndrel

t_sndrel(3)						     Library Functions Manual						       t_sndrel(3)

NAME
       t_sndrel - Initiates an endpoint connect orderly release

LIBRARY
       XTI Library (libxti.a)

SYNOPSIS
       #include <xti.h>
       int t_sndrel(
	   int fd) ;

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

       t_sndrel():  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_sndrel() 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 where an orderly release is
	      wanted.

VALID STATES
       The t_sndrel() function can be called only in the T_DATAXFER and T_INREL transport provider states.

DESCRIPTION
       The t_sndrel()  XTI function is used in connection-oriented mode to initiate an orderly release at a transport endpoint specified by a file
       descriptor previously returned by the t_open() function.

       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, a transport user may continue to  receive  data  over  the
       connection until an orderly release indication is received.

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

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

ERRORS
       If the t_sndrel(|) 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.

       [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 attention.

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

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

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

       [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_rcvrel(3) delim off

																       t_sndrel(3)