HP Advanced Communications Controllers (ACC) manual Zcomlname, Async-cancel safe

ZCOM C I/F Library Routines

ZCOMLNAME (3X)

		ZCOMLNAME (3X)
NAME		zcomlname – Set up originator name for log messages
SYNOPSIS
#include	<zcom/zcomsys.h>
#include	<zcom/zcomcall.h> /* if compiled with ANSI C (recommended) */
void zcomlname (name)
char	*name;
DESCRIPTION		Routine zcomlname sets up the originator (program) name to be used by
		the ZCOM message log system. Subsequent calls to zcomlog will log
		messages with this specified program name. Refer to zcomlog(3x) for
		more information on log messages.
		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:
		not a cancellation	Thread cancellation will not occur when a
		point	thread is calling this routine.
		async-cancel safe	The calling thread’s cancelability type may
			be deferred or asynchronous when calling
			this routine.
		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 below for more information on using this routine in a multi-threaded application.

Chapter 4 181