SASL_SERVER_USERDB_SETPASS_T(3)

💅 NAME 💅

sasl_server_userdb_setpass_t — Cyrus SASL documentation, bestie edition 🫶

okay so welcome to the Cyrus SASL cinematic universe, section 3 of the manual pages, and today's main character is sasl_server_userdb_setpass_t. yes she's a callback. yes she's iconic. let's get into it ✨

---

🌸 SYNOPSIS 🌸

#include <sasl/sasl.h>

int sasl_server_userdb_setpass_t(sasl_conn_t *conn,
                                 void *context,
                                 const char *user,
                                 const char *pass,
                                 unsigned passlen,
                                 struct propctx *propctx,
                                 unsigned flags)

---

🎀 DESCRIPTION 🎀

int sasl_server_userdb_setpass_t(sasl_conn_t *conn,

void *context,

const char *user,

const char *pass,

unsigned passlen,

struct propctx *propctx,

unsigned flags)

so basically? sasl_server_userdb_setpass_t is the callback that stores or changes a plaintext password in the user database of whoever supplied the callback. like she's the one actually writing the new password down. no cap 💖

the parameters (aka the squad) 🌈

• conn — the SASL connection, obviously. she's always there.
• context — the context that came from the callback record. it's giving "carried over from last time."
• user — NUL terminated user name, and it's in user@realm syntax. don't forget the realm bestie, the realm matters 🦋
• pass — the password to check, and lowkey important: it may not be NUL terminated. so like. do not assume. 🫠
• passlen — the length of the password. this is why pass doesn't need to be NUL terminated. they go together, periodt.
• propctx — Auxilliary Properties, and heads up: they are not stored. just passing through 💅
• flags — these are literally the same flags that get passed to sasl_setpass(3), and they're documented over on that man page. so if you're confused about flags, that's a you-and-sasl_setpass(3) conversation 💀

---

⭐ RETURN VALUE ⭐

SASL callback functions should return SASL return codes. the full list lives in sasl.h, go look, it's right there 🎀

SASL_OK means success. that's the slay. that's the win. 👑

any other return code means there's an error, and bestie, those should be handled. do not ignore them. that's not the vibe. 🙈

---

🔥 SEE ALSO 🔥

• RFC 4422
• :saslman:sasl(3)
• sasl_errors(3)
• sasl_callbacks(3)
• sasl_server_userdb_checkpass_t(3)
• sasl_setpass(3)

---

👑 AUTHOR 👑

The Cyrus Team. legends only, fr fr 💜

---

💖 COPYRIGHT 💖

1993-2016, The Cyrus Team

---

and that's the whole page!! thanks for coming to my TED talk, this was Cyrus SASL manual page 2.1.28, dated February 18, 2022 — mwah, go handle your return codes, ily, bye 🧚✨🍓