NAME

t_getstate − get the current state

SYNOPSIS

#include <tiuser.h>

int t_getstate(fd)
int fd;

DESCRIPTION

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

On failure, t_errno may be set to one of the following:

[TBADF] The specified file descriptor does not refer to a transport endpoint. 

[TSTATECHNG] The transport provider is undergoing a state change. 

[TSYSERR] A system error occurred during execution of this function. 

SEE ALSO

t_open(3N)

DIAGNOSTICS

t_getstate returns the current state on successful completion and −1 on failure and t_errno is set to indicate the error.  The current state may be 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 for an orderly release request)

If the provider is undergoing a state transition when t_getstate is called, the function fails. 

September 02, 1992