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