gsasl_server_ca...ck_retrieve_set(3)

💖 gsasl_server_ca...ck_retrieve_set — the manual page, bestie edition 💖

okay so you're in the gsasl manual (that's the GNU SASL one, section 3, library calls only, iykyk) and you landed on this page. don't worry, I got you. this is literally the glow-up guide for one very specific little function. let's go 🦋

---

✨ NAME ✨

gsasl_server_callback_retrieve_set — it's an API function, no more no less 💅

---

🌸 SYNOPSIS 🌸

#include <gsasl.h>

void gsasl_server_callback_retrieve_set(Gsasl * ctx,
Gsasl_server_callback_retrieve cb);

like yes it's a void function, it returns nothing, it just does the thing. main character behavior honestly ✨

---

🎀 ARGUMENTS 🎀

• Gsasl * ctx — the libgsasl handle, your little context baddie 🫶
• Gsasl_server_callback_retrieve cb — the callback function itself. this is the star of the show ⭐

---

💜 DESCRIPTION 💜

so what this does: you're specifying the callback function that the server should use to decide whether a user is authenticated. and it's making that call using three things — the authentication identity, the authorization identity, and the password. trio. iconique. 🔥

and the cute part? you can grab that function back later with gsasl_server_callback_retrieve_get(). it's giving "set it and forget it but actually don't forget it, you can retrieve it". 🧚

---

⚠️ DEPRECATED ⚠️

not me having to tell you this but babe, this function is part of the OLD callback interface. it's deprecated. it's vintage. it's not the moment anymore. 😭

the new interface uses gsasl_callback_set() to set the application callback, and uses gsasl_callback() or gsasl_property_get() to invoke that callback for certain properties. so if you're writing new code, that's where the party's at. periodt. 💅

---

🐛 REPORTING BUGS 🐛

found a bug? spill the tea to <bug-gsasl@gnu.org> 📧

general guidelines for reporting bugs live at: http://www.gnu.org/gethelp/

and the GNU SASL home page is right here: http://www.gnu.org/software/gsasl/

---

👑 COPYRIGHT 👑

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. (run it. it's literally right there. go 🏃‍♀️)

As an alternative you may obtain the manual from:

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

---

and that's the whole page, bestie!! this was gsasl 1.10.0, brought to you by the gsasl crew — stay deprecated-free out there, mwah 💋✨