ACC Programmer's Reference Guide

Chapter 4 217

ZCOM C I/F Library Routines

ZINFO (3X)

zinfo – Get ZCOM table information

#include <zcom/zcomsys.h>

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

(recommended) */

int32 zinfo (zap, mode, ibuf, len)

zaddr_type *zap;

unit32 mode;

char *ibuf;

int32 len;

DESCRIPTION Routine zinfo is used to retrieve the contents of various ZCOM

subsystem tables. Depending on the mode selected, it retrieves

information such as the System Header, Interface Ta ble, Logical and

Physical Terminal Tables, ZLU descriptor table, or Node Entry table.

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:

cancellation point Thread cancellation can occur when a thread calls this

routine.

async-cancel unsafe The calling thread’s cancelability type must be

PTHREAD_CANCEL_DEFERRED if cancellation is

enabled.

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.