ZCOM C I/F Library Routines

LTFIND (3X)

Threads

This routine may be called from a multi-threaded application using the

Considerations

POSIX (1003.1c) kernel threads API package. This routine has the

 

following characteristics when called by a multi-threaded application:

 

cancellation point

Thread cancellation can occur when a thread

 

 

calls this routine.

 

async-cancel unsafe The calling thread’s cancelability type must be

 

 

PTHREAD_CANCEL_DEFERRED if

 

 

cancellation is enabled.

 

async-signal unsafe It cannot be called from a signal handler.

 

fork unsafe

It cannot be called by a child process after

 

 

fork(2) but before exec(2).

PARAMETERS

 

 

 

zap

ZCOM address of a terminal in the

 

 

multiplexed group.

 

laddr

Logical address with which to compare.

 

llen

Length in bytes of laddr. A maximum of 10

 

 

bytes/characters of laddr will be used, even if

 

 

a number greater than 10 is specified in llen.

 

ibuf (Return Param)

Logical terminal table. Note that if the logical

 

 

terminal is not found, ibuf will not contain

 

 

valid data.

 

len

Length in bytes of ibuf.

RETURN VALUE

Routine ltfind returns 0 if successful. Otherwise, a non-zeroerror code

 

is returned. See /opt/acc/include/zcom/zcomsys.h for the list of ZCOM

 

error codes and their meanings. If the logical terminal is not found,

 

ZENOTM (-75) is returned.

NOTES

The returned logical terminal table consists of the basic table and the

 

logical terminal table extension (the extension size is configurable in the

 

TTGEN configuration file). The size of this buffer should be large enough

to hold the information required from the LTT. An example of defining a buffer of sufficient size would be:

148

Chapter 4