t_getstate(3)                       CLIX                       t_getstate(3)



  NAME

    t_getstate - Gets the current state

  LIBRARY

    The Transport Layer Interface (TLI) Library (libnsl_s.a)

  SYNOPSIS

    #include <tiuser.h>

    int t_getstate(
      int fd );

  PARAMETERS

    fd   An integer representing a file descriptor

  DESCRIPTION

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

  RETURN VALUES

    The t_getstate() returns the current state on successful completion
     and -1 on failure and t_errno is set to indicate the error.  The current
    state may be one of the following:

    T_UNBND      Unbound

    T_IDLE       Idle

    T_OUTCON     Outgoing connection pending

    T_INCON      Incoming connection pending

    T_DATAXFER   Data transfer

    T_OUTREL     Outgoing orderly release (waiting for an orderly release
                 indication)

    T_INREL      Incoming orderly release (waiting for an orderly release
                 request)

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

  ERRORS




  2/94 - Intergraph Corporation                                              1

  t_getstate(3)                       CLIX                       t_getstate(3)



    On failure, t_errno 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.

  RELATED INFORMATION

    Functions: t_open(3)

    AT&T UNIX System V Network Programmer's Guide







































  2                                              Intergraph Corporation - 2/94