t_look(3)

NAME

t_look − look at the current event on a transport endpoint

SYNOPSIS

#include <xti.h> (for XTI)

#include <tiuser.h> (for TLI)

int t_look (fd)
int fd;

DESCRIPTION

The t_look() function returns the current event on the transport endpoint specified by fd. This function enables a transport provider to notify a transport user of an asynchronous event when the user is calling functions in synchronous mode. Certain events require immediate notification of the user and are indicated by a specific error, [TLOOK], on the current or next function to be executed.

This function also enables a transport user to poll a transport endpoint periodically for asynchronous events.

ERRORS

On failure, t_errno is set to one of the following:

[TBADF] The specified identifier does not refer to a transport endpoint.

[TSYSERR] A system error has occurred during execution of this function.

RETURN VALUE

Upon success, t_look() returns a value that indicates which of the following allowable events has occurred, or returns zero if no event exists. One of the following events is returned:

T_LISTEN connection indication received

T_CONNECT connect confirmation received

T_DATA normal data received

T_EXDATA expedited data received

T_DISCONNECT disconnect received

T_UDERR datagram error indication.

T_ORDREL orderly release indication

T_GODATA (XTI only) flow control restrictions on normal data flow have been lifted. Normal data may be sent again.

T_GOEXDATA (XTI only) flow control restrictions on expedited data flow have been lifted. Expedited data may be sent again.

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".

Museum

Related Articles