ZCOM C I/F Library Routines

ZPTUP (3X)

 

ZPTUP (3X)

NAME

zptup - Update physical terminal table user area

SYNOPSIS

#include

<zcom/zcomsys.h>

#include

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

int32 zptup (zap, ibuf, len, offset)

zaddr_type *zap;

char *ibuf;

int32 len;

int32 offset;

DESCRIPTION

Routine zptup is used to update information in the user area of the

 

physical terminal table. This user area contains transmit and receive

 

message counters as well as error counters and special configuration

 

information specific to the protocol being used. For example, if the

 

terminal is using X.25 packet switching, it would hold X.25 related

 

details. See under the section on the physical terminal tables.

 

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.

 

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

287