t_getstate(3) [osf1 man page]

t_getstate(3)						     Library Functions Manual						     t_getstate(3)

NAME

       t_getstate - Gets the current state of the transport provider

LIBRARY

       XTI Library (libxti.a)

SYNOPSIS

       #include <xti.h>

       int t_getstate(
	 int fd) ;

STANDARDS

       Interfaces documented on this reference page conform to industry standards as follows:

       t_getstate():  XNS4.0

       Refer to the standards(5) reference page for more information about industry standards and associated tags.

PARAMETERS

       The following table summarizes the relevance of input parameter data before and after the t_getstate() function is called:

							  Parameter   Before Call   After Call
							  -------------------------------------
							     fd 	   y		n
       Notes to Table:
	      y    This is a meaningful parameter.
	      n    This is not a meaningful parameter.

       fd	 Specifies a file descriptor returned by the t_open() function that identifies the local transport endpoint.

VALID STATES

       The t_getstate() function can be called in all transport provider states except T_UNINIT.

DESCRIPTION

       The  t_getstate()  function  is a general utility function used to get the current state of the transport provider. The transport endpoint,
       which is specified by a file descriptor, is regarded as a finite-state machine that may be in any one of eight  states.	 When  the  t_get-
       state() function is executed, the current state of the transport endpoint is returned.

NOTES

       If the transport provider is undergoing a change in state when t_getinfo() is called, a failure occurs.

RETURN VALUE

       Upon  successful completion, the transport endpoint state is returned.  Otherwise, 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] Address not bound to transport endpoint.

       [T_IDLE]  The transport endpoint is inactive.

       [T_OUTCON]
		 Outgoing connection pending.

       [T_INCON] Incoming connection pending.

       [T_DATAXFER]
		 Data transfer in progress.

       [T_OUTREL]
		 Outgoing orderly release (waiting for an orderly release indication).

       [T_INREL] Incoming orderly release (waiting to send an orderly release request).

ERRORS

       If the t_getstate() function fails, t_errno may be set to one of the following values:

       [TBADF]	 The specified file descriptor does not refer to a transport endpoint.	This error may be returned when the endpoint referenced by
		 the fd parameter has been previously closed or an erroneous file descriptor value has been provided.

       [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(t_errno).

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

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

RELATED INFORMATION

       Function: t_open(3).  delim off

																     t_getstate(3)

Check Out this Related Man Page

t_getstate(3NSL)				       Networking Services Library Functions					  t_getstate(3NSL)

NAME

       t_getstate - get the current state

SYNOPSIS

       #include <xti.h>

       int t_getstate(int fd);

DESCRIPTION

       This  routine is part of the XTI interfaces which evolved from the TLI interfaces. XTI represents the future evolution of these interfaces.
       However, TLI interfaces are supported for compatibility. When using a TLI routine that has the same name as an XTI routine,  the   tiuser.h
       header file must be used.  Refer to the	TLI COMPATIBILITY section for a description of differences between the two interfaces.

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

RETURN VALUES

       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.

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.

TLI COMPATIBILITY

       The  XTI  and  TLI interface definitions have common names but use different header files. This, and other semantic differences between the
       two interfaces are described in the subsections below.

   Interface Header
       The XTI interfaces use the header file, xti.h. TLI interfaces should not use this header.  They should use the header:

       #include <tiuser.h>

   Error Description Values
       The t_errno value that can be set by the XTI interface and cannot be set by the TLI interface is:

       TPROTO

ATTRIBUTES

       See attributes(5)  for descriptions of the following attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |MT Level		     |Safe			   |
       +-----------------------------+-----------------------------+

SEE ALSO

       t_open(3NSL), attributes(5)

SunOS 5.10							    7 May 1998							  t_getstate(3NSL)

Linux and UNIX Man Pages

t_getstate(3) [osf1 man page]

Check Out this Related Man Page