ZCOM C I/F Library Routines

ZINFO (3X)

 

ZINFO (3X)

NAME

zinfo – Get ZCOM table information

SYNOPSIS

#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 Table, 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

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:

 

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.

236

Chapter 4