PMSETPROGNAME(3)

🌸 NAME 🌸

okay bestie, welcome to PMSETPROGNAME(3) — the Library Functions Manual page for the application name services. We're talking about:

• pmSetProgname, pmGetProgname — application name services ✨

---

💅 C SYNOPSIS 💅

#include <pcp/pmapi.h>

void pmSetProgname(const char *program);
char *pmGetProgname(void);

cc ... -lpcp

---

🦋 DESCRIPTION 🦋

Inside the Performance Co-Pilot (PCP) run-time libraries, the name of the running application is kept around so it can be used in error and diagnostic messages. Lowkey iconic.

The default application name is pcp. periodt.

pmSetProgname may be used to set the application name to program after stripping any leading components that begin with the filesystem path name separator (/ for Unix-like systems). Slay.

bestie, it is the caller's responsibility to make sure the memory pointed to by program stays available for the life of the application. Do not let it ghost you. 👻

Typically, the value passed as program for a C program would be argv[0]. If program is NULL, the default application name is restored. No cap.

pmGetProgname may be used to return the current application name. It's giving "tell me who you are" energy. 💖

---

👑 SEE ALSO 👑

• PMAPI(3).

---

Performance Co-Pilot · PCP · PMSETPROGNAME(3) — source/version and page name from the footer; date: not present in this footer, bestie. mwah 💋