gsasl_appinfo_get(3)

📦 version 1.10.0, in ubuntu jammy

💖 gsasl_appinfo_get — the manual page, bestie edition 💖

okay so this is a page from the gsasl manual — section 3, gsasl_appinfo_get(3) — and we're gonna get through it together, no stress. grab a boba. 🧋

✨ NAME ✨

gsasl_appinfo_get — literally just an API function. that's it. that's the whole name section. 💅

✨ SYNOPSIS ✨

okay so the way you summon this thing is:

#include <gsasl.h>

void * gsasl_appinfo_get(Gsasl_session * sctx);

not me showing up with a void * return type like it's no big deal. slay. 👑

✨ ARGUMENTS ✨

  • Gsasl_session * sctx — the libgsasl session handle. that's your little session bestie. everything happens through her. 🫶

✨ DESCRIPTION ✨

so what does it DO. okay. this function retrieves the application specific data from a libgsasl session handle. where did that data come from? you set it earlier with gsasl_appinfo_set(). iconic duo behaviour, fr fr.

what's it for? bestie, it's how an application maintains state between the main program and the callback. like, the callback needs to know stuff the main program knows, and this is the little handoff point. very "passing notes in class" of it. 💌

Return value: it returns the application specific data, or NULL. that's the whole deal — either you get your data back or you get NULL and you just have to cope. 😭

🚫 DEPRECATED 🚫

okay so this is the part where I have to be real with you: this function is DEPRECATED. do not use it for new stuff. use gsasl_callback_hook_get() instead. periodt. 💅

🐛 REPORTING BUGS 🐛

found a bug? first of all, relatable. second of all, report it to:

  • <bug-gsasl@gnu.org>

and there's general guidelines for reporting bugs over at:

also the GNU SASL home page lives at:

go forth and file, bestie. 🌸

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 like… copy it, remix it, put it on your blog, whatever — just keep the copyright notice and this notice intact. that's the vibe check and it passed. ✅

👀 SEE ALSO 👀

the full documentation for gsasl is maintained as a Texinfo manual. so if info and gsasl are properly installed on your system, this:

info gsasl

should give you access to the complete manual. chef's kiss. 😘

as an alternative, you can also obtain the manual from:

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

iykyk. 🦋

and that's the page, babe. this was gsasl 1.10.0, and the page is gsasl_appinfo_get(3). drink some water, go set your appinfo with the non-deprecated function, and text me later. mwah. 💖✨🎀

📦 where this page comes from