gsasl_callback(3)

📦
version 2.2.4 · 6 versions
, in arch rolling, ubuntu stonking

✨ gsasl_callback(3) ✨ — the gsasl manual, bestie edition 🎀

okay so picture this: you're deep in the gsasl manual (that's GNU SASL, the auth library, hi 👋) and you land on gsasl_callback — a whole API function, no cap. She's giving "the library needs to ask your app a question and this is the phone she calls." Let's get into it 💅

🌸 SYNOPSIS 🌸

#include <gsasl.h>

int gsasl_callback(Gsasl * ctx, Gsasl_session * sctx, Gsasl_property prop);

🦋 ARGUMENTS 🦋

  • Gsasl * ctx — the handle you got from gsasl_init(). She's allowed to be NULL btw, and if she is, she just gets derived from sctx. flexible queen 💖
  • Gsasl_session * sctx — the session handle. your lil session bestie.
  • Gsasl_property prop — an enumerated value of the Gsasl_property type. it's literally telling everybody what the vibe is.

👑 DESCRIPTION 👑

So what this does is invoke the application callback — like, she calls up your app and goes "hey, your turn." 🫶

The prop value is the whole point: it indicates what the callback is expected to do. Different prop, different task, iykyk.

Example time, because examples ate and left no crumbs: for GSASL_ANONYMOUS_TOKEN, the function is expected to invoke

gsasl_property_set(SCTX, GSASL_ANONYMOUS_TOKEN, "token")

where "token" is the anonymous token that your application wants the SASL mechanism to use. periodt. ✨

and if you're like "okay but what do all the other parameters MEAN" — bestie, the manual has you. go read the manual for the meaning of all parameters. 📖

Return value: she returns whatever the application callback returns 😌, or GSASL_NO_CALLBACK if no application was known. so like, if nobody's home, you get GSASL_NO_CALLBACK, not silence.

⭐ SINCE ⭐

0.2.0 — she's been iconic since way back 💜

😭 REPORTING BUGS 😭

Found a bug? Tell the people! Report bugs to <bug-gsasl@gnu.org>.

General guidelines for reporting bugs live at: https://www.gnu.org/gethelp/

GNU SASL home page: https://www.gnu.org/software/gsasl/

Copyright © 2002-2026 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. (slay, very generous of them 🫶)

🌈 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, this command

info gsasl

should give you access to the complete manual. no cap, that's the whole trick 🧚

As an alternative you may obtain the manual from:

https://www.gnu.org/software/libidn/gsasl/manual/

that's the whole page bestie 💖 this was gsasl_callback(3) from the gsasl manual, version 2.2.4 — go forth and callback responsibly, mwah 🎀✨

📦 where this page comes from