SASL_SETPASS(3)

💖 SASL_SETPASS 💖

okay bestie, pull up a chair, because we're talking about sasl_setpass — a page from the Cyrus SASL manual (section 3, for all my library-function girlies 🫶).

✨ NAME ✨

sasl_setpass — Cyrus SASL documentation. yeah, that's literally the whole name entry, she's a woman of few words but many powers 💅

---

🌸 SYNOPSIS 🌸

#include <sasl/sasl.h>

int sasl_setpass(sasl_conn_t *conn,
                 const char *user,
                 const char *pass, unsigned passlen,
                  const char *oldpass, unsigned oldpasslen,
                  unsigned flags)

---

🦋 DESCRIPTION 🦋

int sasl_setpass(sasl_conn_t *conn,

const char *user,

const char *pass, unsigned passlen,

const char *oldpass, unsigned oldpasslen,

unsigned flags)

so like, sasl_setpass will set passwords in the sasldb, and trigger the setpass callbacks for all available mechanisms. she's the main character of password-setting, no cap. 👑

🎀 Parameters 🎀

• conn – is the SASL connection context. your whole vibe container, basically.
• user – is the username to set the password for. who are we doing this for, bestie?
• pass – the password to set.
• passlen – length of the password to set (pass). yes, she needs the length too, she's thorough.
• oldpass – optional. The old password.
• oldpasslen – optional. The old password length.
• flags – are flags including SASL_SET_CREATE and SASL_SET_DISABLE (to cause the creating of nonexistent accounts and the disabling of an account, respectively). so like, SASL_SET_CREATE = "make her exist ✨" and SASL_SET_DISABLE = "actually nvm, shut her down 💀".

ngl this next bit matters: oldpass and oldpasslen are unused in the Cyrus SASL implementation, though are passed on to any mechanisms that may require them. so in Cyrus SASL they're just chilling, but they still get handed off to whoever needs them. iykyk. 🙈

---

⭐ RETURN VALUE ⭐

SASL callback functions should return SASL return codes. See sasl.h for a complete list. SASL_OK indicates success. 🎉

Other return codes indicate errors and should be handled. fr fr, don't ignore them, handle them.

---

🌈 SEE ALSO 🌈

• RFC 4422
• :saslman:sasl(3)
• sasl_errors(3)
• sasl_checkpass(3)

---

👑 AUTHOR 👑

The Cyrus Team. iconic. slay.

💜 COPYRIGHT 💜

1993-2016, The Cyrus Team

---

and that's the whole page, bestie!! this was Cyrus SASL 2.1.28, dated February 18, 2022 — mwah, love that for us. go set some passwords, you absolute legend 🎀✨