t_getstate(3)                                             t_getstate(3)

  t_getstate()

  NAME

    t_getstate - get the current state

  SYNOPSIS

    #include 

    int t_getstate(
        int fd)

  DESCRIPTION

    Parameters     Before call     After call

    fd             x               /

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

  VALID STATES

    ALL - apart from T_UNINIT

  ERRORS

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

    [TSTATECHNG]
        The transport provider is undergoing a transient state change.

    [TSYSERR]
        A system error has occurred during execution of this function.

  RETURN VALUE

    State is returned upon successful completion. Otherwise, a value of -1 is
    returned and t_errno is set to indicate an error. The current state is 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 direction orderly release sent.

    T_INREL
        Incoming direction orderly release received. If the provider is
        undergoing a state transition when t_getstate() is called, the
        function will fail.

  SEE ALSO

    t_open(3)

  USAGE NOTES

    The t_getstate function is not thread safe.

    The t_getstate function is not async-signal safe.