t_getstate(S) (TLI/XTI) 6 January 1993 t_getstate(S) Name t_getstate - get the current state Syntax TLI syntax cc . . . -lnsls #include <sys/tiuser.h> int t_getstate (fd) int fd; XTI syntax cc . . . -lxti #include <xti.h> int t_getstate (fd) int fd; Description The tgetstate function returns the current state of the provider associ- ated with the transport endpoint specified by fd. On failure, terrno may be set to one of the following: [TBADF] The specified file descriptor does not refer to a transport endpoint. [TSTATECHNG] The transport provider is undergoing a state change. [TSYSERR] A system error has occurred during execution of this function. [TNOTSUPPORT] This function is not supported by the current implemen- tation of XTI. Diagnostics The tgetstate function returns the current state on successful comple- tion and -1 on failure, and terrno is set to indicate the error. The current state may be one of the following: TDATAXFER data transfer TIDLE idle TINCON incoming connection pending TINREL incoming orderly release (waiting for an orderly release request) TOUTCON outgoing connection pending TOUTREL outgoing orderly release (waiting for an orderly release indication) TUNBND unbound If the provider is undergoing a state transition when tgetstate is called, the function fails. See also topen(S) Standards conformance tgetstate is conformant with: AT&T SVID Issue 2; X/Open Portability Guide, Issue 3, 1989; and Intel386 Binary Compatibility Specification, Edition 2 (iBCSe2).