gsasl_client_callback_service_set(3)

📦 version 1.10.0, in ubuntu jammy

💖 NAME 💖

gsasl_client_callback_service_set — bestie, this is an API function, and it's here to set your client's service callback. periodt.

✨ SYNOPSIS ✨

#include <gsasl.h>

void gsasl_client_callback_service_set(Gsasl * ctx,
       Gsasl_client_callback_service cb);

🎀 ARGUMENTS 🎀

  • Gsasl * ctx — the libgsasl handle, aka your main character. 🫶
  • Gsasl_client_callback_service cb — the callback function. yes, the whole point. 👑

🌸 DESCRIPTION 🌸

okay so. this function tells your client which callback function to use when it needs to set the name of the service. like, it's the little handoff: "hey, here's the function that knows the service name, use it."

about that service buffer — it should be a registered GSSAPI host-based service name, and hostname is the name of the server. simple as that. 💅

and Servicename is used by DIGEST-MD5, and it should be the name of the generic server in case of a replicated service. (iykyk — replicated services are a whole vibe.)

you can grab this callback back later with gsasl_client_callback_service_get(). so it's not lost to the void, don't worry. 💜

💀 DEPRECATED 💀

not me being the bearer of bad news but… this function is part of the old callback interface. it's giving legacy. 😭

the new interface uses gsasl_callback_set() to set the application callback, and then uses gsasl_callback() or gsasl_property_get() to invoke the callback for certain properties. so if you're starting fresh, go that way, bestie. 🌈

🐛 REPORTING BUGS 🐛

found a bug? tell the devs, they wanna know, fr fr:

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.

🦋 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. and if that's not hitting, you can also grab the manual from:

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

and that's the whole page, bestie!! this little slice of gsasl lore is from gsasl 1.10.0 — go forth and set those service callbacks, you absolute icon 💅✨🎀🫶

📦 where this page comes from