program_invocation_name(3)

✨ program_invocation_name — okay bestie, let's learn ur own name ✨

so like... you ever wanted to know what ur program is literally CALLED? Not what you named the file, not what someone typed — the actual thing that got typed to launch it? Yeah. That's this. It's a libc moment. It's Linux man-pages 6.20, dated 2026-02-08, and it's from the Library Functions Manual because we're fancy like that. 💅

---

💖 NAME 💖

program_invocation_name, program_invocation_short_name — snag the name that was used to invoke the calling program 🫶

---

📚 LIBRARY 📚

Standard C library — rock that libc, link it with -lc. Periodt. ✨

---

🌸 SYNOPSIS 🌸

#define _GNU_SOURCE         /* See feature_test_macros(7) */
#include <errno.h>

extern char *program_invocation_name;
extern char *program_invocation_short_name;

👀 head's up bestie — you NEED that #define _GNU_SOURCE up at the very top before the includes, or the compiler is gonna be like "who?? never heard of her." It's giving gatekept. The docs even point you at feature_test_macros(7) if you wanna read up. 📖

---

💜 DESCRIPTION 💜

So program_invocation_name holds the name that was used to invoke the calling program. 🎀

And the tea? It's the same thing as the value of argv[0] in main() — BUT, and this is the part that matters, program_invocation_name is global scope. So like, anywhere in ur code can peek at it, not just main(). Main character energy fr fr. 👑

Then there's program_invocation_short_name, which contains the basename component of the name used to invoke the calling program. Translation: it's the same value as program_invocation_name, except everything up to and including the final slash (/) gets chopped off — if there even was a final slash. 🪓

And here's the cute part: these variables get automatically initialized by the glibc run-time startup code. You don't gotta do a single thing. She just shows up ready. ✨

---

🦋 VERSIONS 🦋

Heads up: the Linux-specific /proc/pid/cmdline file gives you access to similar info if you wanna go that route. Different vibe, same-ish intel. 🔍

---

🎀 STANDARDS 🎀

GNU. That's it, that's the standard. 💅

---

👑 SEE ALSO 👑

• proc(5)

---

and that's the whole lore, bestie 💖 This lil page came from Linux man-pages 6.20, last touched 2026-02-08, and it lives in section 3 (the library functions girlies). Go forth and print ur own name, icon. 🌈🫶