ACC X.25 Protocol User's Guide

Chapter 4 107

X.25 Application Programming

ZX25INFO (3X) — ACC X.25

NAME zx25info - Set up ACC X.25 information for subsequent “zx25...” calls

SYNOPSIS

#include <zcom/zcomsys.h>

#include <zcom/zcomx25.h>

int zx25info (zxip, auxname)

zx25info_type *zxip;

char *auxname;

DESCRIPTION Routine zx25info sets up the ACC X. 25 access data structure which is

used in subsequent “zx25...” calls. This routine may allocate some

internal resources. The caller is required to call zx25close(3X) to clean up

the allocated resources when the “zx25...”callsarenolongerrequired.

The libraries libzx25.a, libzcom_c.a and libpthread.a must be linked into

the calling program by giving the “-lzx25 -lzcom_c -lpthread” options 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. It has the following

characteristics when called by multi-threaded applications:

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

See the NOTES section that follows for more information on using this

routine in a multi-threaded application.