HP Advanced Communications Controllers (ACC) 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	Thread cancellation will not occur when a
		point	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).

178 Chapter 4