t_getstate(3xti) t_getstate(3xti)
Name
t_getstate - get the current state
Syntax
#include <xti.h>
int t_getstate(fd)
int fd;
Arguments
fd Identifies the local transport endpoint the current state is returned from.
Description
The function returns the current state of the transport provider associated with the transport endpoint specified by fd.
--------------------------------------
Parameters Before Call After Call
--------------------------------------
fd x /
--------------------------------------
Return Values
Upon successful completion, returns the current state. On failure, 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 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 to send an orderly release request)
If the provider is undergoing a state transition when is called, the function fails.
Diagnostics
On failure, t_errno is set to one of the following:
[TBADF] The specified file descriptor does not refer to a transport endpoint. This error may be returned when the fd has been
previously closed or an erroneous number has been passed to the call.
[TSTATECHNG] The transport provider is undergoing a transient state change.
[TNOTSUPPORT] This function is not supported by the current implementation of XTI.
[TSYSERR] A system error has occurred during execution of this function.
See Also
t_open(3xti)
t_getstate(3xti)
