T_GETSTATE(3N-SVR4) RISC/os Reference Manual  T_GETSTATE(3N-SVR4)



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).

DIAGNOSTICS
     t_getstate returns the current state on successful comple-
     tion 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.



                        Printed 11/19/92                   Page 1