explain_ge...ame_or_die(3)

💖 explain_ge...ame_or_die(3) — Library Functions Manual 💖

okay bestie, gather round, because we're reading a manpage from the explain_ge...ame_or_die(3) manual and honestly? it's giving helpful. 🫶

---

✨ NAME ✨

explain_getpeername_or_die — get name of peer socket and report errors

---

🌸 SYNOPSIS 🌸

#include <libexplain/getpeername.h>
void explain_getpeername_or_die(int fildes, struct sockaddr *sock_addr,
socklen_t *sock_addr_size);

---

🦋 DESCRIPTION 🦋

so the explain_getpeername_or_die function is literally just there to call the getpeername(2) system call for you. that's it, that's the job. 💅

but here's the part where it eats: on failure it prints an explanation to stderr, and that explanation is obtained from explain_getpeername(3), and then — and this is the "or_die" part, no cap — the process terminates by calling exit(EXIT_FAILURE). iconic behavior honestly. 🔥

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

struct sockadd sock_addr;
socklen_t sock_addr_size = sizeof(sock_addr);
explain_getpeername_or_die(fildes, &sock_addr, &sock_addr_size);

🎀 yes, that says struct sockadd and not struct sockaddr — we're keeping it exactly how the page says it, bestie. not my business, not my problem, I just report. 💀

now let's meet the arguments, one by one, like a lil lineup:

• fildes — the fildes, exactly as to be passed to the getpeername(2) system call. exactly. like, do not freestyle it. ✨
• sock_addr — the sock_addr, exactly as to be passed to the getpeername(2) system call. same energy, same rules. 🌈
• sock_addr_size — the sock_addr_size, exactly as to be passed to the getpeername(2) system call. you're sensing the pattern, I know you are. 👑

Returns:

• this function only returns on success — see getpeername(2) for more information. and on failure? prints an explanation and exits. no return, no goodbye, just vibes and an exit status. 💀

---

👀 SEE ALSO 👀

• getpeername(2) — get name of connected peer socket
• explain_getpeername(3) — explain getpeername(2) errors
• exit(2) — terminate the calling process

---

💜 COPYRIGHT 💜

libexplain version 1.4 Copyright (C) 2009 Peter Miller

---

and that's the whole page, bestie!! 🌸 it's libexplain version 1.4, copyright Peter Miller circa 2009, and it lives in the explain_ge...ame_or_die(3) manual — go forth and getpeername responsibly, mwah 💖🎀✨