t_getstate man page on OpenIndiana

Man page or keyword search:  
man Server   20441 pages
apropos Keyword Search (all sections)
Output format
OpenIndiana logo
[printable version]

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	trans‐
		     port 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 differ‐
       ent 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.11			  7 May 1998		      t_getstate(3NSL)
[top]

List of man pages available for OpenIndiana

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net