oracular (3) pmGetProgname.3.gz

Provided by: libpcp3-dev_6.3.0-1_amd64 bug

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