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