The Single UNIX ® Specification, Version 2
Copyright © 1997 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().

UNIX ® is a registered Trademark of The Open Group.
Copyright © 1997 The Open Group
[ Main Index | XSH | XCU | XBD | XCURSES | XNS ]