Reference Guide

ZCOM C I/F Library Routines
ZPTUP (3X)
Chapter 4 287
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
Considerations
This routine may be called from a multi-threaded application using the
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).