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.

SEE ALSO

t_open().

CHANGE HISTORY

Issue 4

The SYNOPSIS section is placed in the form of a standard C function prototype.