gsasl_server_suggest_mechanism(3)

📦 version 1.10.0, in ubuntu jammy

💫 NAME 💫

gsasl_server_suggest_mechanism — an API function, bestie. that's literally the whole name section, no cap.

✨ SYNOPSIS ✨

okay so here's how you pull it in:

#include <gsasl.h>

const char * gsasl_server_suggest_mechanism(const char *mechlist
_GL_UNUSED, const char *mechlist _GL_UNUSED);

like. yes. the signature really does look like that. two params, same name, both marked _GL_UNUSED. we do not ask questions. we simply vibe. 💅

🎀 ARGUMENTS 🎀

  • const char *mechlist _GL_UNUSED — the docs say -- undescribed -- and honestly?? same. nobody described it. it's a mystery. a little enigma wrapped in a const char *. 🦋
  • const char *mechlist _GL_UNUSED — also -- undescribed --. yes, again. the same name. twice. the lore is that the manpage just gave up here. iconic behaviour tbh. 🙈

🌸 DESCRIPTION 🌸

So the whole entire point of this function is: you hand it an input string, and it gives you back the name of the "best" SASL mechanism that the libgsasl server supports and that is present in that input string. like a lil matching service for mechanism names. 🫶

Return value: it returns the name of the "best" SASL mechanism supported by the libgsasl server which is present in the input string. that's the return value. that's the whole thing. ✨

💀 DEPRECATED 💀

okay so listen. this one is deprecated and we need to talk about it. it was never useful, because it's the client that chooses which mechanism to use. the server doesn't get a say!! so this function was out here suggesting mechanisms like the group chat asked for an opinion that nobody requested. 😭

deprecated! not useful, never was, and the reason is that the client picks the mechanism. periodt. don't build your architecture around this one, bestie.

🐛 REPORTING BUGS 🐛

found a bug? (or like, a bug in this? it's deprecated so, choices.) anyway — send it to:

<bug-gsasl@gnu.org>

general guidelines for reporting bugs live here: http://www.gnu.org/gethelp/

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

we love a paper trail. ✨

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.

(translation: keep the receipt, share the file, no fee, no drama. 🫶)

🌈 SEE ALSO 🌈

the full documentation for gsasl is maintained as a Texinfo manual, and if the info and gsasl programs are properly installed at your site, then:

info gsasl

should give you access to the complete manual. the way that a single command can hand you the entire manual?? obsessed. 💖

as an alternative you may obtain the manual from:

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

and that's the whole page, bestie — brought to you by gsasl version 1.10.0, aka the gsasl_server_suggest_mechanism(3) era. deprecated queen, we still stan the documentation. 👑💅✨

📦 where this page comes from