gsasl_server_callback_qop_set(3)

✨ gsasl_server_callback_qop_set — the gsasl manual, bestie edition ✨

okay so you're deep in the gsasl docs (that's GNU SASL, the SASL library, iykyk) and you landed on gsasl_server_callback_qop_set(3). it's an API function. it's also, lowkey, a relic from the old callback era. let's get into it 💅

---

🌸 NAME 🌸

gsasl_server_callback_qop_set — an API function, bestie. that's the whole name. short, iconic, does what it says (sort of, it sets a callback, we'll get there).

---

🦋 SYNOPSIS 🦋

#include <gsasl.h>

void gsasl_server_callback_qop_set(Gsasl * ctx,
Gsasl_server_callback_qop cb);

that's it. two args, no return value. void said "i owe you nothing" and meant it.

---

🎀 ARGUMENTS 🎀

• Gsasl * ctx — your libgsasl handle. the main character of every gsasl function honestly.
• Gsasl_server_callback_qop cb — the callback function. this is the one you're handing over.

---

💖 DESCRIPTION 💖

so here's the vibe: you call this to specify the callback function that the server should use to figure out which quality of protection it accepts. 🫶

but wait — plot twist — the quality of protection that actually ends up being used is selected by the client, not you. so you're giving your opinion, and the client is the one making the final call. not you being ignored, exactly, more like… you're the vibe consultant. 😭

it's currently used by the DIGEST-MD5 mechanism. that's the one. 🔥

and if you ever want it back, the function can be later retrieved using gsasl_server_callback_qop_get(). get and set, they're a matched set, they come as a pair, periodt.

---

💀 DEPRECATED 💀

bestie. this function is part of the old callback interface. it's giving legacy. it's giving "we don't do it like this anymore."

the new interface uses gsasl_callback_set() to set the application callback, and then uses gsasl_callback() or gsasl_property_get() to invoke the callback for certain properties.

so like… it still exists, it's not gone, but it's the old way. if you're writing fresh code, the new interface is right there. 💅

---

🐛 REPORTING BUGS 🐛

found a bug? first of all, relatable. second of all, report bugs to <bug-gsasl@gnu.org>. 📧

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

and the GNU SASL home page is at http://www.gnu.org/software/gsasl/ — go say hi 🌈

---

👑 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. slay, honestly — that's a very generous license and we respect it 🫶

---

🧚 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. go read it, it's right there, it's free ✨

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 version 1.10.0, and if you made it this far you are officially a certified gsasl girlie. go set that callback (or, like, don't, it's deprecated). mwah 🎀