[ Bottom of Page | Previous Page | Next Page | Contents | Index | Library Home |
Legal |
Search ]
Technical Reference: Communications, Volume 2
t_getstate Subroutine for Transport Layer Interface
Purpose
Gets the current state.
Library
Transport Layer Interface Library (libtli.a)
Syntax
#include <tiuser.h>
int t_getstate(fd)
int fd;
Description
The t_getstate subroutine returns
the current state of the provider associated with the transport end point
specified by the fd parameter.
Parameter
fd |
Specifies the transport end point. |
Return Codes
On successful completion, the t_getstate subroutine returns the current state. Otherwise, it returns a value
of -1, and the t_errno variable is set to indicate the
error.
If the provider is undergoing a state transition when
the t_getstate subroutine is called, the function will
fail. The current state is one of the following.
Value |
Description |
T_DATAXFER |
Data transfer. |
T_IDLE |
Idle. |
T_INCON |
Incoming connection pending. |
T_INREL |
Incoming orderly release (waiting to send an orderly release indication). |
T_OUTCON |
Outgoing connection pending. |
T_OUTREL |
Outgoing orderly release (waiting for an orderly release indication). |
T_UNBND |
Unbound. |
Error Codes
If unsuccessful, the t_errno
variable is set to one of the following:
Value |
Description |
TBADF |
The specified file descriptor does not refer to a transport end point. |
TSTATECHNG |
The transport provider is undergoing a state change. |
TSYSERR |
A system error has occurred during execution of this function. |
Related Information
The t_open subroutine.
List of Streams Programming
References and STREAMS Overview in AIX 5L Version 5.2 Communications Programming Concepts.
[ Top of Page | Previous Page | Next Page | Contents | Index | Library Home |
Legal |
Search ]