t_getstate(3N)							t_getstate(3N)

NAME    [Toc]    [Back]

     t_getstate	- get the current state

SYNOPSIS    [Toc]    [Back]

     #ifdef _XOPEN_SOURCE
     #include <xti.h>
     #else
     #include <tiuser.h>
     #endif

     int t_getstate(fd)
     int fd;

DESCRIPTION    [Toc]    [Back]

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

     This function resides within both the X/Open compliant libxnet and	the
     SVR4 compliant libnsl Network Services libraries.	Network	Services
     applications which	require	X/Open compliance must link-load with -lxnet.
     Network Services applications which require SVR4 compliance must linkload
 with -lnsl.

     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.

SEE ALSO    [Toc]    [Back]

     t_open(3N)

DIAGNOSTICS    [Toc]    [Back]

     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





									Page 1






t_getstate(3N)							t_getstate(3N)



     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.


									PPPPaaaaggggeeee 2222