Reference Guide

ZCOM C I/F Library Routines
ZGET_SHRCVR_LIST (3X)
Chapter 4 233
ZGET_SHRCVR_LIST (3X)
NAME zget_shrcvr_list – Get list of current shared receivers
SYNOPSIS
#include <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
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.