Reference Guide

ZCOM C I/F Library Routines
ZCNTL (3X)
Chapter 4 171
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:
See the NOTES section for more information on using this routine in a
multi-threaded application.
PAR AMETER S
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 Pointer to terminal ZCOM address. The destination where the control
message is sent.
mode Completion control:
ZMODE_NO_WAIT
ZMODE_RPT_ERRS
ZMODE_DEF_STATUS
ZMODE_RPT_ERRS_WBUF
ZMODE_DEF_STATUS_WBUF
ZMODE_WAIT
(0) - Send no wait
(1) - Send no wait, report errors
(2) - Send no wait, definite status
(5) - Send no wait, report errors with
buffer
(7) - Send no wait, definite status and
buffer
(8) - Send and await status in rstat