T_GETSTATE(3N)                       SysV                       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.

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.

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.

SEE ALSO
     t_open(3N)
     Programming with the SysV Transport Interface