unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (SunOS-4.1.3)
Page:
Section:
Apropos / Subsearch:
optional field

T_GETSTATE(3N)                                                  T_GETSTATE(3N)



NAME
       t_getstate - get the current state

SYNOPSIS
       #include <&lt;tiuser.h>&gt;

       int t_getstate(fd)
       int fd;

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

       If the provider is undergoing a state transition when  t_getstate()  is
       called, the function will fail.  t_getstate() returns the current state
       on successful completion and -1 on failure and t_errno is set to  indi-
       cate 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)

RETURN VALUES
       t_getstate() returns:

       0      on success.

       -1     on failure and sets t_errno to indicate the error.

ERRORS
       TBADF               The  specified  file descriptor does not refer to a
                           transport endpoint.

       TSTATECHNG          The  transport  provider  is  undergoing  a   state
                           change.

       TSYSERR             The  function  failed due to a system error and set
                           errno to indicate the error.

SEE ALSO
       t_open(3N)

                                21 January 1990                 T_GETSTATE(3N)