SASL_GETREALM_T(3)

💖 SASL_GETREALM_T(3) — Cyrus SASL 💖

okay bestie, sit down, hydrate, and let's talk about sasl_getrealm_t, a little callback from the Cyrus SASL manual, third section. this is genuinely one of the good ones. no cap. 🦋

---

✨ NAME ✨

sasl_getrealm_t — Cyrus SASL documentation. that's it, that's the name, she's simple and she knows it. 💅

---

🌸 SYNOPSIS 🌸

#include <sasl/sasl.h>

int sasl_getrealm_t(void *context,
    int id,
    const char **availrealms,
    const char **result)

like, look at her. four little params, zero drama. 🎀

---

💫 DESCRIPTION 💫

int sasl_getrealm_t(void *context,

int id,

const char **availrealms,

const char **result)

so, sasl_getrealm_t() is the function that gets called when there's an interaction with SASL_CB_GETREALM as the type. iykyk. 🔥

here's the tea, and this part is actually important so pay attention bestie: if a mechanism would use this callback but it's not present, then the first realm listed is automatically selected. yes, automatically. she picked for you. 💀

and lowkey a lil plot twist: a mechanism may still force the existence of a getrealm callback by adding SASL_CB_GETREALM to its required_prompts list. so like, you don't get to just skip it if the mechanism says no. main character energy on the mechanism's part honestly. 👑

🌈 Parameters

• context — context from the callback record. it's the vibe handoff. 🫶
• id — callback ID, and that's SASL_CB_GETREALM. 🏷️
• availrealms — a string list of the available realms. NULL terminated, and it may be empty. (empty is valid, don't panic 💖)
• result — the chosen realm. a NUL terminated string, periodt. ✨

---

⭐ RETURN VALUE ⭐

SASL callback functions should return SASL return codes. go peek at sasl.h for a complete list, she's got the receipts. 📜

SASL_OK indicates success. anything else is an error and, bestie, you should handle it. don't just let it sit there. 😭

---

🔮 SEE ALSO 🔮

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

go read those too, they're iconic. 🌟

---

👑 AUTHOR 👑

The Cyrus Team. legends only, fr fr. 💜

---

🎀 COPYRIGHT 🎀

1993-2016, The Cyrus Team.

---

ok that's the whole page, every single detail intact, nothing skipped, you're welcome 💅

this has been SASL_GETREALM_T(3) from Cyrus SASL, version 2.1.28, dated February 18, 2022. mwah, slay, go write some callbacks bestie 🦋✨💖