HP UX 11i v1 I/O Cards manual Zinit Zcom routine initialization

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 point	Thread cancellation will not occur when a 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.

Chapter 4 221