Reference Guide

ZCOM C I/F Library Routines
ZCOMERROR (3X)
Chapter 4178
ZCOMERROR (3X)
NAME zcomerror – Return a formatted ZCOM error message
SYNOPSIS
#include <zcom/zcomsys.h>
#include <zcom/zcomcall.h> /* if compiled with ANSI C (recommended) */
char *zcomerror(err)
int32 err;
Description Routine zcomerror returns a character string containing error text
associated with an error number returned through use of the ZCOM
library calls. It works in a similar fashion to zcomstatus, however, it has
only one parameter passed in the call.
The return character string can be up to 31 bytes in length, plus a
terminating zero.
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:
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).