ACC Programmer's Reference Guide

Chapter 4 169

ZCOM C I/F Library Routines

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

messageswiththisspecifiedprogramname.Refertozcomlog(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

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:

See the NOTES section below for more information on using this routine

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