NAME    [Toc]    [Back]

       t_getstate  -  Get  the  current  state  of  the transport
       provider

SYNOPSIS    [Toc]    [Back]

       #include <xti.h>

       int t_getstate(
               int fd );

LIBRARY    [Toc]    [Back]

       XTI Library (libxti.a)

STANDARDS    [Toc]    [Back]

       Interfaces documented on this reference  page  conform  to
       industry standards as follows:

       t_getstate():  XNS4.0, XNS5.0

       Refer to the standards(5) reference page for more information
 about industry standards and associated tags.

PARAMETERS    [Toc]    [Back]

       The following table  summarizes  the  relevance  of  input
       parameter  data before and after the t_getstate() function
       is called:

       -------------------------------------
       Parameter   Before Call   After Call
       -------------------------------------
       fd          y             n
       -------------------------------------

       Notes to Table: This is a meaningful parameter.   This  is
       not  a  meaningful parameter.  Specifies a file descriptor
       returned by the  t_open()  function  that  identifies  the
       local transport endpoint.

DESCRIPTION    [Toc]    [Back]

       The  t_getstate()  function  is a general utility function
       used to get the current state of the  transport  provider.
       The  transport  endpoint,  which  is  specified  by a file
       descriptor, is regarded as a finite-state machine that may
       be in any one of eight states. When the t_getstate() function
 is executed, the current state of the transport  endpoint
 is returned.

NOTES    [Toc]    [Back]

       If  the transport provider is undergoing a change in state
       when t_getinfo() is called, a failure occurs.

ERRORS    [Toc]    [Back]

       If the t_getstate() function fails, t_errno may be set  to
       one of the following values: The specified file descriptor
       does not refer to a transport endpoint. This error may  be
       returned  when the endpoint referenced by the fd parameter
       has been previously closed or an erroneous file descriptor
       value has been provided.  This error indicates that a communication
 problem has been detected between XTI  and  the
       transport  provider  for  which there is no other suitable
       XTI(t_errno).  The  transport  provider  is  undergoing  a
       change in state.  A system error occurred during execution
       of this function.

VALID STATES    [Toc]    [Back]

       The t_getstate() function can be called in  all  transport
       provider states except T_UNINIT.

RETURN VALUE    [Toc]    [Back]

       Upon  successful  completion, the transport endpoint state
       is returned.  Otherwise, a value of  -1  is  returned  and
       t_errno is set to indicate the error. The current state is
       one of the following: Address not bound to transport  endpoint.
  The transport endpoint is inactive.  Outgoing connection
  pending.   Incoming  connection  pending.    Data
       transfer  in  progress.  Outgoing orderly release (waiting
       for an  orderly  release  indication).   Incoming  orderly
       release (waiting to send an orderly release request).

SEE ALSO    [Toc]    [Back]

       Function: t_open(3).

       Standards: standards(5)

       Network Programmer's Guide



                                                    t_getstate(3)