HP Advanced Communications Controllers (ACC) manual Zinit, Not a cancellation

ZCOM C I/F Library Routines

ZINIT (3X)

		ZINIT (3X)
NAME		zinit – ZCOM routine initialization
SYNOPSIS
#include	<zcom/zcomsys.h>
#include	<zcom/zcomcall.h> /* if compiled with ANSI C (recommended) */
int32 zinit		(sip)
zsinfo_type		*sip;
DESCRIPTION		Routine zinit initializes the access to the ZCOM system and sets up the
		global variables for use by the other ZCOM routines. Therefore, it must
		be called before any other ZCOM routines are used. This routine also
		returns some ZCOM system information. Since not every application
		programs require this information, so after the zinit call the buffer may
		be reused for other purposes.
		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 safe	The calling thread’s cancelability type may
			be deferred or asynchronous when calling
			this routine.
		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 below for more information on using this routine in a multi-threaded application.

240 Chapter 4