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 t_getstate() function returns the current state of the transport provider associated with the transport endpoint specified by fd. 

Return Value

Upon successful completion, t_getstate() 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 t_getstate() 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()