SASL_SETPROP(3)

🦋 SASL_SETPROP(3) 🦋

okay so bestie, welcome to the Cyrus SASL manual pages, and this particular page? it's giving let me tell the library a secret energy 💅 sasl_setprop is how your app pipes extra info into the SASL library, and honestly it's lowkey essential. let's get into it 🫶

---

🌸 NAME 🌸

sasl_setprop — Cyrus SASL documentation

---

✨ SYNOPSIS ✨

#include <sasl/sasl.h>

int sasl_setprop(sasl_conn_t *conn,
                int propnum,
                const void * pvalue)

---

💜 DESCRIPTION 💜

int sasl_setprop(sasl_conn_t *conn,

int propnum,

const void * pvalue)

so like, sasl_setprop sets the value of a SASL property. real talk: your application should tell the SASL library about any external negotiated security layer (i.e. TLS). no gatekeeping, keep the library in the loop 🫶

🎀 Parameters 🎀

• conn – is the SASL connection context
• propnum – is the identifier for the property requested
• pvalue – contains a pointer to the data. It is the applications job to make sure this type is correct. This is an easy way to crash a program. 💀 not me handing over the wrong type and nuking the whole process
  • SASL_AUTH_EXTERNAL ‐ external authentication ID (const char *)
  • SASL_SSF_EXTERNAL ‐ external SSF active ‐‐ (sasl_ssf_t)
  • SASL_DEFUSERREALM ‐ user realm (const char *)
  • SASL_SEC_PROPS ‐ sasl_security_properties_t (may be freed after call)
  • SASL_IPLOCALPORT ‐ string describing the local ip and port in the form ”a.b.c.d;p”, or “e:f:g:h:i:j:k:l;port”
  • SASL_IPREMOTEPORT ‐ string describing the remote ip and port in the form ”a.b.c.d;p”, or “e:f:g:h:i:j:k:l;port”

---

🫶 RETURN VALUE 🫶

SASL callback functions should return SASL return codes. See sasl.h for a complete list. SASL_OK indicates success ✨ (that's the one you want, the main character ending).

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

---

👑 SEE ALSO 👑

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

---

💖 AUTHOR 💖

The Cyrus Team

---

🌈 COPYRIGHT 🌈

1993-2016, The Cyrus Team

---

and that's the whole page bestie 💅 that was version 2.1.28, dated February 18, 2022. periodt. go set some properties, you've got this 🦋✨