explain_kill_or_die(3)

💖 explain_kill_or_die — the kill(2) glow-up, from libexplain's Library Functions Manual 🎀

okay bestie, sit down, hydrate, and let me tell you about the most dramatic little helper in <libexplain/kill.h>. this is explain_kill_or_die(3) and it does exactly what it says on the tin: it kills, or it dies. no cap. 💀✨

---

✨ NAME ✨

explain_kill_or_die — send signal to a process and report errors 🫶

---

🌸 SYNOPSIS 🌸

#include <libexplain/kill.h>
void explain_kill_or_die(pid_t pid, int sig);
int explain_kill_on_error(pid_t pid, int sig);

---

🦋 DESCRIPTION 🦋

so, the explain_kill_or_die function is used to call the kill(2) system call. on failure, an explanation will be printed to stderr, obtained from the explain_kill(3) function, and then the process terminates by calling exit(EXIT_FAILURE). it's giving "we tried, we explained, we perished" 💅

the explain_kill_on_error function is used to call the kill(2) system call. on failure an explanation will be printed to stderr, obtained from the explain_kill(3) function, but it still returns to the caller. so it's the chill one. it explains and then hands you the keys back. 🌈

• pid — the pid, exactly as to be passed to the kill(2) system call. don't get cute with it, it's the pid fr fr.
• sig — the sig, exactly as to be passed to the kill(2) system call. same energy. 🙈

---

👑 RETURN VALUE 👑

the explain_kill_or_die function only returns on success — see kill(2) for more information. on failure, it prints an explanation and exits. it does not return. like, at all. it's gone. gone girl. 💀

the explain_kill_on_error function always returns the value returned by the wrapped kill(2) system call. every single time. it's loyal like that. 🫶

---

🌟 EXAMPLE 🌟

the explain_kill_or_die function is intended to be used in a fashion similar to the following example:

explain_kill_or_die(pid, sig);

that's it. that's the whole vibe. iconic honestly. ✨

---

🔥 SEE ALSO 🔥

• kill(2) — send signal to a process
• explain_kill(3) — explain kill(2) errors
• exit(2) — terminate the calling process

---

heads up bestie: if it fails, it's out. no return, no second chances, just exit(EXIT_FAILURE). plan accordingly. 💅

---

and that's the tea, babes 🍓 this little page came from libexplain version 1.4, with Copyright (C) 2009 Peter Miller — go give them their flowers, they earned them. mwah. 💖