runaspcp - Man Page

$PCP_BINADM_DIR/runaspcp [-s shell] command

runaspcp runs the single argument command as the user $PCP_USER and group $PCP_GROUP (both from /etc/pcp.conf).

The command is run by sh(1) by default, else shell from the -s (or --shell) command line argument.

Normally runaspcp is used from the PCP “init” scripts that are launched as “root” but need to downgrade their privileges when running some PCP daemons as the “pcp” user.

The -?, --help option displays a usage message.

The exit status is 1 if runaspcp cannot change user or group, or cannot execute the shell, else the exit status of command.

Environment variables with the prefix PCP_ are used to parameterize the file and directory names used by PCP. On each installation, the file /etc/pcp.conf contains the local values for these variables. The $PCP_CONF variable may be used to specify an alternative configuration file, as described in pcp.conf(5).