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 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: