t_getstate(3)t_getstate(3)NAMEt_getstate - Get the current state of the transport provider
SYNOPSIS
#include <xti.h>
int t_getstate(
int fd );
LIBRARY
XTI Library (libxti.a)
STANDARDS
Interfaces documented on this reference page conform to industry stan‐
dards as follows:
t_getstate(): XNS4.0, XNS5.0
Refer to the standards(5) reference page for more information about
industry standards and associated tags.
PARAMETERS
The following table summarizes the relevance of input parameter data
before and after the t_getstate() function is called:
─────────────────────────────────────
Parameter Before Call After Call
─────────────────────────────────────
fd y n
─────────────────────────────────────
Notes to Table: This is a meaningful parameter. This is not a meaning‐
ful parameter. Specifies a file descriptor returned by the t_open()
function that identifies the local transport endpoint.
DESCRIPTION
The t_getstate() function is a general utility function used to get the
current state of the transport provider. The transport endpoint, which
is specified by a file descriptor, is regarded as a finite-state
machine that may be in any one of eight states. When the t_getstate()
function is executed, the current state of the transport endpoint is
returned.
NOTES
If the transport provider is undergoing a change in state when t_get‐
info() is called, a failure occurs.
ERRORS
If the t_getstate() function fails, t_errno may be set to one of the
following values: The specified file descriptor does not refer to a
transport endpoint. This error may be returned when the endpoint refer‐
enced by the fd parameter has been previously closed or an erroneous
file descriptor value has been provided. This error indicates that a
communication problem has been detected between XTI and the transport
provider for which there is no other suitable XTI(t_errno). The trans‐
port provider is undergoing a change in state. A system error occurred
during execution of this function.
VALID STATES
The t_getstate() function can be called in all transport provider
states except T_UNINIT.
RETURN VALUE
Upon successful completion, the transport endpoint state is returned.
Otherwise, a value of -1 is returned and t_errno is set to indicate the
error. The current state is one of the following: Address not bound to
transport endpoint. The transport endpoint is inactive. Outgoing con‐
nection pending. Incoming connection pending. Data transfer in
progress. Outgoing orderly release (waiting for an orderly release
indication). Incoming orderly release (waiting to send an orderly
release request).
SEE ALSO
Function: t_open(3).
Standards: standards(5)
Network Programmer's Guide
t_getstate(3)