explain_pathconf_or_die(3)

💖 NAME 💖

okay bestie, say hi to explain_pathconf_or_die — she gets configuration values and reports errors, and she does not do it quietly.

---

✨ SYNOPSIS ✨

#include <libexplain/pathconf.h>
long explain_pathconf_or_die(const char *pathname, int name);

---

🦋 DESCRIPTION 🦋

so here's the tea: explain_pathconf_or_die is the glow-up wrapper that calls the pathconf(3) system call for you. and if things go sideways? it prints an explanation straight to stderr — that explanation comes from explain_pathconf(3) — and then it terminates the process by calling exit(EXIT_FAILURE). like, no coming back from that one. 💀

this function is meant to be used in a way that's basically the twin of this example:

long value = explain_pathconf_or_die(pathname, name);

⚠️ heads up, bestie: a -1 return value is still possible, and that's not a bug — it literally means the system does not have a limit for the requested resource. periodt.

pathname

the pathname, exactly as to be passed to the pathconf(3) system call. no edits, no remixes, hand it over exactly as-is. 💅

name

the name, exactly as to be passed to the pathconf(3) system call. same deal — verbatim, babe. ✨

Returns:

this function only returns on success. on failure it prints an explanation and exits. that's the whole vibe. 🌸

---

🌈 SEE ALSO 🌈

• pathconf(3) — get configuration values for files 👑
• explain_pathconf(3) — explain pathconf(3) errors 🔥
• exit(2) — terminate the calling process (the dramatic exit, iykyk) 🎀

---

💜 COPYRIGHT 💜

and that's a wrap, my love 🫶 this page is libexplain version 1.4, and the copyright belongs to Peter Miller, Copyright (C) 2008 Peter Miller. the manual page itself is explain_pathconf_or_die(3) from the Library Functions Manual — go forth, call your syscalls, and slay ✨💖