SASL_ERRORS(3)

💖 NAME 💖

sasl_errors — the Cyrus SASL documentation bestie, aka your cheat sheet for every error code this library can throw at you ✨

---

🦋 SYNOPSIS 🦋

#include <sasl/sasl.h>

---

🌸 DESCRIPTION 🌸

okay so listen. every time you call into the SASL library, it might hand you back one of these general error codes, and each one has a meaning — tho ngl the exact vibe can shift a lil depending on context. here's the whole roster, no skips, no cuts 💅

🎀 Common Result Codes 🎀

these are the ones everybody meets. main character codes fr.

• SASL_OK — it worked!! success, we ate, periodt 👑
• SASL_CONTINUE — not done yet bestie, authentication needs another step 🔁
• SASL_FAIL — generic failure, the classic "something went wrong" 💀
• SASL_NOMEM — memory shortage failure, we ran out of RAM 😭
• SASL_BUFOVER — the buffer overflowed, it's giving spilled drink 🥤
• SASL_NOMECH — mechanism not supported / no mechanisms matched your requirements 🚫
• SASL_BADPROT — bad / invalid protocol, or protocol cancel 🙈
• SASL_NOTDONE — you cannot request that information / it's not applicable until later in the exchange, patience babes ⏳
• SASL_BADPARAM — you supplied an invalid parameter, girl what was that 💅
• SASL_TRYAGAIN — transient failure (e.g. weak key), so literally just try again 🔄
• SASL_BADMAC — integrity check failed, the vibe check did NOT pass 😬
• SASL_NOTINIT — the SASL library is not initialized, she's not even awake yet 💤

🧚 Client-only Result Codes 🧚

only the client side gets these, iykyk

• SASL_INTERACT — needs user interaction, so go talk to a human 🫶
• SASL_BADSERV — the server failed the mutual authentication step, not our fault bestie 🙅
• SASL_WRONGMECH — this mechanism doesn't support the feature you asked for 🚫

👑 Server-only Result Codes 👑

server girlies only, no clients allowed

• SASL_BADAUTH — authentication failure 🔐
• SASL_NOAUTHZ — authorization failure 🚷
• SASL_TOOWEAK — the mechanism is too weak for this user 🥀
• SASL_ENCRYPT — encryption is needed to use this mechanism 🔒
• SASL_TRANS — one time use of a plaintext password will enable the requested mechanism for the user ✨
• SASL_EXPIRED — passphrase expired, it must be reset ⏰
• SASL_DISABLED — account disabled, she's on pause 🚫
• SASL_NOUSER — user not found, ghosted fr 👻
• SASL_BADVERS — version mismatch with the plug-in 😵
• SASL_NOVERIFY — the user exists, but there's no verifier for the user 🤷

🍓 Password Setting Result Codes 🍓

the ones that show up when you're setting passwords

• SASL_PWLOCK — passphrase locked 🔐
• SASL_NOCHANGE — the requested change wasn't needed, nothing to do here 💁
• SASL_WEAKPASS — passphrase is too weak for security policy, security said no 🚨
• SASL_NOUSERPASS — user supplied passwords are not permitted 🚫

---

🌈 CONFORMING TO 🌈

RFC 4422 — yes bestie, it's standards compliant, we love a certified icon 📜

---

⭐ SEE ALSO ⭐

• sasl(3) — go read this one next, fr fr

---

💜 AUTHOR 💜

The Cyrus Team — legends, honestly 🫶

---

🎀 COPYRIGHT 🎀

1993-2016, The Cyrus Team

---

and that's the whole page babes ✨ this was Cyrus SASL version 2.1.28, dated February 18, 2022 — go forth and handle your error codes like the main character you are 💅🌸💖