SASL_AUXPROP_REQUEST(3)

💖 SASL_AUXPROP_REQUEST 💖

okay bestie, welcome to the Cyrus SASL corner of the manual, where we talk about asking the library nicely to go fetch you some properties. this is sasl_auxprop_request, and yes it's giving very "let me call in a favor" energy. 🫶

---

✨ SYNOPSIS ✨

#include <sasl/sasl.h>

int sasl_auxprop_request(sasl_conn_t *conn, const char ** propnames)

like, that's the whole vibe. two args. no cap. 🎀

---

🌸 DESCRIPTION 🌸

int sasl_auxprop_request(sasl_conn_t *conn, const char **propnames)

so here's the tea: sasl_auxprop_request is you literally requesting that the SASL library go obtain properties from any auxiliary property plugins that might be installed. and when we say "might be installed" we mean it — like, for example, the user's home directory from an LDAP server. yes bestie, that kind of property. 🌈

the way this works is so specific and you need to know it: that lookup happens just after username canonicalization is complete. so the timeline matters fr fr —

• make the request before the call to sasl_server_start(3)
• but after the call to sasl_server_new(3)

that's the window. don't miss it. ⏰

🦋 Parameters

• conn — the sasl_conn_t for which the request is being made. it's your connection, your main character. 👑
• propnames — a NULL-terminated array of property names to request. and listen, this part is important: this array must persist until a call to sasl_dispose(3) on the sasl_conn_t. like, do not let it wander off and get freed. it has to stay. 😭

💫 Returns

Returns SASL_OK on success. that's the slay. for the meanings of other return codes, go check sasl_errors(3) — she explains everything. 💅

---

🎀 CONFORMING TO 🎀

RFC 4422 — yes, we're standards-compliant AND cute. iconic behavior. ⭐

---

🔥 SEE ALSO 🔥

• sasl(3)
• sasl_errors(3)
• sasl_auxprop(3)
• sasl_auxprop_getctx(3)
• sasl_server_new(3)
• sasl_server_start(3)

go read them, bestie. they're all in the group chat. 🫶

---

👑 AUTHOR 👑

The Cyrus Team. absolute legends, no notes. 💜

---

🌸 COPYRIGHT 🌸

1993-2016, The Cyrus Team. 💖

---

lowkey reminder: propnames has to stick around until sasl_dispose(3). i'm not gonna say it again... okay i might say it again. it's important. 🙈

---

k bye ily, this has been page SASL_AUXPROP_REQUEST(3) from Cyrus SASL version 2.1.28, dated February 18, 2022 — mwah, slay, periodt. ✨🦋💅