NAME

t_getstate − get the current state

SYNOPSIS

#include <xti.h>     (for XTI)

or

#include <tiuser.h>  (for TLI)

 
int t_getstate (fd)
int fd;

 

DESCRIPTION

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

ERRORS

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

­[TNOTSUPPORT] (XTI only) This function is not supported by the underlying transport provider. 

RETURN VALUE

State is returned upon successful completion.  Otherwise, a value of -1 it 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 for an orderly release request). 

NOTE

In HP-UX 9.0, XTI (X/Open Transport Interface) supports only OSI as a transport provider, and is available only as part of the OSI Transport Services 9000 product. Users of this product can access XTI versions of the t_* routines by linking with /usr/lib/libxti.a.  For more information on XTI, see "HP-UX/9000 XTI Programmer’s Guide". 

In HP-UX 9.0, TLI (Transport Layer Interface) supports any transport provider which is compliant with TPI (Transport Provider Interface).  TLI is available only as part of the STREAMS product.  Users of this product can access TLI versions of the t_* routines by linking with /usr/lib/libnsl_s.a.  For more information on TLI, see the TLI section of "STREAMS/UX for HP 9000 Reference Manual". 

SEE ALSO

t_open(3). 

Hewlett-Packard Company  —  HP-UX Release 9.0: October 1992