pmgetusername(3)

pmgetusername3

Fetch special pcp username

Part of pmGetUsername(3).

C synopsis

#include <pcp/pmapi.h>

int pmGetUsername(char **username)

cc ... -lpcp

Overview

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.

From libpcp3-dev 4.3.2+really4.3.1-0.1 in Debian 10 (Buster). Parsed by carta from the page's man source.