ZCOM C I/F Library Routines

ZGET_SHRCVR_LIST (3X)

 

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;

int32mlen;

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.

Chapter 4

233