Name
t_getstate - get the current state
Syntax
#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 has occurred during
execution of this function.
See Also
t_open(NSL).
Network Programmer's Guide.
Diagnostics
The t_getstate function 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 will fail.
Standards Conformance
t_getstate is conformant with:
AT&T SVID Issue 2, Select Code 307-127.
(printed 6/18/89)