Previous section.

Technical Standard: Networking Services (XNS), Issue 5.2 Draft 2.0
Copyright © 1999 The Open Group

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.

Contents Next section Index