ACC X.25 Protocol User's Guide

X.25 Application Programming
X25STAT (3X)
Chapter 484
X25STAT (3X)
NAME x25stat – Return a formatted X.25 status or ZCOM error message
SYNOPSIS
#include <zcom/zcomsys.h>
#include <zcom/zcomcall.h> /* if compiled with ANSI C (recommended) */
char *x25stat (req, stat)
int32 req;
int32 stat;
DESCRIPTION Routine x25stat returns a character string which gives an explanation of
the X.25 and ZCOM status codes. It can be used as a replacement for
zcomstatus where the X.25 protocol is being used. Routine x25stat may
be called to format error messages describing the reason for the error in
a terminal request. The returned character string can be up to 31 bytes
in length (maximum), plus a terminating zero.
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:
not a cancellation point Thread cancellation will not occur
when a thread is calling 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).