HP UX 11i v1 I/O Cards manual Name, Zinfo

NAME

SYNOPSIS

ZCOM C I/F Library Routines

ZINFO (3X)

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 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.

Chapter 4 217