gsasl_server_callback_realm_set(3)

📦 version 1.10.0, in ubuntu jammy

✨ gsasl_server_callback_realm_set(3) — the gsasl girlies' guide ✨

okay so bestie, welcome to the gsasl manual 💖 this one lives in section 3 of the gsasl manual, and it's about telling your server which realm it's repping. let's get into it 🫶

🌸 NAME 🌸

gsasl_server_callback_realm_set — literally just an API function, no cap 💅

🎀 SYNOPSIS 🎀

#include <gsasl.h>

void gsasl_server_callback_realm_set(Gsasl * ctx,
       Gsasl_server_callback_realm cb);

look at her. iconic. two args, zero drama ✨

🦋 ARGUMENTS 🦋

  • Gsasl * ctx — your libgsasl handle, aka the main character of this whole operation 👑
  • Gsasl_server_callback_realm cb — the callback function itself. yes, the vibe. the whole point. 🌈

💜 DESCRIPTION 💜

so what this does: you're specifying the callback function that the server uses to know which realm it serves 🎀 and like, why do we care? because the realm is what the user uses to figure out which username and password to send. it's giving "which account am I even logging into" energy, and honestly? valid 💀

and if you ever need it back later, no worries, you can retrieve that function with gsasl_server_callback_realm_get() 🫶

💀 DEPRECATED 💀

okay bestie, sit down, we need to talk 🙈

this function is part of the old callback interface. like, vintage. the new interface uses gsasl_callback_set() to set the application callback, and then uses gsasl_callback() or gsasl_property_get() to invoke that callback for certain properties ✨

so yeah — deprecated. it still works, but it's giving legacy. if you're writing new code, go hang out with the new interface instead 💅

🍓 REPORTING BUGS 🍓

found a bug? don't gatekeep, report it 🐛

Copyright © 2002-2021 Simon Josefsson. 💖

Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. (tl;dr: free to share, just keep the receipts 🧾✨)

🌟 SEE ALSO 🌟

the full documentation for gsasl is maintained as a Texinfo manual 📚 if the info and gsasl programs are properly installed at your site, the command

info gsasl

should give you access to the complete manual 💅 as an alternative you may obtain the manual from:

http://www.gnu.org/software/gsasl/manual/

mwah 💋 that's the whole page. this was gsasl version 1.10.0, and honestly? she ate. go forth and set your realm callbacks, bestie — but maybe use the new interface, iykyk 🎀🦋💖

📦 where this page comes from