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