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

Item Description
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.