HP UX 11i v1 I/O Cards manual Cancellation point, Routine

ZCOM C I/F Library Routines

ZCLOS (3X)

Threads	This routine may be called from multi-threaded application using the POSIX
Considerations	(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).
PARAMETERS

zap ZCOM address to be returned to the system.

RETURN VALUE Routine zclos returns 0 if successful. Otherwise, a non-zeroerror code is returned. See /opt/acc/include/zcom/zcomsys.h for the list of ZCOM error codes and their meanings.

EXAMPLE

#include <zcom/zcomsys.h>

#include <zcom/zcomcall.h>

int32ierr;

zaddr_type zaddr;

if (ierr = zclos (&zaddr)) {

/* error return code */

}

else {

/* good return code */

}

158 Chapter 4