t_getstate(3N) — DG/UX 5.4.2A



t_getstate(3N)                   DG/UX 5.4.2                  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 execution of
                         this function.

SEE ALSO
       topen(3N).
       UNIX System V Network Programmer's Guide.

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.






Licensed material--property of copyright holder(s)                         1
Museum
