gsasl_server_ca...ck_external_set(3)

📦 version 1.10.0, in ubuntu jammy

💖 gsasl_server_callback_external_set — the NAME section, bestie 💖

okay so this is a page from the gsasl manual (that's GNU SASL, the SASL library, iykyk), and it's all about one lil function: gsasl_server_callback_external_set — an API function. that's the whole name. short, sweet, slays.

✨ SYNOPSIS ✨

#include <gsasl.h>

void gsasl_server_callback_external_set(Gsasl * ctx,
       Gsasl_server_callback_external cb);

that's it. that's the whole vibe. 🫶

🎀 ARGUMENTS 🎀

  • Gsasl * ctx — your libgsasl handle. the little main-character object that holds all the state. 💅
  • Gsasl_server_callback_external cb — the callback function. the actual function you're handing over. that's your girl. ✨

🌸 DESCRIPTION 🌸

so bestie, what you're doing here is specifying the callback function that the server should use to decide whether a user is authenticated out of band. like, not through the normal flow — externally, off to the side, in its own little lane. 🦋

and the way that you can grab it back later? that's with gsasl_server_callback_external_get(). getter for the setter, iconic behavior honestly. 👑

💀 DEPRECATED 💀

ngl bestie, this one is DEPRECATED. like, it still exists, but it's giving "old interface". 😭

this function is part of the old callback interface. the new interface instead 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 that's the glow-up route. ✨

🐛 REPORTING BUGS 🐛

found a bug? don't be shy, report it, periodt:

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. (so yes, you can share it, 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, then this command:

info gsasl

should give you access to the complete manual. 🧚 and if that's not your vibe, as an alternative you may obtain the manual from:

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

and that's the whole page, bestie!! 💖 this one's from gsasl version 1.10.0 — go forth, set that external callback (or, like, use the new interface, lowkey), and slay. mwah. 💅✨🎀

📦 where this page comes from