PMSETPROGNAME

Section: C Library Functions (3)
Index Return to Main Contents

NAME

pmSetProgname , pmGetProgname - application name services

C SYNOPSIS

#include < pcp/pmapi.h >

void pmSetProgname(const char * program );
char *pmGetProgname(void);

cc ... -lpcp

DESCRIPTION

Within the Performance Co-Pilot (PCP) run-time libraries the name of a running application is maintained to be used in error and diagnostic messages.

The default application name is pcp .

pmSetProgname may be used to set the application name to program after stripping any leading components that begin with the filesystem path name separator (``/'' for Unix-like systems).

It is the callers responsibility to ensure the memory pointed to by program remains available for the life of the application. Typically, the value passed as program for a C program would be argv[0] . If program is NULL , the default application name is restored.

pmGetProgname may be used to return the current application name.

SEE ALSO

PMAPI (3).


Index

NAME
C SYNOPSIS
DESCRIPTION
SEE ALSO