t_getstate()

NAME

t_getstate - get the current state

SYNOPSIS

#include <xti.h>

int t_getstate(
	int fd)

DESCRIPTION

Parameters	Before call	After call
fd	x	/

The t_getstate() function returns the current state of the provider associated with the transport endpoint specified by fd.

VALID STATES

ALL - apart from T_UNINIT

ERRORS

On failure, t_errno is set to one of the following:

[TBADF]: The specified file descriptor does not refer to a transport endpoint.
[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 error (t_errno).
[TSTATECHNG]: The transport provider is undergoing a transient state change.
[TSYSERR]: A system error has occurred during execution of this function.

RETURN VALUE

State is returned upon successful completion. Otherwise, a value of -1 is returned and t_errno is set to indicate an 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 direction orderly release sent.
T_INREL: Incoming direction orderly release received. If the provider is undergoing a state transition when t_getstate() is called, the function will fail.