t_getstate(3) [hpux man page]

t_getstate(3)						     Library Functions Manual						     t_getstate(3)

NAME

       t_getstate() - get the current state

SYNOPSIS

DESCRIPTION

       The function returns the current state of the provider as seen by the application associated with the transport endpoint specified by fd.

   Fork Safety
       is not fork-safe.

RETURN VALUE

       State is returned upon successful completion.  Otherwise, a value of -1 it returned and is set to indicate the 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 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 is called, the function will fail.

ERRORS

       On failure, is set to the following:

       [TBADF]		The specified identifier does not refer to a transport endpoint.

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

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

       [TPROTO] 	(XTI only) This error indicates that a communication problem has been detected between XTI and the transport provider  for
			which there is no suitable XTI (

SEE ALSO

       t_open(3), thread_safety(5).

STANDARDS CONFORMANCE

																     t_getstate(3)

t_getstate(3xti)														  t_getstate(3xti)

Name
       t_getstate - get the current state

Syntax
       #include <xti.h>

       int t_getstate(fd)
       int fd;

Arguments
       fd	 Identifies the local transport endpoint the current state is returned from.

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

       --------------------------------------
       Parameters   Before Call   After Call
       --------------------------------------
       fd	    x		  /
       --------------------------------------

Return Values
       Upon  successful  completion,  returns the current state.  On failure, a value of -1 is returned, and t_errno is set to indicate the 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 orderly release (waiting for an orderly release indication)

       T_INREL	      Incoming orderly release (waiting to send an orderly release request)

       If the provider is undergoing a state transition when is called, the function fails.

Diagnostics
       On failure, t_errno is set to one of the following:

       [TBADF]		   The specified file descriptor does not refer to a transport endpoint. This error may be returned when the fd  has  been
			   previously closed or an erroneous number has been passed to the call.

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

       [TNOTSUPPORT]	   This function is not supported by the current implementation of XTI.

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

See Also
       t_open(3xti)

																  t_getstate(3xti)