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