gsasl_property_fast(3)

✨ gsasl_property_fast πŸ’…

okay so bestie, listen β€” this is a page from the gsasl manual, and today's main character is gsasl_property_fast, an API function. yes it's giving very "small function, big feelings". let's go 🫢


🌸 NAME 🌸

gsasl_property_fast β€” an API function. that's it. that's the name. iconic of her honestly.


✨ SYNOPSIS ✨

#include <gsasl.h>

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

like, two args, one pointer, zero drama. we love a low-maintenance queen πŸ‘‘


πŸŽ€ ARGUMENTS πŸŽ€

  • Gsasl_session * sctx β€” the session handle. literally your backstage pass to the whole session, no big deal πŸ’–
  • Gsasl_property prop β€” an enumerated value of type Gsasl_property, and it's the one telling you what kind of data lives in data. yes it's a lil hint-dropper, we stan a communicative icon πŸ’…

πŸ¦‹ DESCRIPTION πŸ¦‹

so what she does: she retrieves the data that's stored in the session handle for the given prop. that's the whole gig. you ask for a property, she hands it over.

now here's the part where you gotta be careful, bestie 🚨 β€” the pointer she returns points at live data. do NOT deallocate it, and do NOT modify it in any way. it's not yours to touch, it's hers. look only, no hands πŸ™ˆ

also important, no cap: this function will not invoke the application callback. she's the fast lane, she's not gonna go ring up your callback for you. if you wanted that, wrong function, wrong vibe βœ‹

Return value: she returns the property value if it's known, or NULL if no value is known. mmm NULL, the classic "idk her" 😭

⭐ SINCE ⭐

0.2.0 β€” she's been around, she's a legacy icon, an OG. respect the elders πŸ‘‘


πŸ’€ REPORTING BUGS πŸ’€

found a bug? don't suffer in silence, spill it:


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. so like, copy it, remix it, put it on your blog, 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, this command:

info gsasl

should give you access to the complete manual. read it, bestie, she's got lore πŸ“š

as an alternative you may obtain the manual from:

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

and that's the page!! this one shipped with gsasl version 2.2.4, and it's the gsasl_property_fast(3) page β€” so if you ever forget what she does, just remember: fetch the property, don't free it, don't touch it, don't call the callback, periodt πŸ’…πŸ“πŸ’œ

πŸ“¦ where this page comes from