HP UX 11i v1 I/O Cards manual Zgetshrcvrlist Get list of current shared receivers

	ZCOM C I/F Library Routines
	ZGET_SHRCVR_LIST (3X)
	ZGET_SHRCVR_LIST (3X)
NAME	zget_shrcvr_list – Get list of current shared receivers

#includeSYNOPSIS<zcom/zcomsys.h>

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

int32 zget_shrcvr_list (zap, mode, mlen, zrcvrs)

zaddr_type *zap;

uint32 mode;

int32 mlen;

zaddr_type zrcvrs[];

DESCRIPTION	Routine zget_shrcvr_list is used to retrieve the contents of a linked list of
	shared receivers from the ZCOM subsystem tables. Depending on the
	mode selected, and terminal specified (if needed), this call will return an
	array of shared receivers from one of the ZCOM tables (DSC Events,
	Node Status Receivers, PTT Receivers, or LTT Receivers).
	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.

214 Chapter 4