HP UX 11i v1 I/O Cards manual Zcomerror, Not a cancellation point

ZCOM C I/F Library Routines

ZCOMERROR (3X)

ZCOMERROR (3X)

NAME

zcomerror – Return a formatted ZCOM error message

SYNOPSIS

#include	<zcom/zcomsys.h>
#include	<zcom/zcomcall.h> /* if compiled with ANSI C (recommended) */
char	*zcomerror(err)
int32	err;

Description	Routine zcomerror returns a character string containing error text
	associated with an error number returned through use of the ZCOM
	library calls. It works in a similar fashion to zcomstatus, however, it has
	only one parameter passed in the call.
	The return character string can be up to 31 bytes in length, plus a
	terminating zero.
	The libraries libzcom_c.a and libpthread.a must be linked into the calling
	program by giving the options “-lzcom_c -lpthread” to cc(1) or ld(1).
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:
	not a cancellation point	Thread cancellation will not occur when a thread is
		calling 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).

Chapter 4 167