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 buffer

 

ZMODE_DEF_STATUS_WBUF

(7) - Send no wait, definite status and buffer

 

ZMODE_WAIT

 

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

Chapter 4

161

Page 161
Image 161
HP UX 11i v1 I/O Cards Send no wait, report errors, Send no wait, definite status, Send and await status in rstat