gsasl_client_suggest_mechanism(3)

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

✨ gsasl_client_suggest_mechanism ✨

okay bestie, so this one lives in the gsasl manual, section 3 (the library-call girlies section 💅), and it's literally just the friend who looks at a whole group chat of SASL mechanisms and tells you which one to text back. no cap.

🌸 NAME 🌸

gsasl_client_suggest_mechanism — it's an API function, periodt.

🎀 SYNOPSIS 🎀

#include <gsasl.h>

const char * gsasl_client_suggest_mechanism(Gsasl * ctx, const char *
mechlist);

like. she takes two things and gives you back a string. so demure of her 🫶

🦋 ARGUMENTS 🦋

  • Gsasl * ctx — your libgsasl handle, aka her main character passport. she needs it to know who she's working with.
  • const char * mechlist — an input character array with SASL mechanism names in it, separated by invalid characters (e.g. SPC). so like, a list of names where the glue holding them together is nonsense — classic.

💖 DESCRIPTION 💖

Given a list of mechanisms, suggest which to use. that's it, that's the whole job. she reads the room and picks a winner ✨

Return value: she hands you back the name of the "best" SASL mechanism supported by the libgsasl client which is present in the input string — or NULL if no supported mechanism is found 😭 (empty-handed, no notes).

ngl, always check for NULL before you go dereferencing her answer. she is allowed to come back with nothing. yes she's iconic, no she doesn't owe you a mechanism.

🙈 REPORTING BUGS 🙈

found a bug? spill it to <bug-gsasl@gnu.org> 🐛

the general guidelines for reporting bugs live at: https://www.gnu.org/gethelp/

and the GNU SASL home page is right here: https://www.gnu.org/software/gsasl/

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 slay, basically — 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/

that's the whole page bestie, go forth and call her 💜

sign-off szn ⭐ this was gsasl version 2.2.4, section 3, and yeah — she's a libgsasl function through and through. mwah. 🎀
📦 where this page comes from