RUNASPCP(1)

NAME
runaspcp - execute a shell command as the user ``pcp''

SYNOPSIS
$PCP_BINADM_DIR/runaspcp [-D debug] [-s shell] command

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

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

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

DEBUGGING OPTIONS
The -D or --debug option enables the output of additional diagnostics on stderr to help triage problems, although the information is sometimes cryptic and primarily intended to provide guidance for developers rather than for end-users. debug is a comma separated list of debugging options; use pmdbg(1) with the -l option to obtain a list of the available debugging options and their meaning.

Debugging options specific to runaspcp are as follows:
Option | Description
appl0 | verbose diagnostics