t_getstate(3xti)


t_getstate -- get the current state

Synopsis

cc [options] file -lnsl
#include <xti.h>

int t_getstate(int fd);

Description

This function is an TLI/XTI local management routine used to return the current state of the provider associated with the transport endpoint specified by fd.

TLI/XTI states are changed by user events that reflect the success or failure of calls to the various TLI/XTI functions. Because fewer TLI/XTI user events occur over connectionless services, there are fewer TLI/XTI states than for connection-mode services.

The current state may be one of the following:


T_UNBND
unbound

T_IDLE
idle

T_OUTCON
outgoing connection pending (connection mode only)

T_INCON
incoming connection pending (connection mode only)

T_DATAXFER
data transfer (connection mode only)

T_OUTREL
outgoing orderly release (waiting for an orderly release indication) (connection mode only)

T_INREL
incoming orderly release (waiting for an orderly release request) (connection mode only)

Parameters


fd
the file descriptor for the transport endpoint associated with the current state.

State transitions

t_getstate may be issued from any valid state except T_UNINIT and has no effect on the state.

Files


/usr/lib/libxti.so
X/Open® Transport Interface Library (shared object)

/usr/lib/libnsl.so
Network Services Library (shared object)

Usage

The t_getstate function is applicable to both connection-mode and connectionless transport services.

Return values

t_getstate returns the current state on successful completion and -1 on failure and t_errno is set to indicate the error.

Errors

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.

TPROTO
A communication problem has been detected with the transport provider and there is no other value of t_errno to describe the error condition.

Warnings

If the provider is undergoing a state transition when t_getstate is called, the function will fail.

References

t_getinfo(3xti), t_open(3xti)
© 2004 The SCO Group, Inc. All rights reserved.
UnixWare 7 Release 7.1.4 - 25 April 2004