ACC Programmer's Reference Guide

Chapter 4 221

ZCOM C I/F Library Routines

ZINIT (3X)

zinit – ZCOM routine initialization

#include <zcom/zcomsys.h>

#include <zcom/zcomcall.h> /* if compiled with ANSI C (recommended) */

int32 zinit (sip)

zsinfo_type *sip;

Routine zinit initializes the access to the ZCOM system and sets up the

global variables for use by the other ZCOM routines. Therefore, it mus t

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 o ther 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).