t_getstate(3xti)t_getstate(3xti)Namet_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 asso‐
ciated 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 Alsot_open(3xti)t_getstate(3xti)