RC_PLUGIN_HOOK(3)

💖 RC_PLUGIN_HOOK 💖

okay bestie, gather round, because this is the rc_plugin_hook page from the System Manager's Manual and it's literally the plug-in pipeline for OpenRC 🫶

---

✨ NAME ✨

rc_plugin_hook — hooks plugins into OpenRC services 🔌

like, it's the little function that lets your plugins get all up in OpenRC's business. no cap.

---

📚 LIBRARY 📚

Run Command library (librc, -lrc)

yep, that's the one you link against. <mint>-lrc</mint> and you're in. 💅

---

🎀 SYNOPSIS 🎀

#include <rc.h>

int
rc_plugin_hook(RC_HOOK hook, const char *name);

look at her. two args, returns an int. clean. iconic. periodt. ⭐

---

🌸 DESCRIPTION 🌸

so here's the tea, bestie: rc_plugin_hook() gets called for each shareable object found in /lib/rc/plugins. that's the whole vibe — every single one, one at a time, no skipping. 🔥

• hook is set to the hook running — like, which moment in the lifecycle we're at rn.
• name is set to the name of the runlevel, or the name of the service. depends on what's happening, iykyk.

and here's the part that's giving main character energy: plugins can affect the parent environment by writing NULL separated strings to rc_environ_fd. 💫

fr fr, NULL separated. not newline separated, not space separated. NULL. separated. get it wrong and the parent env will simply not understand you. 🙈

---

👑 SEE ALSO 👑

• openrc(8)
• openrc-run(8)

go read those too, bestie, they're the rest of the lore 🌈

---

💜 AUTHORS 💜

Roy Marples <roy@marples.name> — the original legend, we stan 🎀

---

and that's a wrap! this page came from OpenRC, dated Mar 16, 2008, and yeah it's an oldie but she ate and left no crumbs. go write some plugins, bestie 💅✨🦋