gsasl_client_callback_realm_set(3)

📦 version 1.10.0, in ubuntu jammy

💖 gsasl_client_callback_realm_set(3) 💖

okay so bestie, this page lives in the gsasl manual (section 3, the library-functions girlies 🎀) and it's all about telling libgsasl which realm your client belongs to. yes it's a whole API function. no it's not scary. let's go ✨

🌸 NAME 🌸

gsasl_client_callback_realm_set — API function 💅

✨ SYNOPSIS ✨

#include <gsasl.h>

void gsasl_client_callback_realm_set(Gsasl * ctx,
Gsasl_client_callback_realm cb);

like. that's the whole vibe. two args, no return value, we move 💜

🫶 ARGUMENTS 🫶

  • Gsasl * ctx — the libgsasl handle. your main character context object, fr.
  • Gsasl_client_callback_realm cb — the callback function. the lil function that does the actual answering, iykyk.

🦋 DESCRIPTION 🦋

So what this does: you're specifying the callback function the client should use when it needs to know which realm it belongs to. 🎀

And why do we care about realms?? because the server uses the realm to figure out which username and password to use. it's giving "who even are you" energy but polite. 😭

Later on, if you wanna get that function back, you can grab it with gsasl_client_callback_realm_get(). retrieval slay. 🔥

💀 DEPRECATED 💀

bestie. listen. this function is part of the old callback interface. it's not the moment anymore. 😭

The new interface does it differently:

  • use gsasl_callback_set() to set the application callback, and
  • use gsasl_callback() or gsasl_property_get() to invoke the callback for certain properties.

so like, it still exists, but it's the vintage piece in your closet, not the fit you're wearing tonight. 💅

🐛 REPORTING BUGS 🐛

Found something broken? don't suffer in silence, spill:

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.

(translation: it's free, 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/

and that's the tea, bestie 🍓 this whole page came to you straight from gsasl version 1.10.0 — stan the manual, read the manual, the manual ate and left no crumbs. periodt 💅💖✨

📦 where this page comes from