HP UX 11i v1 I/O Cards manual Zptup, Cancellation point

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

262 Chapter 4