Networking Services Library Functions            tgetstate(3NSL)



NAME
     tgetstate - get the current state

SYNOPSIS
     #include 



     int tgetstate(int fd);


DESCRIPTION
     This routine is part of the  XTI  interfaces  which  evolved
     from the TLI interfaces. XTI represents the future evolution
     of these interfaces. However, TLI interfaces  are  supported
     for  compatibility.  When  using  a TLI routine that has the
     same name as an XTI routine, the  tiuser.h header file  must
     be  used.   Refer  to  the   TLI COMPATIBILITY section for a
     description of differences between the two interfaces.


     The tgetstate() function returns the current state  of  the
     provider associated with the transport endpoint specified by
     fd.

RETURN VALUES
     State is returned upon successful completion.  Otherwise,  a
     value  of   -1 is returned and terrno is set to indicate an
     error.  The current state is one of the following:

     TUNBND        Unbound.


     TIDLE         Idle.


     TOUTCON       Outgoing connection pending.


     TINCON        Incoming connection pending.


     TDATAXFER     Data transfer.


     TOUTREL       Outgoing direction orderly release sent.


     TINREL        Incoming direction orderly release received.






SunOS 5.11           Last change: 7 May 1998                    1






Networking Services Library Functions            tgetstate(3NSL)



     If the  provider  is  undergoing  a  state  transition  when
     tgetstate() is called, the function will fail.

ERORS
     On failure, terrno is set to one of the following:

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


     TPROTO        This  error  indicates  that  a  communication
                   problem  has been detected between XTI and the
                   transport provider for which there is no other
                   suitable XTI error (terrno).


     TSTATECHNG    The transport provider is undergoing  a  tran-
                   sient state change.


     TSYSER       A system error has occurred  during  execution
                   of this function.


TLI COMPATIBILITY
     The XTI and TLI interface definitions have common names  but
     use different header files. This, and other semantic differ-
     ences between the two interfaces are described in  the  sub-
     sections below.

  Interface Header
     The XTI interfaces use the header file,  xti.h.  TLI  inter-
     faces  should  not  use  this  header.   They should use the
     header:

       #include 


  Error Description Values
     The terrno value that can be set by the XTI  interface  and
     cannot be set by the TLI interface is:


     TPROTO

ATRIBUTES
     See attributes(5)  for descriptions of the following  attri-
     butes:







SunOS 5.11           Last change: 7 May 1998                    2






Networking Services Library Functions            tgetstate(3NSL)



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     MT Level                     Safe                        
    


SEE ALSO
     topen(3NSL), attributes(5)














































SunOS 5.11           Last change: 7 May 1998                    3