runaspcp(1) — Linux manual page

NAME \| SYNOPSIS \| DESCRIPTION \| DIAGNOSTICS \| PCP ENVIRONMENT \| COLOPHON

RUNASPCP(1)              General Commands Manual             RUNASPCP(1)

NAME top

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

SYNOPSIS top

       $PCP_BINADM_DIR/runaspcp [-s shell] command

DESCRIPTION top

       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 top

       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 top

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

COLOPHON top

       This page is part of the PCP (Performance Co-Pilot) project.
       Information about the project can be found at 
       ⟨http://www.pcp.io/⟩.  If you have a bug report for this manual
       page, send it to pcp@groups.io.  This page was obtained from the
       project's upstream Git repository
       ⟨https://github.com/performancecopilot/pcp.git⟩ on 2024-06-14.
       (At that time, the date of the most recent commit that was found
       in the repository was 2024-06-14.)  If you discover any rendering
       problems in this HTML version of the page, or you believe there
       is a better or more up-to-date source for the page, or you have
       corrections or improvements to the information in this COLOPHON
       (which is not part of the original manual page), send a mail to
       man-pages@man7.org

Performance Co-Pilot               PCP                       RUNASPCP(1)