gsasl_property_get(3)

📦
version 2.2.4 · 6 versions
, in arch rolling, ubuntu stonking

💅 gsasl_property_get — the gsasl manual, bestie edition ✨

okay so this page lives in the gsasl manual, and it's all about one little function that goes ✨fetch✨ for you. sit down, hydrate, let's get into it 🫶

🌸 NAME 🌸

gsasl_property_get — it's an API function, bestie. that's the whole name. periodt.

🎀 SYNOPSIS 🎀

#include <gsasl.h>

const char * gsasl_property_get(Gsasl_session * sctx, Gsasl_property
prop);

like, that's the shape of it. two args in, a const char * out. iconic 💖

🦋 ARGUMENTS 🦋

  • Gsasl_session * sctx — the session handle. it's giving "your lil connection passport", the thing that holds all your session state 🌈
  • Gsasl_property prop — an enumerated value of the Gsasl_property type, and it tells the function what kind of data you want out of data. iykyk 💅

✨ DESCRIPTION ✨

so basically: this function retrieves the data stored in the session handle for a given property prop. and if it doesn't already know the answer, it might go invoke the application callback to get the value. no cap, it'll go ask your app 🙈

⚠️ big one, don't skip this: the pointer you get back points to live data, and it must not be deallocated or modified in any way. like, hands off, it's not yours, do not touch 💀

also, when a property value isn't known yet, this function will invoke the application callback using gsasl_callback(). so the callback does the actual fetching when needed, and this function is the one knocking on its door 🚪✨

Return value: it returns the data for the property, or NULL if no value is known. simple as that, bestie.

⭐ SINCE ⭐

0.2.0 — been here since forever, a true veteran, main character energy from day one 👑

🐛 REPORTING BUGS 🐛

found a bug? don't gatekeep it, tell the devs:

Copyright © 2002-2026 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.

(yes bestie, that means 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, the command

info gsasl

should give you access to the complete manual. As an alternative you may obtain the manual from:

https://www.gnu.org/software/libidn/gsasl/manual/

and that's the whole page, bestie 🥹 this lil writeup came from gsasl version 2.2.4, and it's the gsasl_property_get(3) page specifically — go forth, fetch your properties, and remember: don't free the pointer, no matter how tempting 💅✨🦋

📦 where this page comes from