PMSETPROCESSIDENTITY(3)

💖 PMSETPROCESSIDENTITY 💖

okay bestie, so this is a Library Functions Manual page, section 3, and it's all about pmSetProcessIdentity — literally the girl whose whole job is setting a process's user and group id. 👑

---

✨ NAME ✨

pmSetProcessIdentity — set process user and group id 🫶

---

🌸 C SYNOPSIS 🌸

no cap, here's the exact incantation:

#include <pcp/pmapi.h>

int pmSetProcessIdentity(const char *username);

cc ... -lpcp

---

🦋 DESCRIPTION 🦋

So here's the tea. pmSetProcessIdentity gives you a platform-independent way to set the user id of a process to the one matching username. Like, doesn't matter what platform you're on, she shows up and handles it. 💅

And if it's possible — meaning when the caller is already running as root — she'll also set the group id of the process to that of the matching user, e.g. using username and getpwnam(3). main character energy fr fr. 🌈

A return value of 0 means success, obviously. Anything else? That's an error code, bestie, and you can decode it with pmErrStr(3). 😭

Oh and also — pmSetProcessIdentity is most often used in conjunction with pmGetUsername(3) at process start up. They're a duo. Iconic. 🎀

---

🔥 SEE ALSO 🔥

• getpwnam(3)
• PMAPI(3)
• pmErrStr(3)
• pmGetUsername(3)
• setgid(3)
• setuid(3)

---

that's the whole vibe, bestie, go forth and set those ids 💜

Performance Co-Pilot · PCP · PMSETPROCESSIDENTITY(3) — mwah, xoxo, slay, periodt ✨💖