*** UNIX MANUAL PAGE BROWSER ***

t_getstate(3) Library Functions Manual t_getstate(3) NAME t_getstate - Gets the current state of the transport provider LIBRARY XTI Library (libxti.a) SYNOPSIS #include <xti.h> int t_getstate( int fd) ; STANDARDS Interfaces documented on this reference page conform to industry stan- dards as follows: t_getstate: XPG4-UNIX Refer to the standards(5) reference page for more information about in- dustry standards and associated tags. PARAMETERS The following table summarizes the relevance of input parameter data before and after the t_getstate() function is called: center, tab (@); lb lb lb c c c. 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 the local transport endpoint. VALID STATES The t_getstate() function can be called in all transport provider states except T_UNINIT. DESCRIPTION The t_getstate() function is a general utility function used to get the current state of the transport provider. The transport endpoint, which is specified by a file descriptor, is regarded as a finite-state ma- chine that may be in any one of eight states. When the t_getstate() function is executed, the current state of the transport endpoint is returned. NOTES If the transport provider is undergoing a change in state when t_get- info() is called, a failure occurs. RETURN VALUE Upon successful completion, the transport endpoint state is returned. Otherwise, a value of -1 is returned and t_errno is set to indicate the error. The current state is one of the following: [T_UNBND] Address not bound to transport endpoint. [T_IDLE] The transport endpoint is inactive. [T_OUTCON] Outgoing connection pending. [T_INCON] Incoming connection pending. [T_DATAXFER] Data transfer in progress. [T_OUTREL] Outgoing orderly release (waiting for an orderly release in- dication). [T_INREL] Incoming orderly release (waiting to send an orderly release request). ERRORS If the t_getstate() function fails, t_errno may be set to one of the following values: [TBADF] The specified file descriptor does not refer to a transport endpoint. This error may be returned when the endpoint ref- erenced by the fd parameter has been previously closed or an erroneous file descriptor value has been provided. [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). [TSTATECHNG] The transport provider is undergoing a change in state. [TSYSERR] A system error occurred during execution of this function. RELATED INFORMATION Function: t_open(3). delim off t_getstate(3)