T_GETSTATE(3N) (Networking Support Utilities) T_GETSTATE(3N)
NAME
t_getstate - get the current state
SYNOPSIS
#include <tiuser.h>
int tgetstate(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 has occurred during
execution of this function.
SEE ALSO
t_open(3N).
Network Programmer's Guide, Vol. 1.
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
Page 1 May 1989
T_GETSTATE(3N) (Networking Support Utilities) T_GETSTATE(3N)
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 will fail.
Page 2 May 1989