RUNASPCP(1)                 General Commands Manual                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 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 |
       +-------+---------------------+
Performance Co-Pilot                  PCP                          RUNASPCP(1)