ACC Programmer's Reference Guide

Chapter 4 141
ZCOM C I/F Library Routines
LTFIND (3X)
Threads
Considerations
This routine may be called from a multi-threaded application using the
POSIX (1003.1c) kernel threads API package. This routine has the
following characteristics when called by a multi-threaded application:
PARAMETERS
RETURN VALUE Routine ltfind returns 0 if successful. Otherwise, a non-zero error 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.
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).
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.