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.

Chapter 4

141

Page 141
Image 141
HP UX 11i v1 I/O Cards manual Logical terminal table. Note that if the logical, Len Length in bytes of ibuf