t_getstate(3N) — Reliant

t_getstate(3N)                                               t_getstate(3N)

NAME
     tgetstate - get the current state

SYNOPSIS
     #include <sys/tiuser.h>

     int tgetstate(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 execution of this
                     function.

DIAGNOSTICS
     tgetstate returns the current state on successful completion 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 orderly
                     release indication)

     TINREL         incoming orderly release (waiting for an orderly
                     release request)

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

SEE ALSO
     topen(3N).







Page 1                       Reliant UNIX 5.44                Printed 11/98
Museum
