HP UX 11i v1 I/O Cards 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 point	Thread cancellation will not occur when a 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 169