T_GETSTATE(3N)       INTERACTIVE UNIX System       T_GETSTATE(3N)



          NAME
               t_getstate - get the current state

          SYNOPSIS
               #include <tiuser.h>

               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.

               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 execu-
                                 tion of this function.

          SEE ALSO
               t_open(3N).
               Programmer's Guide.

          DIAGNOSTICS
               The t_getstate function returns the current state on suc-
               cessful 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 ord-
                              erly release indication)

               T_INREL        incoming orderly release (waiting for an ord-
                              erly release request)

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


          Rev. Networking Support Utilities                          Page 1