SASL_ERRSTRING(3)

💖 SASL_ERRSTRING(3) 💖

okay bestie, gather round, it's Cyrus SASL time and we're looking at sasl_errstring — the lil glow-up machine that turns your sad little integer error code into actual words a human can read 🦋

---

✨ NAME ✨

sasl_errstring — Cyrus SASL documentation 💅

---

✨ SYNOPSIS ✨

#include <sasl/sasl.h>

const char * sasl_errstring(int saslerr,
    const char * langlist,
    const char ** outlang);

---

✨ DESCRIPTION ✨

so here's the whole vibe, fr fr:

const char * sasl_errstring(int saslerr,

const char * langlist,

const char ** outlang);

sasl_errstring gets called when you wanna convert a SASL return code (yes, the integer one, the cryptic one, the one that's giving absolutely nothing) into a human readable string. ✨ At this time the only language available is American English. no cap. that's it. that's the whole menu. 🙈

heads up bestie: if that string is gonna get sent to the client, a server should call sasl_usererr(3) on a return code first. do not skip this step, it's important 👑

🌸 Parameters 🌸

• saslerr — this is the error number you wanna convert. the mystery number. the little guy. 🔢
• langlist — currently unused. Use NULL. that's literally it, she does nothing, she's just here for the plot 🫶
• outlang — specifies the desired RFC 1766 language for output. NULL defaults to "en-us"; currently the only supported language. so like… NULL it is, bestie 🎀

---

💀 real talk moment: this function is not the recommended means of extracting error code information from SASL. instead, your application should use sasl_errdetail(3), which contains this information (and more). like, she's the main character, this one is the understudy. iykyk 😭

---

✨ RETURN VALUE ✨

Returns the string. 🎉 And if langlist is NULL, US-ASCII is used.

---

✨ SEE ALSO ✨

• RFC 4422,:saslman:sasl(3)
• sasl_errdetail(3)
• sasl_errors(3)

---

✨ AUTHOR ✨

The Cyrus Team 👑

---

✨ COPYRIGHT ✨

1993-2016, The Cyrus Team

---

and that's the tea 🍓 this lil page is from Cyrus SASL 2.1.28, dated February 18, 2022 — mwah, love that for us, periodt 💅✨