ACC Programmer's Reference Guide

Chapter 4 161
ZCOM C I/F Library Routines
ZCNTL (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:
See the NOTES section for more information on using this routine in a
multi-threaded application .
PARAMETERS
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
Modes 5 and 7 are only meaningful when rcode is 3.
Some bits (when set) in the mode parameter can cause zcntl to behave differently.
Refer to the NOTES section in zsend(3X) for details.