t_getstate(3) Library Functions Manual t_getstate(3)
NAME
t_getstate() - get the current state
SYNOPSIS
DESCRIPTION
The function returns the current state of the provider as seen by the application associated with the transport endpoint specified by fd.
Fork Safety
is not fork-safe.
RETURN VALUE
State is returned upon successful completion. Otherwise, a value of -1 it returned and is set to indicate the error. The current state is
one of the following:
T_UNBND unbound
T_IDLE idle
T_OUTCON outgoing connection pending
T_INCON incoming connection pending
T_DATAXFER data transfer
T_OUTREL outgoing orderly release (waiting for an orderly release indication).
T_INREL incoming orderly release (waiting for an orderly release request).
If the provider is undergoing a state transition when is called, the function will fail.
ERRORS
On failure, is set to the following:
[TBADF] The specified identifier does not refer to a transport endpoint.
[TSTATECHNG] The transport provider is undergoing a transient state change.
[TSYSERR] A system error has occurred during execution of this function.
[TPROTO] (XTI only) This error indicates that a communication problem has been detected between XTI and the transport provider for
which there is no suitable XTI (
SEE ALSO
t_open(3), thread_safety(5).
STANDARDS CONFORMANCE
t_getstate(3)
