ZCOM C I/F Library Routines

ZLTUP (3X)

 

ZLTUP (3X)

NAME

zltup – Update logical terminal table

SYNOPSIS

#include

<zcom/zcomsys.h>

#include

<zcom/zcomcall.h> /* if compiled with ANSI C (recommended) */

int32 zltup (zap, ibuf, len, offset)

zaddr_type *zap;

char*ibuf;

int32 len;

int32 offset;

DESCRIPTION

Routine zltup is used to update information in the user area of the logical

 

terminal area. This user area contains information such as details

 

pertaining to the location of the terminal, a user-assigned terminal name

 

and the extension area (of configurable size). For complete details see the

 

section on logical terminal tables.

 

Part of the logical terminal table is assigned by TTGEN, the rest is

 

initialized according to the parameters specified in the TTGEN

 

configuration file. The table extension (if defined) is set up and

 

initialized to zero by the system (unless LDATA is specified in the

 

TTGEN configuration file to pre-define the values).

 

Typically, zltup is used to update the user data kept in the table

 

extension area.

 

 

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.

Chapter 4

257