ERRNO(3am)

✨ errno — ok bestie, this is the gawk extension that turns errno values into strings and back 💅

so like. this page lives in the GNU Awk Extension Modules corner of the manual-verse, section 3am, and it's genuinely one of the most useful little guys you'll ever @load. no cap.

---

🌸 NAME 🌸

errno — the gawk extension that converts errno values to strings and vice versa. it's giving translator. it's giving bilingual icon. 🦋

---

🎀 SYNOPSIS 🎀

@load "errno"

string = strerror(11)
string = errno2name(11)
integer = name2errno("EAGAIN")

like yes, that's the whole vibe. three functions, one load. slay. ✨

---

💖 DESCRIPTION 💖

okay so here's the tea: this extension is for working with the gawk PROCINFO["errno"] value. that's its whole main character purpose. 🫶

and the way it does that is by adding three functions, named strerror(), errno2name(), and name2errno(). let's go one by one, bestie:

• strerror() — this one takes an integer argument and hands you back the result of calling the strerror(3) C library function. that's it, that's the whole job. but — and this is important — if the argument is not numeric, it returns an empty string. so don't come at it with vibes, come at it with numbers. 😭
• errno2name() — this one takes an integer argument and returns the symbolic name for the associated errno value. like, for example, the returned value might be "EACCES" or "EAGAIN". and if the argument is something it doesn't recognize? empty string. nothing. silence. 🙈
• name2errno() — the reverse baddie. takes a string argument and returns the integer value associated with that symbolic errno value. for example, if the argument is "EAGAIN", the returned value might be 11. and for unrecognized arguments, it returns a value of -1. iconic behavior, honestly. 💀

---

🌈 EXAMPLE 🌈

here's what it looks like in the wild, fr fr:

@load "errno"
...
printf "The numeric value of 'EAGAIN' is %d\n", name2errno("EAGAIN")
printf "The string value of 11 is %s\n", errno2name(11)
printf "The description of errno 11 is '%s'\n", strerror(11)

not me tearing up at how clean that is. 🥹

---

👀 SEE ALSO 👀

• strerror(3)

go read that one too, it's the OG. iykyk. 📚

---

💜 AUTHOR 💜

Andrew Schorr — thank you for your service, king. 👑

---

🧚 COPYING PERMISSIONS 🧚

okay legal bestie moment, don't skip this part:

Copyright © 2012, 2013, Free Software Foundation, Inc.

Permission is granted to make and distribute verbatim copies of this manual page provided the copyright notice and this permission notice are preserved on all copies.

Permission is granted to copy and distribute modified versions of this manual page under the conditions for verbatim copying, provided that the entire resulting derived work is distributed under the terms of a permission notice identical to this one.

Permission is granted to copy and distribute translations of this manual page into another language, under the above conditions for modified versions, except that this permission notice may be stated in a translation approved by the Foundation.

---

✨ and that's the whole page, bestie. go forth and @load "errno" responsibly. 🫶

this lil masterpiece comes to you courtesy of the Free Software Foundation, dated Jan 15 2013, and it lives at ERRNO(3am) forever and ever. mwah. 💋