Reference Guide

ZCOM C I/F Library Routines
LTFIND (3X)
Chapter 4148
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:
PAR AMETER S
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.
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:
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.