t_getstate(3N) UNIX System V(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)
If the provider is undergoing a state transition when tgetstate is
called, the function will fail.
10/89 Page 1