gsasl_server_mechlist(3)

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

💖 gsasl_server_mechlist(3) — the gsasl bestie manual 💖

okay so bestie, welcome to the gsasl manual page for gsasl_server_mechlist, and honestly? it's a little icon. let's get into it 🫶

🌸 NAME 🌸

gsasl_server_mechlist — an API function. that's it, that's the whole name section. she's simple, she's iconic 💅

✨ SYNOPSIS ✨

#include <gsasl.h>

int gsasl_server_mechlist(Gsasl * ctx, char ** out);

like, that's the whole vibe. two args, one int coming back at you. slay.

🎀 ARGUMENTS 🎀

  • Gsasl * ctx — your libgsasl handle, aka the little bestie object that holds all the state. you bring her, she does the work 💖
  • char ** out — the newly allocated output character array. yes, newly allocated. meaning somebody (spoiler: you) is gonna have to free it. no cap.

🦋 DESCRIPTION 🦋

so here's the tea, fr fr: this function returns a newly allocated string packed with SASL names, each one separated by a space, and those are the mechanisms that the libgsasl server supports. like a little guest list for the party, but the party is SASL mechanism negotiation. the way that it just hands you a string and trusts you... main character energy honestly.

the out thing is allocated by this function, so it is the responsibility of the caller to deallocate it. not the function's problem, not the library's problem. yours. it's giving "here's a gift 🎁 now throw away the wrapping yourself". don't forget, bestie, or that's a memory leak and you'll be sad 😭

Return value: returns GSASL_OK if it all went well and everything ate, or an error code if it did not. vibe check accordingly ✨

😭 REPORTING BUGS 😭

found a bug? not the cute kind of bug? please tell the people:

they want to hear from you, genuinely. bugs don't fix themselves, periodt.

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, go off, redistribute responsibly, 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, then this command:

info gsasl

should give you access to the complete manual. iykyk — it's the good stuff 💜

and as an alternative, you may obtain the manual from:

https://www.gnu.org/software/libidn/gsasl/manual/
ok that's the whole page bestie!! go forth, call gsasl_server_mechlist, print those mechanism names, and FREE THE STRING afterwards. that's the whole assignment 🫡

and that's a wrap from gsasl version 2.2.4, bestie — this page was living its best life as gsasl_server_mechlist(3), mwah 💋🎀

📦 where this page comes from