ZCOM C I/F Library Routines

ZLTUP (3X)

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).

PARAMETERS

zap ZCOM address.

ibuf Data buffer.

len Byte length of buffer.

offse Byte offset within the logical terminal table where the data in the

tbuffer should be placed. See NOTES for information on finding the offsets.

NOTES

The offset returned by zltstore may be passed to zltup to update the

 

allocated storage area in the extension area. To update the fields in the

 

basic table, the offset may be worked out by the ZCOM_OFFSET macro

 

(defined in zcomsys.h). For example, to get the offset for the application

 

number field ltapno:

 

 

int32

offset;

 

 

zltt_type

ltt, *lttp;

 

 

offset = ZCOM_OFFSET (*lttp, ltapno);

<-- Both will work

 

offset = ZCOM_OFFSET (ltt, ltapno);

<-- Both will work

RETURN VALUE

Routine zltup returns 0 if successful. Otherwise, a non-zeroerror code

 

is returned. See /opt/acc/include/zcom/zcomsys.h for the list of ZCOM

 

error codes and their meanings.

 

EXAMPLE

#include

<zcom/zcomsys.h>

 

 

#include

<zcom/zcomcall.h>

 

 

int32

ierr;

 

 

zaddr_type

zaddr;

 

 

char

ibuf[size]; /* where size is user-defined; must

 

be >= len */

 

 

258

Chapter 4