up | Inhaltsverzeichniss | Kommentar

Manual page for T_GETSTATE(3N)

t_getstate - get the current state

SYNOPSIS

#include <tiuser.h>

int t_getstate(fd)
int fd;

DESCRIPTION

t_getstate() returns the current state of the provider associated with the transport endpoint specified by fd.

If the provider is undergoing a state transition when t_getstate() is called, the function will fail. 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
T_OUTREL
outgoing orderly release (waiting for an orderly release indication)
T_INREL
incoming orderly release (waiting for an orderly release request)

RETURN VALUES

t_getstate() returns:

0
on success.
-1
on failure and sets t_errno to indicate the error.

ERRORS

TBADF
The specified file descriptor does not refer to a transport endpoint.
TSTATECHNG
The transport provider is undergoing a state change.
TSYSERR
The function failed due to a system error and set errno to indicate the error.

SEE ALSO

t_open.3n

[a manual with the abbreviation NETP]


index | Inhaltsverzeichniss | Kommentar

Created by unroff & hp-tools. © somebody (See intro for details). All Rights Reserved. Last modified 11/5/97