ACC Programmer's Reference Guide

ZCOM C I/F Library Routines
ZINIT (3X)
Chapter 4240
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
Considerations
This routine may be called from a multi-threaded application using the
POSIX (1003.1c) kernel threads API package. This routine has the
following characteristics when called by a multi-threaded application:
See the NOTES section below for more information on using this routine
in 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).