NAME

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

SYNOPSIS

       $PCP_BINADM_DIR/runaspcp [-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).

Performance Co-Pilot                                   PCP                                           RUNASPCP(1)