PMGETUSERNAME(3)           Library Functions Manual           PMGETUSERNAME(3)

NAME
       pmGetUsername - fetch special PCP username

C SYNOPSIS
       #include <pcp/pmapi.h>

       int pmGetUsername(char **username);

       cc ... -lpcp

DESCRIPTION
       Within the Performance Co-Pilot (PCP) some applications use a special
       (non-root) username to allow access, e.g. to write log files into
       protected directories.

       pmGetUsername returns the name via username.

       The variable name PCP_USER is fetched using pmGetOptionalConfig(3).  If
       this succeeds, pmGetUsername returns 1.  Otherwise.  username is set to
       the default value of pcp and pmGetUsername returns 0.

       pmGetUsername is most often used in conjunction with
       pmSetProcessIdentity(3) at process start up.

SEE ALSO
       PMAPI(3), pmGetOptionalConfig(3) and pmSetProcessIdentity(3).

Performance Co-Pilot                  PCP                     PMGETUSERNAME(3)