RUNASPCP(1)

✨ RUNASPCP(1) ✨

okay bestie, welcome to the General Commands Manual entry for runaspcp 💅 buckle up, it's giving "tiny tool, big responsibilities".

---

🌸 NAME 🌸

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

---

🎀 SYNOPSIS 🎀

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

---

💖 DESCRIPTION 💖

so basically, runaspcp runs the single argument command as the user $PCP_USER and group $PCP_GROUP — and both of those come straight from /etc/pcp.conf. no cap, that's the whole personality. 👑

By default the command gets run by sh(1), or you can swap in a different shell using the -s (or --shell) command line argument. pick your fighter 🦋

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. literally the "start as the boss, clock out into a normal human" arc 😭 iconic behaviour, lowkey essential.

The -?, --help option displays a usage message. always here to help fr fr 🫶

---

🔥 DIAGNOSTICS 🔥

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

so if it fails at the privilege-swap step or the shell won't launch, you get a 1. otherwise you inherit whatever command decided to return. vibes passed through, respectfully. 💀

---

🌈 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. ngl it's giving "devs only, bestie, you're not ready for this lore" 🙈

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:

• appl0 — verbose diagnostics 🗣️

---

friendly reminder from your girl: the debugging output is cryptic on purpose-ish and aimed at developers, not end-users. don't come for me when it looks like alphabet soup. 🍓

---

and that's the page, bestie!! this was brought to you by Performance Co-Pilot, living under the PCP umbrella, in the RUNASPCP(1) era — periodt. 💅✨ go run your commands safely, downgrade those privileges, and slay. 🎀💜