HP Advanced Communications Controllers (ACC) manual Zrntimer, Not a cancellation point

ZCOM C I/F Library Routines

ZRNTIMER (3X)

	ZRNTIMER (3X)
NAME	zrntimer – Set timeout for remote node access
SYNOPSIS
#include	<zcom/zcomsys.h>
#include	<zcom/zcomcall.h> /* if compiled with ANSI C (recommended) */

int32 zrntimer (node, time)

int32 node;

int32 time;

DESCRIPTION	Routine zrntimer is used to change the ZCOM request timeout value for
	requests sent to a remote ZCOM system node. The new timeout only
	affects the calling program, and is effective for all subsequent requests
	for that node until another zrntimer call changes the timeout or
	whenever the program is restarted. In the latter case, the timeout is
	reset to the default value as defined in the TTGEN configuration file.
	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:
not a cancellation point		It has no cancellation point and does not call any
		function with cancellation point. Thread cancellation
		will not occur when a thread is calling 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).

304 Chapter 4