ZCOM C I/F Library Routines

 

 

 

ZCNTL (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).

 

See the NOTES section for more information on using this routine in a

 

multi-threaded application.

 

PARAMETERS

 

 

 

zap

Pointer to terminal ZCOM address. The destination where the control

 

message is sent.

 

 

mode

Completion control:

 

 

 

ZMODE_NO_WAIT

 

(0) - Send no wait

 

ZMODE_RPT_ERRS

 

(1) - Send no wait, report errors

 

ZMODE_DEF_STATUS

 

(2) - Send no wait, definite status

 

ZMODE_RPT_ERRS_WBUF

(5) - Send no wait, report errors with

 

ZMODE_DEF_STATUS_WBUF buffer

 

ZMODE_WAIT

 

(7) - Send no wait, definite status and

 

 

 

buffer

 

 

 

(8) - Send and await status in rstat

Chapter 4

171