gsasl_application_data_get(3)

📦 version 1.10.0, in ubuntu jammy

💖 gsasl_application_data_get(3) 💖

okay bestie, so this is a page from the gsasl manual — yes, that gsasl, the GNU SASL library — and it's all about one little function that pulls your own data back out of a libgsasl handle. short page, cute energy, let's go 🦋

✨ NAME ✨

gsasl_application_data_get — API function

🌸 SYNOPSIS 🌸

#include <gsasl.h>

void * gsasl_application_data_get(Gsasl * ctx);

🎀 ARGUMENTS 🎀

  • Gsasl * ctx — your libgsasl handle. that's it. that's the whole argument list. iconic minimalism 💅

👑 DESCRIPTION 👑

so basically: this function retrieves the application specific data from a libgsasl handle. like, your data, the stuff you stashed in there earlier — the vibe is very "hey, remember me?"

that data gets set with gsasl_application_data_set(). and what's it for? it's normally used by the application to maintain state between the main program and the callback. so when your callback fires off and needs to remember what the main program was doing, this is the lil thread that ties them together 🧵✨

Return value: Returns the application specific data, or NULL. (so like, if there's nothing in there, you get NULL. don't be surprised, bestie.)

😭 DEPRECATED 😭

girl. Use gsasl_callback_hook_get() instead. this one's deprecated, no cap. it still exists, but it's giving "old phone in a drawer" energy. use the new one 🙈

🐛 REPORTING BUGS 🐛

found a bug? don't suffer in silence, report it to <bug-gsasl@gnu.org>.

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.

🌈 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 whole page, bestie! 💜 this was gsasl 1.10.0, and the page is literally just gsasl_application_data_get(3) — go forth and get that data, you main character 🫶✨

📦 where this page comes from