t_getstate.3 (2010 09)

t
t_getstate(3) t_getstate(3)
NAME
t_getstate() - get the current state
SYNOPSIS
#include <xti.h> /* for X/OPEN Transport Interface - XTI */
/* or */
#include <tiuser.h> /* for Transport Layer Interface - TLI */
int t_getstate (fd);
int fd;
DESCRIPTION
The t_getstate() function returns the current state of the provider as seen by the application associ-
ated with the transport endpoint specified by fd.
Fork Safety
t_getstate is not fork-safe.
RETURN VALUE
State is returned upon successful completion. Otherwise, a value of −1 it returned and
t_errno is set to
indicate the error. The current state is 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.
ERRORS
On failure,
t_errno is set to the following:
[TBADF] The specified identifier does not refer to a transport endpoint.
[TSTATECHNG] The transport provider is undergoing a transient state change.
[TSYSERR] A system error has occurred during execution of this function.
[TPROTO] (XTI only) This error indicates that a communication problem has been detected
between XTI and the transport provider for which there is no suitable XTI (
t_errno).
SEE ALSO
t_open(3), thread_safety(5).
STANDARDS CONFORMANCE
t_getstate(): SVID2, XPG3, XPG4
HP-UX 11i Version 3: September 2010 − 1 − Hewlett-Packard Company 1