t_getstate(3N) (Networking Support Utilities) t_getstate(3N)
NAME
tgetstate - get the current state
SYNOPSIS
#include <tiuser.h>
int tgetstate(fd)
int fd;
DESCRIPTION
The tgetstate function returns the current state of the provider
associated with the transport endpoint specified by fd.
On failure, terrno 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
topen(3N).
Programmer's Guide: Networking Interfaces.
DIAGNOSTICS
tgetstate returns the current state on successful completion and -1
on failure and terrno is set to indicate the error. The current
state may be one of the following:
TUNBND unbound
TIDLE idle
TOUTCON outgoing connection pending
TINCON incoming connection pending
TDATAXFER data transfer
TOUTREL outgoing orderly release (waiting for an orderly
release indication)
TINREL incoming orderly release (waiting for an orderly
release request)
7/91 Page 1
t_getstate(3N) (Networking Support Utilities) t_getstate(3N)
If the provider is undergoing a state transition when tgetstate is
called, the function will fail.
Page 2 7/91