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)
30 January 1998
© 1998 The Santa Cruz Operation, Inc. All rights reserved.