t_getstate(3n) — NEWS-os 5.0.1



t_getstate(3N)          LIBRARY FUNCTIONS          t_getstate(3N)



NAME
     tgetstate - get the current state

SYNOPSIS
     #include <tiuser.h>

     int tgetstate(fd)
     int fd;

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

     On failure, terrno 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
     topen(3N).
     UNIX System V Network Programmer's Guide.

DIAGNOSTICS
     tgetstate returns the current state on  successful  comple-
     tion  and  -1  on failure and terrno is set to indicate the
     error.  The current state may be one of the following:

     TUNBND        unbound

     TIDLE         idle

     TOUTCON       outgoing connection pending

     TINCON        incoming connection pending

     TDATAXFER     data transfer

     TOUTREL       outgoing orderly release (waiting for an ord-
                    erly release indication)

     TINREL        incoming orderly release (waiting for an ord-
                    erly release request)

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



                                                                1
Museum
