SASL_GETPROP(3)

💖 SASL_GETPROP(3) 💖

okay bestie, gather round, we're reading a Cyrus SASL manpage and honestly? it's giving informative. this one lives in the Cyrus SASL manual, section 3, and it's all about peeking at the little properties attached to your SASL connection. no cap. 🦋

---

✨ NAME ✨

sasl_getprop — Cyrus SASL documentation

like, that's literally it. the name is the name. periodt. 💅

---

🌸 SYNOPSIS 🌸

#include <sasl/sasl.h>

int sasl_getprop(sasl_conn_t *conn,
                int propnum,
                const void ** pvalue);

---

🎀 DESCRIPTION 🎀

so, the signature one more time, because we love a full look:

int sasl_getprop(sasl_conn_t *conn,

int propnum,

const void ** pvalue);

sasl_getprop gets the value of a SASL property. that's the whole vibe. 🫶

why would you even want that? okay so picture this: after a successful authentication, a server might lowkey wanna know the authorization name. or maybe a client app is curious about the strength of the negotiated security layer. both totally valid. both iconic. ✨

🌈 Parameters

• conn – is the SASL connection context
• propnum – is the identifier for the property requested
• pvalue – is filled on success. List of properties:

👑 The Property List (the main character moment)

• SASL_USERNAME – pointer to NUL terminated user name
• SASL_SSF – security layer security strength factor, if 0, call to sasl_encode(3), sasl_decode(3) unnecessary
• SASL_MAXOUTBUF – security layer max output buf unsigned
• SASL_DEFUSERREALM – server authentication realm used
• SASL_GETOPTCTX – context for getopt callback
• SASL_IPLOCALPORT – local address string
• SASL_IPREMOTEPORT – remote address string
• SASL_SERVICE – service passed to sasl_*_new
• SASL_SERVERFQDN – serverFQDN passed to sasl_*_new
• SASL_AUTHSOURCE – name of auth source last used, useful for failed authentication tracking
• SASL_MECHNAME – active mechanism name, if any
• SASL_PLUGERR – similar to sasl_errdetail

---

💜 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. don't just ignore them bestie, that's not the move. 😭

---

🧚 SEE ALSO 🧚

RFC 4422,:saslman:sasl(3), sasl_errors(3) sasl_server_new(3), sasl_client_new(3)

---

🍓 AUTHOR 🍓

The Cyrus Team 👑

---

💌 COPYRIGHT 💌

1993-2016, The Cyrus Team

---

and that's the whole page, bestie! no skips, no crumbs, every single property accounted for. ate and left no crumbs fr fr. 💅✨

version 2.1.28 🌈 dated February 18, 2022 🎀

mwah, love u, go read sasl.h if you want the full return code lore 🫶💖