HP UX 11i v1 I/O Cards 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).

Chapter 4 275