explain_lchown_or_die(3)

💖 explain_lchown_or_die — Library Functions Manual 💖

okay bestie, so we're in explain_lchown_or_die(3) territory and honestly? it's giving "just do the thing and scream if it breaks" energy. let's get into it 🫶

---

✨ NAME ✨

explain_lchown_or_die — change ownership of a file and report errors

like... it changes ownership of a file, and if that doesn't work out, it does not keep it cute. it reports the errors. periodt. 💅

---

🌸 SYNOPSIS 🌸

#include <libexplain/lchown.h>
void explain_lchown_or_die(const char *pathname, int owner, int group);

---

🦋 DESCRIPTION 🦋

so here's the tea. the explain_lchown_or_die function is literally just here to call the lchown(2) system call for you. that's the whole job. iconic of it.

but bestie — and this is the important part — on failure an explanation gets printed to stderr, and that explanation is obtained from explain_lchown(3). and then? the process terminates by calling exit(EXIT_FAILURE). no second chances, no "let me think about it". it's done. 💀

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

explain_lchown_or_die(pathname, owner, group);

and now the args, one by one, no skipping, i would never 🙈

• pathname — the pathname, exactly as to be passed to the lchown(2) system call. like don't get creative with it, pass it the way it wants it. ✨
• owner — the owner, exactly as to be passed to the lchown(2) system call.
• group — the group, exactly as to be passed to the lchown(2) system call.

Returns:

this function only returns on success. on failure, it prints an explanation and exits. so if you ever see it come back to you? that means it worked. slay. 🎀

lowkey a warning but also just facts: there is no failure return path here. it's success or it's exit(EXIT_FAILURE). there is no in-between, no -1, nothing. main character energy but make it fatal. 👑

---

🌈 SEE ALSO 🌈

• lchown(2) — change ownership of a file
• explain_lchown(3) — explain lchown(2) errors
• exit(2) — terminate the calling process

---

👑 COPYRIGHT 👑

this whole situation is brought to you by libexplain version 1.4 and Copyright (C) 2008 Peter Miller.

---

okay so that's the page!! thanks for reading my lil manual rant bestie, this was explain_lchown_or_die(3) from the Library Functions Manual, shipped in libexplain version 1.4, Copyright (C) 2008 Peter Miller. mwah 💋 go change some ownership, stay hydrated, and remember: on failure it prints an explanation and exits, so honestly? just let it cook. 🧚✨