t_getstate(3N)

NAME
     t_getstate - get the current state

SYNOPSIS
     #ifdef _XOPEN_SOURCE
     #include <xti.h>
     #else
     #include <tiuser.h>
     #endif

     int t_getstate(fd)
     int fd;

DESCRIPTION
     The t_getstate function returns the current state of the provider
     associated with the transport endpoint specified by fd.

     This function resides within both the X/Open compliant libxnet and the
     SVR4 compliant libnsl Network Services libraries.  Network Services
     applications which require X/Open compliance must link-load with -lxnet.
     Network Services applications which require SVR4 compliance must link-
     load with -lnsl.

     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.

SEE ALSO
     t_open(3N)

DIAGNOSTICS
     t_getstate returns the current state on successful completion and -1 on
     failure and t_errno is set to indicate the error.  The current state may
     be 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.